Текстовые шаблоны
Текстовые шаблоны позволяют составить сообщение, или другой текст, используя подстановочные символы.
ЛЭРС использует язык шаблонов liquid. Краткую информацию о синтаксисе можно посмотреть на этом сайте.
Шаблоны liquid можно использовать для:
- Краткий и полный текст сообщения для диагностики пользовательской нештатной ситуации по точке и объекту учёта
- Текст уведомления о новой и обновлённой нештатной ситуации
При редактировании шаблона отображается подстановочных символов, которые могут быть использованы в тексте шаблона. Вставить подстановочный символ можно двойным щелчком мыши.
Фильтры
В системе присутствуют дополнительные фильтры, которые позволяют форматировать различные значения, специфические для ЛЭРС УЧЁТ.
Примечание
Имя параметра можно посмотреть в таблице "Справочники → Параметры данных" в колонке "Имя".
param_value
Принимает запись с архивными данными и возвращает значение параметра по его имени.
Пример:
{{ Data.Consumption | param_value: 'T_in' }}
param_unit
Принимает запись с архивными данными и возвращает системную единицу измерения параметра по его имени
Пример:
{{ Data.Consumption | param_unit: 'T_in' }}
format_date
Форматирует дату и время в указанный вид.
Пример:
{{ Data.DateTime | format_date: "d" }}
Здесь "d"
— это строка, которая задаёт формат вывода даты. Описание этих строк смотрите здесь.
Примеры
Уведомление о новой или повторной нештатной ситуации
С помощью такого шаблона для сообщений о нештатных ситуациях по текущим данным выводить не диапазон дат, а конкретную дату:
Шаблон уведомления о первичном возникновении НС
{{EntityTitle}} ({{NodeAddress}}): {{Description}}. Возникла {% if DataType == 'Current' %}{{PeriodStart}} {% else %} между {{PeriodStart}} и {{PeriodEnd}}{% endif %}
Шаблон уведомления о повторном возникновении НС
{{EntityTitle}} ({{NodeAddress}}): {{Description}}. Повторно возникла {% if DataType == 'Current' %}{{PeriodStart}} {% else %} между {{PeriodStart}} и {{PeriodEnd}}{% endif %}
Использование захваченных значений из формул пользовательской диагностики
В формулах пользовательской диагностики по точкам и объектам учёта можно использовать захват значений, чтобы затем вывести их в шаблонах сообщений.
Например, ваша формула для диагностики выглядит следующим образом:
[ГВС.Т1] * 2 < [ГВС.T2] + 50
И вы хотите в сообщении о нештатной ситуации вывести что-то вроде "Параметр T1 (50 градусов) стал меньше T2 (150 градусов)".
Для этого вам потребуется захватить два рассчитанных значения и подставить их в шаблон. Это можно сделать с помощью функции Capture
, которая сохраняет переданное значение с указанным именем и сразу же его возвращает без дополнительных преобразований.
Измените вашу формулу следующим образом:
Capture('t1', [ГВС.Т1] * 2) < Capture('t2', [ГВС.T2] + 50)
Теперь ЛЭРС сохранит результаты расчёта в переменных t1 = [ГВС.Т1] * 2
и t2 = [ГВС.T2] + 50
.
Теперь вы можете составить шаблон сообщения о нештатной ситуации следующим образом
Параметр T1 ({{ Captures['t1'] }} градусов) стал меньше T2 ({{ Captures['t2'] }} градусов )