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

Текст уведомления указывается для следующих способов действия:

  • уведомить по email;
  • уведомить при помощи SMS;
  • отправить уведомление в Telegram;
  • показать онлайн-уведомление во всплывающем окне;
  • отправить мобильное уведомление;
  • выполнить запрос;
  • зарегистрировать событие для объекта.

Текст уведомления может быть на любом языке, и в нем могут содержаться любые символы.

При выборе способа действия Уведомить при помощи SMS не рекомендуется указывать длинный текст. Если длина текста превышает максимальную допустимую длину SMS-сообщения, то текст отправляется в нескольких сообщениях.

При способе действия Выполнить запрос в текст уведомления необходимо ввести параметры запроса. Кроме параметров, можно ввести текст, используя URL-кодирование. Если вы используете этот способ действия вместе с другими (например, уведомить по email или SMS), для всех уведомлений создается общий текст.

В текст можно добавить теги — ключевые слова, которые при формировании текста уведомления преобразуются в значения, которым они соответствуют. Например, текст «Объект %UNIT% нарушил ограничения по скорости и в %POS_TIME% двигался со скоростью %SPEED% около ‘%LOCATION%’» преобразуется в «Объект Ровер119 нарушил ограничения по скорости и в 2022-05-01 12:01:37 двигался со скоростью 156 км/ч около ‘Ленинградское шоссе’». Для добавления тега в текст щелкните по нему или введите вручную.

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

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

Набор тегов, которые можно использовать в тексте, зависит от типа уведомления. Ниже приведен список тегов, которые доступны для большинства типов уведомлений.

ТегОписание

%UNIT%

Имя объекта.

%UNIT_ID%

Внутренний ID объекта в системе.

%CURR_TIME%

Текущие дата и время.

%LOCATION%

Местоположение объекта в момент срабатывания уведомления. Для уведомления о сливе топлива показывается местоположение в начале слива.

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

%LAST_LOCATION%

Последнее известное местоположение объекта. Определяется по источнику геоданных, выбранному в настройках пользователя-создателя ресурса, в котором хранится уведомление. Тег может быть полезен, если в сообщении, по которому сработало уведомление, нет позиционных данных. 

%LOCATOR_LINK(60,T)%

Ссылка локатора на местоположение объекта, о котором пришло уведомление. В скобках укажите срок действия ссылки в минутах и, если необходимо, параметры T и G для отображения треков и геозон соответственно. По умолчанию срок действия ссылки равен 60 минутам. Для неограниченного срока действия укажите 0 (ноль).

%ZONE_MIN%

Наименьшая из геозон, в которых находился объект в момент срабатывания уведомления. Имя геозоны показывается вместо тега, только если геозона и уведомление были созданы в одном ресурсе.

%ZONES_ALL%

Все геозоны, в которых находился объект в момент срабатывания уведомления.

%SPEED%

Скорость движения объекта. Тег не работает в уведомлениях о заправках, сливах и зарядках батареи.

%POS_TIME%

Дата и время сообщения, по которому сработало уведомление. Если в этом сообщении нет данных о местоположении объекта, показывается дата и время последнего сообщения, в котором есть эти данные.

%MSG_TIME%

Дата и время сообщения, по которому сработало уведомление.

%MSG_TIME_INT% Дата и время сообщения, по которому сработало уведомление, в формате Unix.
%NOTIFICATION%Имя уведомления.

%DRIVER%

Имя водителя, назначенного на объект на момент срабатывания уведомления. Показывается, только если водитель относится к тому же ресурсу, что и уведомление.

%DRIVER_PHONE%

Телефонный номер водителя. 

%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(*)%

Произвольные поля из свойств объекта. Если в скобках оставить звездочку, то показываются все доступные произвольные поля, включая административные, и их значения. Чтобы получить значение определенного поля, в скобках необходимо указать его имя целиком. В этом случае в уведомлении показывается только значение поля (без его имени).

%VIDEO_LINK%

Ссылка на видеофайлы. Используется для уведомлений со способом действия Сохранить видео как файл. Ссылки действительны в течение 48 часов.

В тегах, обозначающих время, используется часовой пояс создателя ресурса, в котором хранится уведомление.

Теги, описанные ниже, применяются к конкретным типам уведомлений.

Тег Описание
%SPEED_LIMIT% Значение ограничения скорости на дороге в момент срабатывания уведомления. Используется в уведомлениях типа Скорость, если выбран тип контроля Ограничение скорости на дорогах.
%SPEEDING_VALUE% Значение, на которое было превышено скоростное ограничение. Используется в уведомлениях типа Скорость, если выбран тип контроля Ограничение скорости на дорогах.
%ZONE% Имя геозоны, о которой пришло уведомление. Используется в уведомлениях по геозонам. В уведомлении типа Вне геозоны в теге %ZONE% через запятую выводятся имена геозон, в которых объект был в момент предыдущего сообщения, но которые уже покинул. Если таких геозон нет или предыдущее сообщение с местоположением не найдено, то в тексте уведомления выводится только название тега (%ZONE%).
%ZONE_DESC% Описание из свойств геозоны. Используется в уведомлениях по геозонам.
%SENSOR_NAME% Имя датчика, по которому сработало уведомление. Используется с типами уведомлений, для которых можно указать маски датчиков. Если выбрана опция Суммировать значения, то из всех датчиков, значения которых суммируются, здесь показывается имя того, у которого наименьший ID в системе. Таким образом, то, какой датчик подставляется вместо тега, не зависит от значения этого датчика.
%SENSOR_VALUE% Значение датчика, которое вызвало срабатывание уведомления. Используется с типами уведомлений, для которых можно указать маски датчиков.
%TRIGGERED_SENSORS% Все датчики, которые вызвали срабатывание уведомления, и их значения. Используется с типами уведомлений, для которых можно указать маски датчиков. В отличие от тега %SENSOR_NAME%, здесь показываются именно те датчики, значения которых входят в указанный диапазон (если выбран тип срабатывания Внутри диапазона) или не попадают в него (если выбран тип срабатывания За пределами диапазона).
%LOSE_RESTORE% Потеря или восстановление связи. Используется в уведомлениях о потере связи.
%SERVICE_NAME% Имя сервиса. Используется в уведомлениях типа Техобслуживание.
%SERVICE_TERM% Состояние сервиса: сколько времени, километров или моточасов осталось или на сколько он просрочен.
%PARAM_NAME% Название параметра, который контролируется с помощью уведомления. Используется в уведомлениях типа Параметр в сообщении.
%PARAM_VALUE% Значение параметра. Используется в уведомлениях типа Параметр в сообщении.
%SMS_TEXT% Текст SMS-сообщения. Используется в уведомлениях о получении SMS.
%TYPE% Тип пополнения энергии объекта: заправка топлива или зарядка батареи. Используется в уведомлениях о заправках и сливах и в уведомлениях о сливах.
%VOLUME% Объем заправки, слива или зарядки батареи. Используется в уведомлениях о заправках и зарядках и в уведомлениях о сливах.
%INITIAL_LEVEL% Уровень топлива на момент начала заправки или слива или уровень заряда батареи на момент начала зарядки.
%FINAL_LEVEL% Уровень топлива на момент окончания заправки или слива или уровень заряда батареи на момент окончания зарядки.
%TIME_FROM% Время начала заправки, слива или зарядки батареи.
%TIME_TO% Время окончания заправки, слива или зарядки батареи.
%DURATION% Продолжительность заправки, слива или зарядки в минутах.
%DRIVER_ID% Код водителя. Используется в уведомлениях типа Водитель.
%DRIVER_NAME% Имя водителя. Используется в уведомлениях типа Водитель.
%TRAILER_ID% Код прицепа. Используется в уведомлениях типа Прицеп.
%TRAILER_NAME% Имя прицепа. Используется в уведомлениях типа Прицеп.
%TAG_ID% Код пассажира. Используется в уведомлениях о пассажирах.
%TAG_NAME% Имя пассажира. Используется в уведомлениях о пассажирах.
%OTHER_UNIT% Имя другого объекта. Используется в уведомлениях типа Взаиморасположение объектов.
%MSG_COUNT% Количество сообщений. Используется в уведомлениях типа Превышение количества сообщений.
%ROUTE_NAME% Имя маршрута. Используется в уведомлениях о прохождении маршрута.
%ROUTE_STATUS% Статус выполнения рейса по маршруту.
%ROUTE_POINT% Имя контрольной точки маршрута.
%ROUTE_SCHEDULE% Имя расписания маршрута.
%ROUND_NAME% Имя рейса.
%COUNTRY% Страна. Используется в уведомлениях типа Адрес.
В сработавшем уведомлении типа Адрес вместо тегов %COUNTRY%, %REGION%, %CITY%, %STREET%, %HOUSE% показывается информация из адреса, указанного в свойствах уведомления. Формат адреса берется из источника геоданных в настройках пользователя-создателя ресурса, где хранится уведомление.
%REGION% Регион (штат и т. п.).
%CITY% Город (населенный пункт).
%STREET% Улица.
%HOUSE% Дом.
%HEALTH CHECK STATUS% Статус устройства на момент срабатывания уведомления. Используется в уведомлениях типа Состояние устройств.
%REASON% Список активных инцидентов на момент срабатывания уведомления. Используется в уведомлениях типа Состояние устройств.

Если информации о данных нет, теги показываются как есть, т. е. не заменяются на реальные значения. Исключение составляют следующие теги, которые при отсутствии данных не показываются в тексте уведомления:

Объекты и группы объектов Дата и время Местоположение и геозоны Пассажиры Другие
%UNIT%,
%UNIT_GROUP%,
%UNIT_ID%.
%CURR_TIME%,
%POS_TIME%,
%MSG_TIME%.
%LOCATION%,
%LAST_LOCATION%,
%LAT%, %LON%,
%LATD%, %LOND%,
%GOOGLE_LINK%,
%LOCATOR_LINK%,
%ZONES_ALL%,
%ZONE_MIN%.
%TAG_NAME%,
%TAG_ID%.
%SPEED%,
%ENGINE_HOURS%,
%MILEAGE%,
%LOSE_RESTORE%.

Вопросы и ответы

В отчете, уведомлении или инструменте поиска неверная адресная информация. Что делать?

Пришлите, пожалуйста, запрос support@wialon.com с указанием координат места и правильного адреса.

Скачать файл PDF
Скачать документ Word