Уведомления: создание, редактирование и удаление

Для создания, редактирования и удаления уведомлений используется команда resource/update_notification:

svc=resource/update_notification&params={"itemId":<long>,
					 "id":<long>,
					 "callMode":<text>,
					 "n":<text>,
					 "txt":<text>,
					 "ta":<uint>,
					 "td":<uint>,
					 "ma":<uint>,
					 "mmtd":<uint>,
					 "cdt":<uint>,
					 "mast":<uint>,
					 "mpst":<uint>,
					 "cp":<uint>,
					 "fl":<uint>,
					 "tz":<int>,
					 "la":<text>,
					 "un":[<long>],
					 "sch":{	
						"f1":<uint>,
						"f2":<uint>,
						"t1":<uint>,
						"t2":<uint>,
						"m":<uint>,
						"y":<uint>,
						"w":<uint>
					 },
					 "trg":{	
						"t":<text>,
						"p":{	
							<text>:<text>,
							...
						}
					 },
					 "act":[	
						{
							"t":<text>,
							"p":{	
								<text>:<text>,
								...
							}
						}
					 ]}

Флаги уведомлений:

При создании и редактировании:

[
	<long>,		/* ID уведомления */
	{
		"id":<long>,	/* ID уведомления */
		"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>,	/* двухбуквенный код языка */
		"ac":<uint>,	/* количество срабатываний */
		"sch":{
			"f1":<uint>,	/* время начала интервала 1 (количество минут от полуночи) */
			"f2":<uint>,	/* время начала интервала 2(количество минут от полуночи) */
			"t1":<uint>,	/* время окончания интервала 1 (количество минут от полуночи) */
			"t2":<uint>,	/* время окончания интервала 2 (количество минут от полуночи) */
			"mdm":<uint>,	/* маска дней месяца [1: 2^0, 31: 2^30] */
			"ymm":<uint>,	/* маска месяцев [янв: 2^0, дек: 2^11] */
			"wdm":<uint>	/* маска дней недели [пн: 2^0, вс: 2^6] */
		},
		"un":[<long>],	/* массив GUIDов объектов */
		"act":[{	/* действия */
			"t":<text>,	/* тип действия */
			"p":{		/* параметры вида - название параметра: значение */
				<text>:<text>,
				...
			}
		}],
		"trg":{		/* контроль */
			"t":<text>,	/* тип контроля */
			"p":{		/* параметры вида - название параметра: значение */
				<text>:<text>,
				...
			}
		}
	}
]

При удалении:

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

• Уведомить по e-mail,
• Уведомить при помощи SMS,
• Отобразить онлайн уведомление во всплывающем окне,
• Зарегистрировать событие в истории объекта,
• Выполнить команду,
• Изменить права пользователей,
• Установить значение счетчика,
• Сохранить значение счетчика как параметр,
• Зарегистрировать статус объекта,
• Изменить вхождение в группы,
• Отправить отчет по e-mail,
• Назначить на маршрут,
• Снятие водителя.

{
	"t":"email",		/* тип действия */
	"p":{
		"email_to":<text>,	/* e-mail адрес */
		"html":<text>,		/* использовать html-теги: 0 - нет, 1 - да  */
		"img_attach":<text>,	/* прикрепить изображение из сработавшего уведомления (1 - да, 0 - нет) */
		"subj":<text>		/* текст сообщения */
	}
}

{
	"t":"sms",		/* тип действия */
	"p":{
		"phones":<text>		/* список телефонных номеров (через точку с запятой) */
	}
}

{
	"t":"message",		/* тип действия */
	"p":{
		"name":<text>		/* название уведомления */
	}
}

{
	"t":"event",		/* тип действия */
	"p":{
		"flags":<text>		/* зарегистрировать как: 0 - событие, 1 - нарушение */
	}
}

{
	"t":"exec_cmd",		/* тип действия */
	"p":{
		"link":<text>,		/* тип связи */
		"name":<text>,		/* название команды */
		"param":<text>		/* параметры */
	}
}

{
	"t":"user_access",	/* тип действия */
	"p":{
		"acc_level":<text>,	/* права доступа */		
		"users":<text>		/* список GUIDов пользователей (через запятую) */
	}
}

Права доступа рассмотрены в разделе Получение прав доступа.

{
	"t":"counter",		/* тип действия */
	"p":{
		"engine_hours":<text>,	/* значение счетчика моточасов */
		"flags":<text>,		/* флаги (см. ниже) */
		"mileage":<text>,	/* значение счетчика пробега */
		"traffic":<text>	/* значение счетчика GPRS-трафика */
	}
}

Возможные флаги счетчиков:

• 1 - установить значение счетчика пробега
• 2 - установить значение счетчика моточасов
• 4 - установить значение счетчика GPRS-трафика

{
	"t":"store_counter",		/* тип действия */
	"p":{
		"engine_hours":<text>,	/* название параметра для счетчика моточасов */
		"flags":<text>,			/* флаги (см. ниже) */
		"mileage":<text>		/* название параметра для счетчика пробега */
	}
}

Флаги:

• 1 - cохранить значение счетчика пробега как параметр
• 2 - cохранить значение счетчика моточасов как параметр

{
	"t":"status",		/* тип действия */
	"p":{
		"ui_text":<text>	/* статус */
	}
}

{
	"t":"group_manipulation",	/* тип действия */
	"p":{
		"add_to":<text>,		/* добавить в указанные группы (список GUIDов групп через запятую) */
		"remove_from":<text>		/* исключить из указанных групп */
	}
}

{
	"t":"email_report",	/* тип действия */
	"p":{
		"user":<text>,			/* GUID пользователя */
		"report_object_guid":<text>,	/* GUID элемента для отчета */
		"report_object_id":<text>,	/* ID подэлемента (0 - если отчет строится для элемента) */
		"report_guid":<text>,		/* GUID ресурса */
		"report_id":<text>,		/* ID шаблона */
		"time_from":<text>,		/* начало временного интервала */
		"time_to":<text>,		/* конец временного интервала */
		"flags":<text>,			/* флаги интервала */
		"file_type":<text>,		/* формат файла: html, pdf, xls, xlsx, xml, csv */
		"email_to":<text>,		/* e-mail адрес */
		"pack":<text>,			/* сжать файлы отчета (1 - да, 0 - нет) */
		"params":<text>,		/* конфигурация отчета (xml) */
        	"lang":<text>,			/* двухбуквенный код языка */
        	"subj":<text>			/* тема письма */
	}
}

Флаги интервала рассмотрены в разделе Отчеты: Выполнение отчета.

{
	"t":"route_control",	/* тип действия */
	"p":{
		"name":<text>,		/* название маршрута */
		"descr":<text>,		/* описание */
		"flags":<text>,		/* флаги маршрута */
		"act_time":<text>,	/* время активации */
		"zone_id":<text>	/* ID геозоны */
	}
}

Флаги маршрута рассмотрены в разделе Маршруты: создание, редактирование и удаление.

{
	"t":"drivers_reset",	/* тип действия */
	"p":{}
}

• Контроль геозоны,
• Контроль скорости,
• Нажатие тревожной кнопки,
• Активация/дезактивация цифрового входа,
• Контроль параметра в сообщении,
• Контроль значения датчика,
• Потеря связи или координат,
• Простой Т/С,
• Контроль SMS,
• Взаиморасположение объектов,
• Контроль маршрута,
• Контроль водителя,
• Техобслуживание.

"trg":{
	"t":"geozone",		/* тип контроля */
	"p":{
		"geozone_ids":<text>,	/* список идентификаторов геозон (через запятую) */
		"lower_bound":<text>,	/* значение датчика от */
		"max_speed":<text>,	/* максимальная скорость, км/ч */
		"merge":<text>,		/* одинаковые датчики: 0 - считать отдельно, 1 - суммировать значения */
		"min_speed":<text>,	/* минимальная скорость, км/ч */
		"reversed":<text>,	/* срабатывать: 0 - в рамках установленных значений, 1 - за пределами установленных значений */
		"sensor_name_mask":<text>,	/* маска названия датчика */
		"sensor_type":<text>,	/* тип датчика */
		"type":<text>,		/* тип проверки: 0 - контролировать вход в геозону, 1 - контролировать выход из геозоны */
		"upper_bound":<text>	/* значение датчика до */
	}
}

"trg":{
	"t":"speed",		/* тип контроля */
	"p":{
		"lower_bound":<text>,	/* значение датчика от */
		"max_speed":<text>,	/* максимальная скорость, км/ч */
		"merge":<text>,		/* одинаковые датчики: 0 - считать отдельно, 1 - суммировать значения */
		"min_speed":<text>,	/* минимальная скорость, км/ч */
		"reversed":<text>,	/* срабатывать: 0 - в рамках установленных значений, 1 - за пределами установленных значений */
		"sensor_name_mask":<text>,	/* маска названия датчика */
		"sensor_type":<text>,	/* тип датчика */
		"upper_bound":<text>	/* значение датчика до */
	}
}

"trg":{
	"t":"alarm",		/* тип контроля */
	"p":{}
}

"trg":{
	"t":"digital_input",	/* тип контроля */
	"p":{
		"input_index":<text>,	/* цифровой вход (1-32) */
		"type":<text>  		/* тип проверки: 0 - на активацию, 1 - на дезактивацию */
	}
}

"trg":{
	"t":"msg_param",	/* тип контроля */
	"p":{
		"kind":<text>,		/* тип контроля параметра */
		"lower_bound":<text>,	/* значение параметра от */
		"param":<text>,		/* название параметра */
		"text_mask":<text>,	/* текстовая маска */
		"type":<text>,		/* срабатывать: 0 - в рамках установленных значений, 1 - за пределами установленных значений */
		"upper_bound":<text>	/* значение параметра до */
	}
}

Типы контроля параметра:

• 0 - диапазон значений,
• 1 - текстовая маска,
• 2 - присутствие параметра,
• 3 - отсутствие параметра.

"trg":{
	"t":"sensor_value",		/* тип контроля */
	"p":{
		"lower_bound":<text>,		/* значение датчика от */
		"merge":<text>,			/* одинаковые датчики: 0 - считать отдельно, 1 - суммировать значения */
		"sensor_name_mask":<text>,	/* маска названия датчика */
		"sensor_type":<text>,		/* тип датчика */
		"type":<text>,			/* срабатывать: 0 - в рамках установленных значений, 1 - за пределами установленных значений */
		"upper_bound":<text>		/* значение датчика до */
	}
}

"trg":{
	"t":"outage",		/* тип контроля */
	"p":{
		"time":<text>,		/* длительность потери (секунд) */
		"type":<text>		/* тип потери: 0 - координаты, 1  - связь */
	}
}

"trg":{
	"t":"speed",		/* тип контроля */
	"p":{
		"lower_bound":<text>,		/* значение датчика от */
		"max_speed":<text>,		/* максимальная скорость, км/ч */
		"merge":<text>,			/* одинаковые датчики: 0 - считать отдельно, 1 - суммировать значения */
		"min_idle_time":<text>,		/* допустимое время простоя, мин */
		"min_speed":<text>,		/* минимальная скорость, км/ч */
		"reversed":<text>,		/* срабатывать: 0 - в рамках установленных значений, 1 - за пределами установленных значений */
		"sensor_name_mask":<text>,	/* маска названия датчика */
		"sensor_type":<text>,		/* тип датчика */
		"upper_bound":<text>		/* значение датчика до */
	}
}

"trg":{
	"t":"sms",		/* тип контроля */
	"p":{
		"mask":<text>		/* маска для текста SMS-сообщения */
	}
}

"trg":{
	"t":"interposition",		/* тип контроля */
	"p":{
		"lower_bound":<text>,		/* значение датчика от */
		"max_speed":<text>,		/* максимальная скорость, км/ч */
		"merge":<text>,			/* одинаковые датчики: 0 - считать отдельно, 1 - суммировать значения */
		"min_speed":<text>,		/* минимальная скорость, км/ч */
		"radius":<text>,		/* радиус, м */
		"reversed":<text>,		/* срабатывать: 0 - в рамках установленных значений, 1 - за пределами установленных значений */
		"sensor_name_mask":<text>,	/* маска названия датчика */
		"sensor_type":<text>,		/* тип датчика */
		"type":<text>,			/* тип проверки: 0 - контролировать приближение к объектам, 1 - контролировать удаление от объектов */
		"unit_guids":<text>,		/* GUIDы контролируемыx объектов (через запятую) */
		"upper_bound":<text>		/* значение датчика до */
	}
}

"trg":{
	"t":"route_control",		/* тип контроля */
	"p":{
		"mask":<text>,			/* маска имени маршрута */
		"types":<text>			/* типы контроля маршрута (через запятую) */
	}
}

Типы контроля маршрута:

• 1 - начало маршрута;
• 2 - завершение маршрута;
• 3 - прерывание маршрута;
• 11 - прибытие в контрольную точку;
• 12 - пропуск контрольной точки;
• 13 - отправление из контрольной точки;
• 14 - опоздание;
• 15 - опережение;
• 16 - возвращение в расписание;
• 21 - вход в геозону;
• 22 - выход из геозоны.

"trg":{
	"t":"driver",		/* тип контроля */
	"p":{
		"driver_code_mask":<text>,	/* маска кода водителя */
		"flags":<text>			/* тип контроля: 1 - назначение водителя,  2 - снятие водителя */
	}
}

"trg":{
	"t":"service_intervals",	/* тип контроля */
	"p":{
		"days":<text>,			/* интервал в днях */
		"engine_hours":<text>,		/* интервал по моточасам, ч */
		"flags":<text>,			/* флаги контроля техобслуживания */
		"mask":<text>,			/* маска фильтра инревалов */
		"mileage":<text>,		/* интервал по пробегу, км */
		"val":<text>			/* уведомлять: 1 - о приближении срока техобслуживания, -1 - о просрочке */
	}
}

Флаги контроля техобслуживания:

• 0 - не учитывать инетрвалы,
• 1 - интервал по пробегу,
• 2 - интервал по моточасам,
• 4 - интервал в днях.