update_notification
La función update_notification se usa para crear, modificar o eliminar notificaciones.
svc=resource/update_notification¶ms={"itemId":<long>,
"id":<long>, /* ID de notificación */
"callMode":"<text>",
"e":<uint>,
"n":"<text>", /* nombre */
"txt":"<text>", /* texto de notificación */
"ta":<uint>, /* hora de activación (formato Unix) */
"td":<uint>, /* hora de desactivación (formato Unix) */
"ma":<uint>, /* cantidad máxima de ejecuciones (0: no limitada) */
"mmtd":<uint>, /* intervalo de tiempo máximo entre mensajes, s *
"cdt":<uint>, /* tiempo de espera de ejecución, s */
"mast":<uint>, /* duración mínima del estado de alarma, s */
"mpst":<uint>, /* duración mínima del estado anterior, s */
"cp":<uint>, /* período de control en relación con la hora actual, s */
"fl":<uint>, /* marcas de notificación (vea más abajo) */
"tz":<int>, /* zona horaria */
"la":"<text>", /* idioma del usuario (código de dos letras) */
"un":[<long>],
"sch":{ /* limitación de tiempo */
"f1":<uint>, /* inicio del intervalo 1 (minutos desde medianoche) */
"f2":<uint>, /* inicio del intervalo 2 (minutos desde medianoche) */
"t1":<uint>, /* fin del intervalo 1 (minutos desde medianoche) */
"t2":<uint>, /* fin del intervalo 2 (minutos desde medianoche) */
"m":<uint>, /* máscara de los días del mes [1: 2||0, 31: 2||30] */
"y":<uint>, /* máscara de meses [Jan: 2||0, Dec: 2||11] */
"w":<uint> /* máscara de los días de la semana [Mon: 2||0, Sun: 2||6] */
},
"ctrl_sch":{ /* horario de la cantidad máxima de intervalos de ejecución */
"f1":<uint>, /* inicio del intervalo 1 (minutos desde medianoche) */
"f2":<uint>, /* inicio del intervalo 2 (minutos desde medianoche) */
"t1":<uint>, /* fin del intervalo 1 (minutos desde medianoche) */
"t2":<uint>, /* fin del intervalo 2 (minutos desde medianoche) */
"m":<uint>, /* máscara de los días del mes [1: 2||0, 31: 2||30] */
"y":<uint>, /* máscara de meses [Jan: 2||0, Dec: 2||11] */
"w":<uint> /* máscara de los días de la semana [Mon: 2||0, Sun: 2||6] */
},
"trg":{ /* control */
"t":"<text>", /* tipo de control (vea más abajo) */
"p":{ /* parámetros */
"<text>":"<text>", /* nombre de parámetro: valor */
...
}
},
"act":[ /* acciones */
{
"t":"<text>", /* tipo de acción (vea más abajo) */
"p":{ /* parámetros */
"<text>":"<text>", /* nombre de parámetro: valor */
...
}
}
]}
Consulte las descripciones de marcas de notificaciones, tipos de acciones y tipos de control en la página get_notification_data.
Para las notificaciones con el tipo de control Inactividad, el valor del parámetro mast especificado en segundos debe corresponder al valor del parámetro min_idle_time especificado en minutos. Así, si desea que la notificación se ejecute tras 10 minutos de inactividad, especifique 10 para min_idle_time y 600 para mast.
Parámetros
| Nombre | Descripción |
|---|---|
| itemId | ID del recurso. |
| id | ID de la notificación (0: crear). |
| callMode | Acción: crear, modificar, eliminar. |
| e | Solo se usa para el callMode "enable":
|
Otros parámetros solo se requieren para creación o eliminación. Vea la página get_notification_data.
Resultado devuelto
Para las solicitudes de creación o modificación:
[
<long>, /* ID de notificación */
{
"id":<long>, /* ID de notificación */
"n":"<text>", /* nombre */
"txt":"<text>", /* texto de notificación */
"ta":<uint>, /* hora de activación (formato Unix) */
"td":<uint>, /* hora de desactivación (formato Unix) */
"ma":<uint>, /* cantidad máxima de ejecuciones, 0: ilimitada */
"fl":<uint>, /* marcas de notificaciones */
"ac":<uint>, /* cantidad de ejecuciones */
"un":[<long>], /* matriz de ID de unidades/grupos de unidades */
"act":["<text>"], /* acciones*/
"trg":"<text>", /* tipo de control */
"trg_p":{}, /* ajustes de control */
"crc":<long>, /* suma de comprobación de representación binaria de una notificación */
"ct":<uint>, /* hora de creación */
"mt":<uint> /* hora de la última modificación */
}
]
Las marcas de notificaciones y los tipos de acción y control se describen aquí.
Para las solicitudes de eliminación:
[
<long>, /* ID de notificación */
null
]
Los códigos de errores posibles son:
| Código | Descripción |
|---|---|
| 7 | Error al obtener el recurso con la ACL deseada (ADF_ACL_AVL_RES_EDIT_NF). |
| 6 | Error no definido. |
| 4 | Parámetros de entrada incorrectos. |