Текст используется лишь для некоторых действий по уведомлению: уведомление посредством SMS-сообщения или письмом на электронную почту, регистрация события в истории объекта и для всплывающего онлайн-уведомления.
Текст может быть любой длины и содержать любые символы, если вы хотите его получить по email. Если же вы хотите получить его по SMS, то длинных сообщений писать не следует. Текст уведомления может содержать любые введенные вами фразы на любом языке. Кроме того, можно использовать теги — параметры, зашифрованные специальными знаками, которые при отправке уведомления будут заменены реальными значениями.
Пример:
Текст «Объект '%UNIT%' нарушил ограничения по скорости и в '%POS_TIME%' двигался со скоростью %SPEED% около '%LOCATION%'» может быть преобразован в «Объект 'Ровер119' нарушил ограничения по скорости и в '2000-01-01 12:01:37' двигался со скоростью 156 км/ч около 'Ленинградское шоссе'».
Единицы измерения (километры или мили), используемые для расшифровки тегов, зависят от настроек ресурса, к которому принадлежит уведомление. Формат даты и времени берется из настроек создателя данного ресурса.
В текст уведомления со способом действия Выполнить запрос необходимо ввести параметры запроса. При самостоятельном составлении текста уведомления следует использовать URL-кодирование. Обратите внимание, что при одновременном использовании этого способа действия с другими (например, Уведомить по email, Уведомить при помощи SMS и т. д.) для всех уведомлений создается общий текст.
Ниже приведен список всех тегов, которые применимы практически к любому типу уведомления.
Тег | Описание |
---|---|
%UNIT% | Имя объекта. |
%UNIT_ID% | Внутренний ID объекта в системе. |
%CURR_TIME% | Текущие дата и время. |
%LOCATION% | Местоположение объекта на момент срабатывания уведомления. |
%LAST_LOCATION% | Последнее известное местоположение объекта |
%LOCATOR_LINK(60,T)% | Создать ссылку локатора для сработавшего объекта (в скобках укажите срок действия ссылки в минутах, параметры T и G для отображения треков и геозон). |
%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 с местоположением объекта на момент уведомления |
%CUSTOM_FIELD(*)% | Произвольные поля из свойств объекта. Если в скобках оставить звездочку, то показываются все доступные произвольные поля (включая административные), причем выводятся как названия этих полей, так и их значения. Чтобы получить значение конкретного поля, его имя нужно указать в скобках (должно быть полное соответствие), и в этом случае в уведомлении будет выведено только значение поля (без имени поля). |
Также есть теги, которые применяются к конкретным типам уведомлений.
Тег | Описание |
---|---|
%ZONE% | Имя сработавшей геозоны (для уведомления по геозонам). В тексте уведомлений типа Вне геозоны в теге %ZONE% через запятую выводятся имена геозон, в которых объект был в момент предыдущего сообщения и которые он уже покинул. Если не найдено предыдущего позиционного сообщения либо нет геозон, удовлетворяющих вышеуказанному условию, то в тексте уведомления выводится только название тега (%ZONE%). |
%ZONE_DESC% | Описание сработавшей геозоны (для уведомления по геозонам), взятое из ее свойств. |
%SENSOR_NAME% | Название сработавшего датчика (для контроля значения датчика в различных типах уведомлений). |
%SENSOR_VALUE% | Значение сработавшего датчика (для контроля значения датчика в различных типах уведомлений). |
%TRIGGERED_SENSORS% | Все сработавшие датчики и их значения (для контроля значения датчика в различных типах уведомлений). |
%LOSE_RESTORE% | Потеря связи/Восстановление связи (для уведомления о потере связи) |
%SERVICE_NAME% | |
%SERVICE_TERM% | Состояние интервала техобслуживания — сколько осталось или просрочено. |
%PARAM_NAME% | Имя параметра (для уведомления по контролю параметра в сообщении). |
%PARAM_VALUE% | Значение параметра (для уведомления по контролю параметра в сообщении). |
%SMS_TEXT% | Текст SMS-сообщения (для уведомления по контролю SMS). |
%VOLUME% | Объем заправки или слива (для соответствующих уведомлений). |
%INITIAL_LEVEL% | Уровень топлива на момент начала заправки или слива. |
%FINAL_LEVEL% | Уровень топлива на момент окончания заправки или слива. |
%TIME_FROM% | Время начала заправки или слива. |
%TIME_TO% | Время окончания заправки или слива. |
%DURATION% | Продолжительность заправки или слива (в минутах). |
%DRIVER_ID% | Код водителя (для уведомления типа Водитель). |
%DRIVER_NAME% | Имя водителя (для уведомления типа Водитель). |
%TRAILER_ID% | Код прицепа (для уведомления типа Прицеп). |
%TRAILER_NAME% | Имя прицепа (для уведомления типа Прицеп). |
%TAG_ID% | Код пассажира (для уведомления типа Активность пассажира). |
%TAG_NAME% | Имя пассажира (для уведомления типа Активность пассажира). |
%OTHER_UNIT% | Имя другого объекта (применяется для уведомлений о взаиморасположении объектов). |
%ROUTE_NAME% | Имя маршрута. |
%ROUTE_STATUS% | Статус выполнения рейса по заданному маршруту. |
%ROUTE_POINT% | Имя контрольной точки маршрута. |
%ROUTE_SCHEDULE% | Имя расписания маршрута. |
%ROUND_NAME% | Имя рейса. |
%COUNTRY% | Страна. |
%REGION% | Регион (штат и т. п.). |
%CITY% | Город (населенный пункт). |
%STREET% | Улица. |
%HOUSE% | Дом. |
Теги должны выделяться знаком процента с двух сторон. В противном случае они остаются текстом и не заменяются на конкретные значения.