Текст уведомления
Текст актуален лишь для некоторых действий по уведомлению: уведомление посредством SMS-сообщения или письмом на электронную почту, регистрация события в истории объекта и для всплывающего онлайн-уведомления.
Текст может быть любой длины и содержать любые символы, если Вы хотите его получить по e-mail. Если же Вы хотите получить его по SMS, то длинных сообщений писать не следует. Текст уведомления может содержать любые введенные вами фразы на любом языке. Кроме того, можно использовать параметры, зашифрованные специальными знаками, которые при отправке уведомления будут заменены реальными значениями.
Пример.
Текст «Объект '_UNIT_' нарушил ограничения по скорости и в '_POS_TIME_' двигался со скоростью _SPEED_ около '_LOCATION_'» может быть преобразован в «Объект 'Ровер119' нарушил ограничения по скорости и в '2000-01-01 12:01:37' двигался со скоростью 156 км/ч около 'Ленинградское шоссе'».
Единицы измерения (километры или мили), используемые для расшифровки параметров, зависят от настроек ресурса, к которому принадлежит уведомление. Формат даты и времени берется из настроек создателя данного ресурса.
Ниже приводится список всех универсальных параметров, которые применимы практически к любому типу уведомления:
| _UNIT_ | Имя объекта |
| _CURR_TIME_ | Текущие дата и время |
| _LOCATION_ | Местоположение объекта на момент срабатывания уведомления |
| _LAST_LOCATION_ | Последнее известное местоположение объекта (может быть полезно, если в сработавшем сообщении нет позиционных данных) |
| _ZONE_MIN_ | Наименьшая из геозон, в которых находился объект на момент уведомления |
| _ZONES_ALL_ | Все геозоны, в которых находился объект в момент срабатывания уведомления |
| _SPEED_ | Скорость движения объекта (не используется для сливов и заправок) |
| _POS_TIME_ | Дата и время последнего сообщения с позицией |
| _MSG_TIME_ | Дата и время сообщения, которое сработало |
| _DRIVER_ | Имя водителя (отображается только если водитель принадлежит тому же ресурсу, что и уведомление) |
| _TRAILER_ | Имя прицепа (отображается только если прицеп принадлежит тому же ресурсу, что и уведомление) |
| _ALL_SENSORS_ | Все датчики и их значения (не используется для сливов и заправок; также не обрабатывает датчики с текстовыми параметрами) |
| _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_ | Имя сработавшей геозоны (для уведомления по геозонам) |
| _SENSOR_NAME_ | Название сработавшего датчика (для контроля значения датчика в различных типах уведомлений) |
| _SENSOR_VALUE_ | Значение сработавшего датчика (для контроля значения датчика в различных типах уведомлений) |
| _TRIGGERED_SENSORS_ | Все сработавшие датчики и их значения (для контроля значения датчика в различных типах уведомлений) |
| _LOSE_RESTORE_ | Потеря связи/Восстановление связи (для уведомления о потере связи) |
| _SERVICE_NAME_ | Имя интервала техобслуживания |
| _SERVICE_TERM_ | Состояние интервала техобслуживания — сколько осталось или просрочено |
| _PARAM_NAME_ | Имя параметра (для уведомления по контролю параметра в сообщении) |
| _PARAM_VALUE_ | Значение параметра (для уведомления по контролю параметра в сообщении) |
| _SMS_TEXT_ | Текст SMS-сообщения (для уведомления по контролю SMS) |
| _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_ | Дом |
Обратите внимание, что данные параметры должны с двух сторон окружаться знаком процента. В противном случае они так и останутся текстом и не будут заменены на конкретные значения.
|
