Текст уведомления
Текст уведомления указывается для следующих способов действия:
- уведомить по email,
- уведомить при помощи SMS,
- показать онлайн-уведомление во всплывающем окне,
- отправить мобильное уведомление,
- зарегистрировать событие для объекта.
Текст уведомления может быть на любом языке, и в нем могут содержаться любые символы.
В текст можно добавить теги — ключевые слова, которые при формировании текста уведомления преобразуются в значения, которым они соответствуют. Например, текст «Объект %UNIT% нарушил ограничения по скорости и в %POS_TIME% двигался со скоростью %SPEED% около ‘%LOCATION%’» преобразуется в «Объект Ровер119 нарушил ограничения по скорости и в 2022-05-01 12:01:37 двигался со скоростью 156 км/ч около ‘Ленинградское шоссе’». Для добавления тега в текст щелкните по нему или введите вручную.
Теги должны выделяться знаком процента с двух сторон. В противном случае они остаются текстом и не заменяются на конкретные значения.
Единицы измерения (километры или мили), используемые для расшифровки тегов, зависят от настроек ресурса, к которому относится уведомление. Формат даты и времени берется из настроек создателя этого ресурса.
Набор тегов, которые можно использовать в тексте, зависит от типа уведомления. Ниже приведен список тегов, которые доступны для большинства типов уведомлений.
| Тег | Описание |
|---|---|
| %UNIT% | Имя объекта. |
| %CURR_TIME% | Текущие дата и время. |
| %LOCATION% | Местоположение объекта в момент срабатывания уведомления. |
| %LAST_LOCATION% | Последнее известное местоположение объекта. Тег может быть полезен, если в сообщении, по которому сработало уведомление, нет позиционных данных. |
| %LOCATOR_LINK(60,T)% | Ссылка локатора на местоположение объекта, по которому пришло уведомление. В скобках укажите время жизни ссылки в минутах и, при необходимости, добавьте параметры T и G для отображения треков и геозон соответственно. Время жизни ссылки локатора по умолчанию составляет 60 минут. Для неограниченного времени жизни введите 0 (ноль). |
| %ZONE_MIN% | Наименьшая из геозон, в которых находился объект в момент срабатывания уведомления. Имя геозоны показывается вместо тега, только если геозона и уведомление были созданы в одном ресурсе. |
| %ZONES_ALL% | Все геозоны, в которых находился объект в момент срабатывания уведомления. |
| %SPEED% | Скорость движения объекта. |
| %POS_TIME% | Дата и время сообщения, по которому сработало уведомление. Если в этом сообщении нет данных о местоположении объекта, показывается дата и время последнего сообщения, в котором есть эти данные. |
| %MSG_TIME% | Дата и время сообщения, по которому сработало уведомление. |
| %DRIVER% | Не применяется в системе. |
| %DRIVER_PHONE% | Не применяется в системе. |
| %TRAILER% | Не применяется в системе. |
| %SENSOR(*)% | Датчик и его показания. В скобках необходимо указать имя датчика или его маску. Если в скобках оставить звездочку, то показываются все датчики объекта и их значения. |
| %ENGINE_HOURS% | Значение моточасов в момент срабатывания уведомления. |
| %MILEAGE% | Значение пробега в момент срабатывания уведомления. |
| %LAT% | Географическая широта в момент срабатывания уведомления (например, N 55° 45.7530’). |
| %LON% | Географическая долгота в момент срабатывания уведомления (например, E 37° 35.2068’). |
| %LATD% | Географическая широта без форматирования. |
| %LOND% | Географическая долгота без форматирования. |
| %GOOGLE_LINK% | Ссылка на Google Maps с местоположением объекта в момент срабатывания уведомления (например, https://www.google.com/maps/place/59%C2%B026’08.6%22N+24%C2%B045’09.5%22E). |
| %CUSTOM_FIELD(*)% | Произвольные поля из свойств объекта. Если в скобках оставить звездочку, то показываются все доступные произвольные поля, включая административные, и их значения. Чтобы получить значение определенного поля, в скобках необходимо указать его имя целиком. В этом случае в уведомлении показывается только значение поля (без его имени). |
Теги, описанные ниже, применяются к конкретным типам уведомлений.
| Тег | Описание |
|---|---|
| %ZONE% | Имя геозоны, о которой пришло уведомление. Используется в уведомлениях по геозонам. В уведомлении типа Вне геозоны в теге %ZONE% через запятую выводятся имена геозон, в которых объект был в момент предыдущего сообщения, но которые уже покинул. Если таких геозон нет или предыдущее сообщение с местоположением не найдено, то в тексте уведомления выводится только название тега (%ZONE%). |
| %ZONE_DESC% | Описание из свойств геозоны. Используется в уведомлениях по геозонам. |
| %SENSOR_NAME% | Имя датчика, по которому сработало уведомление. Используется с типами уведомлений, для которых можно указать маски датчиков. |
| %SENSOR_VALUE% | Значение датчика, которое вызвало срабатывание уведомления. Используется с типами уведомлений, для которых можно указать маски датчиков. |
| %TRIGGERED_SENSORS% | Все датчики, которые вызвали срабатывание уведомления, и их значения. Используется с типами уведомлений, для которых можно указать маски датчиков. |
| %LOSE_RESTORE% | Потеря или восстановление связи. Используется в уведомлениях о потере связи. |
Если информации о данных нет, теги показываются как есть, т. е. не заменяются на реальные значения. Исключение составляют следующие теги, которые при отсутствии данных не показываются в тексте уведомления:
| Объекты и группы объектов | Дата и время | Местоположение и геозоны | Другие |
|---|---|---|---|
| %UNIT%, %UNIT_GROUP%, %UNIT_ID%. |
%CURR_TIME%, %POS_TIME%, %MSG_TIME%. |
%LOCATION%, %LAST_LOCATION%, %LAT%, %LON%, %LATD%, %LOND%, %GOOGLE_LINK%, %ZONES_ALL%, %ZONE_MIN%. |
%SPEED%, %ENGINE_HOURS%, %MILEAGE%, %LOSE_RESTORE%. |