Текст уведомления

Текст актуален лишь для некоторых действий по уведомлению: уведомление посредством SMS-сообщения или письмом на электронную почту, регистрация события в истории объекта и для всплывающего онлайн-уведомления.

Текст может быть любой длины и содержать любые символы, если вы хотите его получить по e-mail. Если же вы хотите получить его по SMS, то длинных сообщений писать не следует. Текст уведомления может содержать любые введенные вами фразы на любом языке. Кроме того, можно использовать параметры, зашифрованные специальными знаками, которые при отправке уведомления будут заменены реальными значениями.

Пример.
Текст «Объект '%UNIT%' нарушил ограничения по скорости и в '%POS_TIME%' двигался со скоростью %SPEED% около '%LOCATION%'» может быть преобразован в «Объект 'Ровер119' нарушил ограничения по скорости и в '2000-01-01 12:01:37' двигался со скоростью 156 км/ч около 'Ленинградское шоссе'».

Единицы измерения (километры или мили), используемые для расшифровки параметров, зависят от настроек ресурса, к которому принадлежит уведомление. Формат даты и времени берется из настроек создателя данного ресурса.

В текст уведомления со способом действия «Выполнить запрос» необходимо ввести параметры запроса. При самостоятельном составлении текста уведомления следует использовать URL-кодирование. Обратите внимание, что при одновременном использовании этого способа действия с другими (например, «Уведомить по e-mail», «Уведомить при помощи SMS» и т. д.) для всех уведомлений создается общий текст.

Ниже приводится список всех универсальных параметров, которые применимы практически к любому типу уведомления:

%UNIT% Имя объекта.
%CURR_TIME% Текущие дата и время.
%LOCATION% Местоположение объекта на момент срабатывания уведомления.
%LAST_LOCATION% Последнее известное местоположение объекта
(может быть полезно, если в сработавшем сообщении нет позиционных данных).
%LOCATOR_LINK(60,T)% Создать ссылку локатора для сработавшего объекта (в скобках укажите срок действия ссылки в минутах, параметры T и G для отображения треков и геозон).
%ZONE_MIN% Наименьшая из геозон, в которых находился объект на момент уведомления.
%ZONES_ALL% Все геозоны, в которых находился объект в момент срабатывания уведомления.
%SPEED% Скорость движения объекта (не используется для сливов и заправок).
%POS_TIME% Дата и время сообщения, которое сработало, или последнего сообщения с позицией, если сработавшее непозиционное.
%MSG_TIME% Дата и время сообщения, которое сработало.
%DRIVER% Имя водителя (отображается только если водитель принадлежит тому же ресурсу, что и уведомление).
%TRAILER% Имя прицепа (отображается только если прицеп принадлежит тому же ресурсу, что и уведомление).
%SENSOR(*)% Датчики и их показания (в скобках укажите маску датчика).
%ENGINE_HOURS% Моточасы в момент срабатывания уведомления.
%MILEAGE% Пробег на момент срабатывания уведомления.
%LAT% Географическая широта на момент уведомления (напр., N 55° 45.7530').
%LON% Географическая долгота на момент уведомления (напр., E 37° 35.2068').
%LATD% Географическая широта без форматирования.
%LOND% Географическая долгота без форматирования.
%GOOGLE_LINK% Ссылка на Google Maps с местоположением объекта на момент уведомления
(например, http://maps.google.com/?q=55.762550N,37.586780E).
%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% Имя прицепа (для уведомления о назначении/снятии прицепа).
%OTHER_UNIT%Имя другого объекта (применяется для уведомлений о взаиморасположении объектов).
%ROUTE_NAME% Имя маршрута.
%ROUTE_STATUS% Статус выполнения рейса по заданному маршруту.
%ROUTE_POINT% Имя контрольной точки маршрута.
%ROUTE_SCHEDULE% Имя расписания маршрута.
%ROUND_NAME% Имя рейса.
%COUNTRY% Страна.
%REGION% Регион (штат и т. п.).
%CITY% Город (населенный пункт).
%STREET% Улица.
%HOUSE% Дом.

Обратите внимание, что данные параметры должны с двух сторон выделяться знаком процента. В противном случае они так и останутся текстом и не будут заменены на конкретные значения.

Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2019 Gurtam