Текст уведомления указывается для следующих способов действия:
- уведомить по 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(*)% | Произвольные поля из свойств объекта. Если в скобках оставить звездочку, то показываются все доступные произвольные поля, включая административные, и их значения. Чтобы получить значение определенного поля, в скобках необходимо указать его имя целиком. В этом случае в уведомлении показывается только значение поля (без его имени). |
Теги, описанные ниже, применяются к конкретным типам уведомлений.
Тег | Описание |
---|---|
%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_NAME% | Имя прицепа. Используется в уведомлениях типа Прицеп. |
%TRAILER_ID% | Код прицепа. Используется в уведомлениях типа Прицеп. |
%TAG_ID% | Код пассажира. Используется в уведомлениях о пассажирах. |
%TAG_NAME% | Имя пассажира. Используется в уведомлениях о пассажирах. |
%OTHER_UNIT% | Имя другого объекта. Используется в уведомлениях типа Взаиморасположение объектов. |
%MSG_COUNT% | Количество сообщений. Используется в уведомлениях типа Превышение количества сообщений. |
%ROUTE_NAME% | Имя маршрута. Используется в уведомлениях о прохождении маршрута. |
%ROUTE_STATUS% | Статус выполнения рейса по маршруту. |
%ROUTE_POINT% | Имя контрольной точки маршрута. |
%ROUTE_SCHEDULE% | Имя расписания маршрута. |
%ROUND_NAME% | Имя рейса. |
%COUNTRY% | Страна. Используется в уведомлениях типа Адрес. |
%REGION% | Регион (штат и т. п.). |
%CITY% | Город (населенный пункт). |
%STREET% | Улица. |
%HOUSE% | Дом. |
Объекты и группы объектов | Дата и время | Местоположение и геозоны | Пассажиры | Другие |
---|---|---|---|---|
%UNIT%, | %CURR_TIME%, | %LOCATION%, | %TAG_NAME%, | %SPEED%, |
Вопросы и ответы