update_schedule

Para crear, editar o eliminar horarios, utilice el método route/update_schedule:

Copied!

svc=route/update_schedule
params={
  "itemId": <long>,
  "id": <long>,
  "callMode": <text>,
  "n": <text>,
  "f": <uint>,
  "tz": <uint>,
  "u": <long>,
  "tm": [
    {
      "at": <uint>,
      "ad": <uint>,
      "dt": <uint>,
      "dd": <uint>
    }
  ],
  "sch": {
    "f1": <uint>,
    "f2": <uint>,
    "t1": <uint>,
    "t2": <uint>,
    "m": <uint>,
    "y": <uint>,
    "w": <uint>
  },
  "cfg": {
    "name": <text>,
    "units": [<long>],
    "enabled": <byte>,
    "roundFlags": <uint>,
    "autoName": <byte>,
    "validityPeriod": <uint>
  }
}

Parámetros

La solicitud debe contener los siguientes parámetros:

Parámetro	Descripción
itemId	ID de la ruta.
id	ID del horario.
callMode	Acción: `create`, `update`, `delete`.

Los demás parámetros solo son obligatorios para la creación y la edición. Para su descripción, consulte get_round_data.

Los valores de los parámetros f1, t1, f2, t2 deben ser menores o iguales a 0xFFFF.

Respuesta

Si la solicitud se completa con éxito, el formato de la respuesta depende de la acción especificada en el parámetro callMode.

La respuesta a la solicitud de creación o actualización de un horario se devuelve en el siguiente formato:

Copied!

[
  <long>,  // ID del horario
  {
    "id": <long>,         // ID del horario.
    "n": <text>,          // Nombre.
    "f": <uint>,          // Tipo de horario (ver a continuación).
    "tz": <uint>,         // Zona horaria.
    "cfg": {              // Configuración personalizada (ejemplo).
      "autoName": <byte>,     // Usar un nombre generado automáticamente: 1 = sí, 0 = no.
      "enabled": <byte>,      // Crear rutinas automáticamente: 1 = sí, 0 = no.
      "name": <text>,         // Nombre de la rutina.
      "description":<text>,   // Descripción.
      "roundFlags": <uint>,   // Flags de la rutina.
      "units": [<long>],      // Array de ID de unidades.
      "validityPeriod": <uint> // Periodo de validez.
    },
    "tm": [               // Tiempo de paso por los puntos de control.
      {
        "at": <uint>,     // Hora de llegada.
        "ad": <uint>,     // Desviación respecto a la hora de llegada.
        "dt": <uint>,     // Hora de salida
        "dd": <uint>      // Desviación respecto a la hora de salida.
      }
    ],
    "sch": {             // Restricciones de tiempo.
      "f1": <uint>,      // Inicio del intervalo 1.
      "f2": <uint>,      // Inicio del intervalo 2.
      "t1": <uint>,      // Fin del intervalo 1.
      "t2": <uint>,      // Fin del intervalo 2.
      "m": <uint>,       // Máscara de días del mes.
      "y": <uint>,       // Máscara de meses.
      "w": <uint>        // Máscara de días de la semana.
    }
  }
]

Tipos de horario

Flag	Descripción
0x1	Relativo a la activación.
0x2	Relativo al día.
0x4	Absoluto.

La respuesta a la solicitud de eliminación de un horario se devuelve en el siguiente formato:

Copied!

[
  <long>,  // ID del horario.
  null
]

Si la solicitud falla, se devuelve un código de error.

Códigos de error

Código de error	Descripción
4	Parámetros de entrada no válidos (incluyendo `callMode` no válido, parámetros obligatorios faltantes o tiempos de horario no válidos).
6	Error al encontrar el horario creado, o error al actualizar o eliminar el horario.
7	Error interno o falta el derecho de acceso Modificar propiedades de la ruta a la ruta.