Текст уведомления
Текст уведомления указывается для следующих способов действия:
- уведомить по 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%. |