Перейти к основному содержимому

Шаблон сообщения

Перейдите на вкладку «Шаблон сообщения» и настройте предупреждение, которое будет появляться в программе и/или отсылаться выбранным пользователям при выполнении правила мониторинга:

Настройка шаблона сообщений
  • Введите тему сообщения. Тема отображается в заголовке всплывающего окна оповещения и подставляется в поле темы при отправке сообщения пользователям (например, в поле темы e-mail). Если тема не задана, то по умолчанию в поле темы при отправке электронной почты подставляется название правила.
  • Введите текст сообщения. В тексте сообщения могут содержаться различные переменные, табличные параметры и свойства объектов мониторинга.
    • Доступные переменные приведены в списке «Переменные». При отправке сообщения переменные в тексте заменяются соответствующими значениями (например, переменная {device.name} заменяется именем объекта, для которого было выполнено правило). Левый клик на переменной или ее описании вставляет эту переменную в текст оповещения.
      Доступные переменные.

      {address} — адрес объекта мониторинга из адресной базы по текущему местоположению.

      {config.parameter} — имя параметра, которое проверялось правилом.

      {config.parameter-name} — описание параметра, которое проверялось правилом.

      {config.value} — пороговое значение, заданное в настройках правила.

      {config.value-to} — верхнее значение порога (если задан диапазон).

      {date} — дата события (локальная).

      {date-utc(N)} — дата события (UTC) + N часов.

      {date-utc} — дата события (UTC).

      {device.group} — название группы объектов мониторинга.

      {device.group-id} — уникальный идентификатор группы объектов мониторинга (GUID).

      {device.group-path} — путь к объекту мониторинга в структуре схемы.

      {device.id} — уникальный идентификатор объекта мониторинга (GUID).

      {device.name} — название объекта мониторинга.

      {duration} — продолжительность события.

      {duration-seconds} — продолжительность события в секундах.

      {event.MaxSpeed} — максимальная скорость объекта мониторинга за событие.

      {event.MinSpeed} — минимальная скорость объекта мониторинга за событие.

      {event.type} — стадия события (начало, конец).

      {final.PARAMNAME} — значение финального параметра PARAMNAME.

      {lat} — широта (координата события).

      {lng} — долгота (координата события).

      {property.PROPNAME} — значение свойства PROPNAME из реестра (например, VehicleRegNumber).

      {serial} — UID устройства мониторинга.

      {serial-name} — UID устройства мониторинга, дополненный (слева) нулями до семи знаков.

      {time} — время события (локальное).

      {time-utc(N)} — время события (UTC) + N часов.

      {time-utc} — время события (UTC).

      {value} — текущее значение параметра (значение в текущей точке события).

      {value-prev} — предыдущее значение параметра (значение в точке, которая предшествует точке события).

      {values.PARAMNAME.property1} — значение свойства property1 элемента, идентификатор которого содержится в текущем значении табличного параметра PARAMNAME.

      {values.PARAMNAME} — текущее значение табличного параметра PARAMNAME.

      {values-prev.PARAMNAME.property1} — значение свойства property1 элемента, идентификатор которого содержится в предыдущем значении табличного параметра PARAMNAME.

      {values-prev.PARAMNAME} — предыдущее значение табличного параметра PARAMNAME.

      к сведению

      Информация о продолжительности события (через переменные {duration} и {duration-seconds}), а также значения, выдаваемые переменными {event.MaxSpeed}, {event.MinSpeed}, будут отображаться только в тех случаях, когда правило настроено на срабатывание в конце события (см. пункт «Настройки правила»).

    • Доступные параметры объекта/группы приведены в списке «Параметры (табличные)». Левый клик на параметре или его описании вставляет этот параметр в текст оповещения.
    • Свойства, которые могут быть вставлены в сообщение, приведены в списке «Свойства». Данный список содержит все свойства, добавленные в реестр свойств выбранного объекта мониторинга или группы объектов, кроме свойств с типами «Цвет» и «Тар. таблица». Левый клик на строке свойства вставляет это свойство в текст оповещения. Кроме того программа позволяет использовать свойства других объектов: геозон, водителей и т. д. Например, выражение {values.GeoFence1.Square} позволяет получить значение площади текущей геозоны (из параметра GeoFence1). Все методы для считывания свойств из реестров перечисленных объектов приведены в списке «Переменные».
  • Вместо ввода текста можно воспользоваться готовыми пользовательскими шаблонами сообщений. Доступные шаблоны отображаются слева от поля для ввода текста. Выберите язык шаблона и текст уведомления для выбранного языка. Предусмотрен также вариант «По умолчанию», который используется всегда, если не выбран язык уведомления. Пользовательские шаблоны должны быть добавлены в папку \App_Data\Templates.MRules на web‑сервере.

Синтаксис шаблона

Шаблон должен быть сформирован в формате HTML:

  • Тема сообщения выделяется тегом <subject>.
  • Текст сообщения выделяется тегом <body>. Текст может содержать переменные, параметры и свойства из списка поддерживаемых.

На рисунках ниже приведены примеры содержимого файла и текста сообщения по этому шаблону.

Пример содержимого файла шаблона
Пример использования шаблона