Настройка текста уведомления
Вы можете указать текст на шаге 4 настройки уведомления. Этот шаг доступен, если вы выбрали одно из следующих действий на предыдущем шаге:
- Уведомить по email
- Уведомить при помощи SMS
- Отправить уведомление в Telegram
- Показать онлайн-уведомление во всплывающем окне
- Отправить мобильное уведомление
- Выполнить запрос
- Зарегистрировать событие для объекта
Когда вы переходите к этому шагу, показывается стандартный текст уведомления. Этот текст по умолчанию генерируется автоматически только на основе первого настроенного условия и не учитывает остальные условия. Вы можете вручную отредактировать этот текст и добавить теги, относящиеся ко всем включенным условиям.
Текст уведомления может быть на любом языке и содержать любые символы.
Если вы выбрали действие Уведомить при помощи SMS, не рекомендуется указывать длинный текст. Если длина текста превышает максимально допустимую длину SMS-сообщения, текст отправляется в нескольких сообщениях.
Если вы выбрали действие Выполнить запрос, необходимо ввести параметры запроса в текст уведомления. Помимо параметров вы можете ввести текст, используя URL-кодирование. Если вы используете это действие вместе с другими (например, уведомить по email или SMS), для всех уведомлений создается один и тот же текст.
Использование тегов
Вы можете добавить теги в текст. Это ключевые слова, которые заменяются реальными значениями при срабатывании уведомления.
Тег должен быть отмечен знаком процента с обеих сторон. В противном случае он считается обычным текстом и не заменяется реальными значениями.
Например, текст:
Объект %UNIT% нарушил ограничения скорости и в %POS_TIME% двигался со скоростью %SPEED% около %LOCATION%.
преобразуется в:
Объект Ровер119 нарушил ограничения скорости и в 2022-05-01 12:01:37 двигался со скоростью 156 км/ч около KU 8, Thurnau, DE.
Чтобы добавить тег в текст, нажмите на него в списке под текстовым полем или введите его вручную.
Теги в уведомлениях с несколькими условиями (оператор ИЛИ)
При использовании оператора ИЛИ текст уведомления не изменяется в зависимости от того, какое условие вызвало срабатывание уведомления; для всех используется один и тот же шаблон. Только теги, относящиеся к условию, которое фактически вызвало срабатывание, заменяются реальными значениями. Теги, относящиеся к условиям, которые не сработали, остаются в доставленном сообщении в виде текста (например, %SPEED% или %ADDRESS%). Если один и тот же тип условия используется несколько раз (например, Значение датчика ИЛИ Значение датчика), тег показывает значение того датчика, который вызвал срабатывание уведомления.
Правила форматирования тегов
- Единицы измерения (километры или мили), используемые для расшифровки тегов, зависят от настроек ресурса, к которому относится уведомление.
- Формат даты и времени берется из настроек создателя ресурса.
- Для тегов времени используется часовой пояс, указанный для создателя ресурса, в котором хранится уведомление.
Вопросы и ответы
Категории тегов и их доступность
Набор тегов, доступных для использования, зависит от конкретного условия или условий, которые вы выбрали на шаге 1 настройки уведомления.
Под полем ввода текста теги сгруппированы по категориям, таким как Общие теги и теги, специфичные для условий (например, Въезд в геозону). Вы можете нажать на ссылки рядом с Перейти к:, чтобы просмотреть соответствующий список тегов.
Общие теги
Ниже приведен список общих тегов, доступных для большинства типов уведомлений.
| Тег | Описание |
|---|---|
%UNIT% |
Имя объекта. |
%UNIT_ID% |
Внутренний идентификатор объекта в системе. |
%CURR_TIME% |
Текущие дата и время. |
%LOCATION% |
Местоположение объекта в момент срабатывания уведомления. Определяется по источнику геоданных, выбранному в настройках пользователя, создавшего ресурс, в котором хранится уведомление. Для условия Слив отображается местоположение в начале слива. |
%LAST_LOCATION% |
Последнее местоположение объекта в момент срабатывания уведомления. Определяется по источнику геоданных, выбранному в настройках пользователя, создавшего ресурс. Этот тег полезен, если сообщение, вызвавшее срабатывание уведомления, не содержит данных о местоположении. |
%LOCATOR_LINK(60,T)% |
Создание ссылки локатора для объекта, вызвавшего срабатывание. В скобках укажите срок действия в минутах и используйте параметры T и G для отображения треков и геозон. Срок действия по умолчанию — 60 минут. Для неограниченного срока действия введите 0 (ноль). |
%ZONE_MIN% |
Наименьшая из геозон, в которых находился объект в момент срабатывания уведомления. Имя геозоны отображается вместо тега только в том случае, если геозона и уведомление принадлежат одному и тому же ресурсу. |
%ZONES_ALL% |
Все геозоны, в которых находился объект в момент срабатывания уведомления. |
%UNIT_GROUP% |
Группы, содержащие объект, вызвавший срабатывание. |
%SPEED% |
Скорость объекта в момент срабатывания уведомления. Тег не работает в уведомлениях о заправках, сливах и зарядках. |
%POS_TIME% |
Дата и время сообщения, которое вызвало срабатывание уведомления. Если это сообщение не содержит данных о местоположении, тег заменяется датой и временем последнего сообщения с этими данными. |
%MSG_TIME% |
Дата и время сообщения, которое вызвало срабатывание уведомления. |
%MSG_TIME_INT% |
Unix-время сообщения, которое вызвало срабатывание уведомления. |
%NOTIFICATION% |
Имя уведомления. |
%DRIVER% |
Имя водителя, назначенного на объект в момент срабатывания уведомления. Отображается только в том случае, если водитель принадлежит тому же ресурсу, что и уведомление. |
%DRIVER_PHONE% |
Номер телефона водителя. |
%TRAILER% |
Имя прицепа, назначенного на объект в момент срабатывания уведомления. Отображается только в том случае, если прицеп принадлежит тому же ресурсу, что и уведомление. |
%VIDEO_LINK(480)% |
Ссылки на видеофайлы, сохраненные для сработавшего уведомления. Эти ссылки создаются, когда действие Сохранить видео как файл настроено вместе с любым действием, которое позволяет вводить текст. В скобках укажите срок действия ссылок в минутах в диапазоне от 480 (минимум) до 2880 (максимум). Значение за пределами этого диапазона сбрасывается до значения по умолчанию 480 минут. |
%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(*)% |
Произвольные поля из свойств объекта. Если вы оставите звездочку в скобках, будут показаны все произвольные поля, включая административные, и их значения. Чтобы получить значение определенного поля, укажите его полное название в скобках. В этом случае в уведомлении будет показано только значение поля (без имени поля). |
SMS
Этот тег показывает содержимое SMS-сообщения.
| Тег | Описание |
|---|---|
%SMS_TEXT% |
Текст SMS-сообщения. |
Адрес
Используйте эти теги для отображения отдельных компонентов адреса местоположения объекта.
В сработавшем уведомлении с условием Адрес вместо тегов ниже отображается информация из адреса, указанного на шаге 1 настройки уведомления. Формат адреса берется из источника геоданных в настройках пользователя, создавшего ресурс, в котором хранится уведомление.
| Тег | Описание |
|---|---|
%COUNTRY% |
Название страны. |
%REGION% |
Название региона (области, штата и т. д.). |
%CITY% |
Название города (населенного пункта и т. д.). |
%STREET% |
Название улицы. |
%HOUSE% |
Номер дома. |
Близость объекта
Этот тег указывает другой объект, к которому приблизился основной объект.
| Тег | Описание |
|---|---|
%OTHER_UNIT% |
Имя другого объекта или объектов, к которым приблизился основной объект. |
Вход в геозону
Используйте эти теги для включения информации о взаимодействии объекта с определенными областями.
| Тег | Описание |
|---|---|
%ZONE_INSIDE% |
Название геозоны, о которой получено уведомление. |
%ZONE_DESC% |
Описание из свойств геозоны. |
Выход из геозоны
Используйте эти теги для включения информации о взаимодействии объекта с определенными областями.
| Тег | Описание |
|---|---|
%ZONE_OUTSIDE% |
Имя геозоны, о которой получено уведомление. Тег %ZONE_OUTSIDE% заменяется названиями геозон, в которых находился объект в момент предыдущего сообщения, но из которых он уже выехал. Если таких геозон нет или предыдущее сообщение с данными о местоположении не найдено, в тексте уведомления отображается только имя тега (%ZONE_OUTSIDE%). |
%ZONE_DESC% |
Описание из свойств геозоны. |
Заправки, сливы топлива и зарядки батареи
Эти теги предоставляют полные данные о событиях пополнения или потери энергии.
| Тег | Описание |
|---|---|
%TYPE% |
Тип пополнения энергии: заправка топлива или зарядка батареи. Используется для условий Заправка топлива и Зарядка батареи. |
%VOLUME% |
Объем заправки топлива, слива топлива или зарядки батареи. |
%INITIAL_LEVEL% |
Уровень топлива в начале заправки или слива топлива, или уровень заряда батареи в начале зарядки. |
%FINAL_LEVEL% |
Уровень топлива в конце заправки или слива топлива, или уровень заряда батареи в конце зарядки. |
%TIME_FROM% |
Время начала заправки топлива, слива топлива или зарядки батареи. |
%TIME_TO% |
Время окончания заправки топлива, слива топлива или зарядки батареи. |
%SENSOR_NAME% |
Имя датчика, вызвавшего срабатывание уведомления. Если выбрана опция Суммировать значения, то из всех датчиков, значения которых суммируются, тег заменяется именем датчика, имеющего наименьший идентификатор в системе. Таким образом, имя, которое вы видите вместо тега, не зависит от значения датчика. |
%DURATION% |
Длительность заправки топлива, слива топлива или зарядки батареи в минутах. |
Значение датчика
Эти теги отображают информацию о конкретных датчиках, которые вызвали срабатывание уведомления.
| Тег | Описание |
|---|---|
%SENSOR_NAME% |
Имя датчика, по которому сработало уведомление. Если выбрана опция Суммировать значения, то из всех датчиков, значения которых суммируются, тег заменяется на название датчика с наименьшим идентификатором в системе. Таким образом, отображаемое вместо тега название не зависит от значения датчика. |
%SENSOR_VALUE% |
Значение датчика, вызвавшее срабатывание уведомления. |
%TRIGGERED_SENSORS% |
Все датчики, вызвавшие срабатывание уведомления, и их значения. В отличие от тега %SENSOR_NAME%, здесь вы можете увидеть именно те датчики, значения которых попадают в указанный диапазон (если выбран тип активации В диапазоне) или находятся вне диапазона (если выбран тип активации Вне диапазона). |
%SENSOR_VALUE_OLD% |
Значение датчика из предыдущего сообщения. |
Назначение водителя
Используйте эти теги для идентификации водителя, назначенного на объект.
| Тег | Описание |
|---|---|
%DRIVER_ID% |
Код водителя. |
%DRIVER_NAME% |
Имя водителя. |
Назначение пассажира, Пассажир не снят
Используйте эти теги для отображения информации об идентифицированных пассажирах.
| Тег | Описание |
|---|---|
%TAG_ID% |
Код пассажира. |
%TAG_NAME% |
Имя пассажира. |
Назначение прицепа
Эти теги показывают информацию о прицепе, который в данный момент назначен на объект.
| Тег | Описание |
|---|---|
%TRAILER_ID% |
Код прицепа. |
%TRAILER_NAME% |
Имя прицепа. |
Ограничениe скорости на дорогах
Эти теги предоставляют информацию об ограничениях скорости на дороге и о том, насколько они были превышены.
| Тег | Описание |
|---|---|
%SPEED_LIMIT% |
Ограничение скорости в момент срабатывания уведомления. |
%SPEEDING_VALUE% |
Значение, на которое было превышено ограничение скорости. |
Превышение количества сообщений
Этот тег указывает общее количество сообщений, полученных в течение указанного периода.
| Тег | Описание |
|---|---|
%MSG_COUNT% |
Количество сообщений. |
Прохождение маршрута
Эти теги описывают текущий статус объекта и его местоположение на маршруте.
| Тег | Описание |
|---|---|
%ROUTE_NAME% |
Имя маршрута. |
%ROUTE_STATUS% |
Статус выполнения рейса по маршруту. |
%ROUTE_POINT% |
Имя контрольной точки маршрута. |
%ROUTE_SCHEDULE% |
Имя расписания маршрута. |
%ROUND_NAME% |
Имя рейса. |
Состояние параметра
Эти теги отображают конкретные параметры и их значения, отправленные устройством.
| Тег | Описание |
|---|---|
%PARAM_NAME% |
Название параметра, контролируемого с помощью уведомления. |
%PARAM_VALUE% |
Значение параметра. |
Состояние соединения
Этот тег указывает, была ли потеряна или восстановлена связь объекта с сервером.
| Тег | Описание |
|---|---|
%LOSE_RESTORE% |
Потеря или восстановление связи. |
Состояние устройства
Эти теги описывают состояние работоспособности устройства и активные инциденты.
| Тег | Описание |
|---|---|
%HEALTH_CHECK_STATUS% |
Состояние устройства в момент срабатывания уведомления. |
%REASON% |
Список активных инцидентов в момент срабатывания уведомления. |
Техобслуживание
Используйте эти теги для отображения сведений о предстоящем или просроченном техническом обслуживании транспортного средства.
| Тег | Описание |
|---|---|
%SERVICE_NAME% |
Имя сервиса. |
%SERVICE_TERM% |
Состояние сервиса: сколько времени, километров или моточасов осталось, или насколько по времени, километрам или моточасам просрочен сервис. |
Отображение при отсутствии данных
Если данные неизвестны, теги показываются в неизменном виде, то есть они не заменяются какими-либо значениями. Это может произойти в уведомлениях с несколькими условиями ИЛИ, когда текст уведомления содержит теги из условия, которое не вызвало срабатывание уведомления.
Исключением являются следующие теги, которые автоматически скрываются и не показываются в тексте уведомления при отсутствии данных:
| Группа | Скрываемые теги при отсутствии данных |
|---|---|
| Объекты и группы объектов | %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% |