| Version 9 (modified by tolix, 13 years ago) (diff) |
|---|
Шаблоны оповещений
Поля "Шаблон сообщения" и "Получатель" имеют возможность включать в текст сообщения или адрес получателя информацию о событии, либо системную информацию, доступную на момент обработки оповещения. Для этого предназначены специальные макропеременные. При отправке сообщения, макропеременные заменяются на их значения.
Синтаксис для макроподстановки:
%(name)s
где name - имя переменной для подстановки.
Информация о событии
Значения переменных зависят от типа события. Если переменная не применима к определенному типу события, ее значение будет пустым.
| event.name | имя события |
| event.timestamp | дата и время события |
| event.timestamp.iso | дата и время события в формате ISO8601 (YYYY-MM-DD HH:MM:SS) |
| event.timestamp.eur | дата и время события в формате DD.MM.YYYY HH:MM:SS |
| event.point.lat | географическая широта, градусы |
| event.point.lng | географическая долгота, градусы |
| event.point.speed | скорость в точке, км/ч |
| event.point.address | адрес близлежащих ориентиров |
| event.geozone.name | имя контрольной зоны |
| event.sender | отправитель сообщения (для событий "Входящее сообщение") |
| event.object.name | имя объекта, относящегося к событию |
| event.object.is_actual | актуальность последних данных телеметрии |
| event.object.is_link_up | состояние связи с объектом |
| event.object.is_moving | наличие движения |
| event.object.last_point.lat | географическая широта, градусы |
| event.object.last_point.lng | географическая долгота, градусы |
| event.object.last_point.speed | скорость, км/ч |
| event.object.last_point.address | адрес близлежащих ориентиров |
| event.object.in_geozones | список контрольных зон, в которых в данный момент присутствует объект |
| event.object.assigned_operators.first.name | имя контролирующего оператора, первого из списка |
| event.object.assigned_operators.first.email | email контролирующего оператора, первого из списка |
| event.object.assigned_operators.first.phone | телефон контролирующего оператора, первого из списка |
Информация о состоянии произвольных объектов
| objects[N].name | имя объекта |
| objects[N].is_actual | актуальность последних данных об объекте |
| objects[N].is_link_up | состояние связи с объектом |
| objects[N].is_moving | последнее состояие объекта (движется или стоит) |
| objects[N].in_geozones | список контрольных зон, в которых в данный момент присутствует объект |
| objects[N].last_point.lat | географическая широта, градусы |
| objects[N].last_point.lng | географическая долгота, градусы |
| objects[N].last_point.speed | скорость, км/ч |
| objects[N].last_point.address | адрес близлежащих ориентиров |
| objects[N].assigned_operators.first.name | имя контролирующего оператора, первого из списка |
| objects[N].assigned_operators.first.email | email контролирующего оператора, первого из списка |
| objects[N].assigned_operators.first.phone | телефон контролирующего оператора, первого из списка |
N - системный код объекта. Код объекта можно узнать в консоли оператора в свойствах выбранного объекта, либо в консоли администратора, если сделать видимым столбец с кодами объектов.
Обработка входящих сообщений от служб уведомлений
Система может не только отправлять, но принимать и обрабатывать сообщения от служб уведомлений. Это могут быть и SMS сообщения, и любые другие, для которых настроены соответствующие службы.
Таким образом, появляется возможность реализовать сервис для предоставления информации по объектам, например, по SMS запросу.
Для отправки ответного сообщения сервером в поле получателя может быть использована макропеременная event.sender, которая хранит реквизит (адрес или телефон) отправителя входящего сообщения.
Пример шаблона оповещения:
Привет, Время: %(event.timestamp.iso)s Двигаемся около: %(event.point.address)s Скорость: %(event.point.speed)s Объект: %(objects[1].name)s Актуальность данных: %(objects[1].is_actual)s Состояние объекта: %(objects[1].is_moving)s Скорость: %(objects[1].last_point.speed)s км/ч Широта: %(objects[1].last_point.lat)s Долгота: %(objects[1].last_point.lng)s Адрес: %(objects[1].last_point.address)s Геозоны: %(objects[1].in_geozones)s -- Sincerely Yourth, MonitorServer!