update_notification

Функция update_notification используется для создания, редактирования или удаления уведомлений.

Copied!
svc=resource/update_notification&params={"itemId":<long>,
					 					 "id":<long>,   /* ID уведомления */
					 					 "callMode":"<text>",
					 					 "e":<uint>,
					 					 "n":"<text>",   /* имя */
					 					 "txt":"<text>",      /* текст уведомления */
					 					 "ta":<uint>,     /* время активации (формат Unix) */
					 					 "td":<uint>,     /* время деактивации (формат Unix) */
					 					 "ma":<uint>,     /* максимальное количество срабатываний (0 — не ограничено) */
					 					 "mmtd":<uint>,   /* максимальный временнóй интервал между сообщениями, сек. */
					 					 "cdt":<uint>,   /* таймаут срабатывания, сек. */
					 					 "mast":<uint>,       /* минимальная продолжительность тревожного состояния, сек. */
					 					 "mpst":<uint>,   /* минимальная продолжительность предыдущего состояния, сек. */
					 					 "cp":<uint>,   /* период контроля относительно текущего времени, сек. */
					 					 "fl":<uint>,   /* флаги уведомления (см. ниже) */
					 					 "tz":<int>,     /* временнáя зона */
					 					 "la":"<text>",       /* язык пользователя (двухбуквенный код) */
					 					 "un":[<long>],   /* массив ID объектов/групп объектов */
					 					 "sch":{   /* массив ID объектов/групп объектов */	
												"f1":<uint>,   /* начало интервала 1 (количество минут от полуночи) */
												"f2":<uint>,   /* начало интервала 2 (количество минут от полуночи) */
												"t1":<uint>,   /* конец интервала 1 (количество минут от полуночи) */
												"t2":<uint>,   /* конец интервала 2 (количество минут от полуночи) */
												"m":<uint>,   /* маска дней месяца [1: 2||0, 31: 2||30] */
												"y":<uint>,   /* маска месяцев [Jan: 2||0, Dec: 2||11] */
												"w":<uint>   /* маска дней недели [Mon: 2||0, Sun: 2||6] */
					 					 },
					 					 "ctrl_sch":{   /* расписание максимального количества интервалов срабатывания */
												"f1":<uint>,   /* начало интервала 1 (количество минут от полуночи) */
												"f2":<uint>,   /* начало интервала 2 (количество минут от полуночи) */
												"t1":<uint>,   /* конец интервала 1 (количество минут от полуночи) */
												"t2":<uint>,   /* конец интервала 2 (количество минут от полуночи) */
					 							"m":<uint>,   /* конец интервала 2 (количество минут от полуночи) */
					 							"y":<uint>,   /* маска месяцев [Jan: 2||0, Dec: 2||11] */
					 							"w":<uint>   /* маска дней недели [Mon: 2||0, Sun: 2||6] */
					 					 },
					 					 "trg":{	/* контроль */
												"t":"<text>",   /* тип контроля (см. ниже) */
												"p":{	/* параметры */
													"<text>":"<text>",     /* название параметра: значение */
													...
												}
					 					 },
					 					 "act":[   /* действия */	
												{
													"t":"<text>",   /* тип действия (см. ниже) */
													"p":{	/* параметры */
														"<text>":"<text>",    /* название параметра: значение */
														...
													}
												}
					 					 ]}

Смотрите описание флагов уведомлений, типов действий и типов контроля на странице get_notification_data.

Для уведомления с типом контроля Простой значение параметра mast в секундах должно соответствовать параметру min_idle_time в минутах. Например, чтобы уведомление срабатывало после 10 минут простоя, укажите 10 в параметре min_idle_time и 600 в mast.

Параметры

НазваниеОписание
itemIdID ресурса.
idID уведомления (0 — создать).
callModeДействие: создание, редактирование, удаление, включение/отключение (create, edit, delete, enable).
e

Используется только для действия включения/отключения (enable):

  • 0 — отключить;
  • 1 — включить.

Другие параметры необходимы только для создания и редактирования. См. страницу get_notification_data.

Возвращаемый результат

Для запросов, связанных с созданием и редактированием:

Copied!
[
	<long>,				/* ID уведомления */
	{
		"id":<long>,	/* ID уведомления */
		"n":"<text>",		/* имя */
		"txt":"<text>",	/* текст уведомления */
		"ta":<uint>,	/* время активации (формат Unix) */
		"td":<uint>,	/* время деактивации (формат Unix) */
		"ma":<uint>,	/* максимальное количество срабатываний (0 — не ограничено) */
		"fl":<uint>,	/* флаги уведомлений */
		"ac":<uint>,	/* количество срабатываний */
		"un":[<long>],	/* массив ID объектов/групп объектов */
		"act":["<text>"],	/* действия */
		"trg":"<text>",	/* тип контроля */
		"trg_p":{},		/* настройки контроля */
		"crc":<long>,	/* контрольная сумма бинарного представления уведомления */ 
		"ct":<uint>,    /* время создания */  
		"mt":<uint>     /* время последнего изменения */
	}
]

Флаги уведомлений, типы действий и контроля описаны здесь.

Для запросов, связанных с удалением:

Copied!
[
	<long>,		/* ID уведомления */
	null
]

Возможные коды ошибок:

КодОписание
7Не удалось извлечь ресурс с требуемым ACL (ADF_ACL_AVL_RES_EDIT_NF).
6Неопределенная ошибка.
4Неверные входные параметры.
Скачать файл PDF
Скачать документ Word

Смотрите также