Шаблоны писем

Шаблон письма включает в себя набор конструкций языка шаблонов Handlebars. На основании шаблона письма формируется текст электронного письма о произошедшем событии в Системе.

Шаблоны находятся в разделе «Шаблоны писем» на вкладке «Уведомления» Конфигуратора системы.

Как создать шаблон письма

Нажмите над таблицей, чтобы создать новый шаблон. Заполните настройки шаблона:

• Наименование. Наименование шаблона.

• Тема. Тема шаблона.

• Тип события. Тип события для шаблона: создание, удаление, изменение.

• Сделать шаблоном по умолчанию данного типа. Признак, указывающий, что данные шаблона можно предлагать к использованию по умолчанию.

• Текст шаблона. Форматируемый текст для отправки на электронную почту. (См. Правила создания текста шаблона и Как добавить к тексту изображение)

• Дата создания.

• Дата последнего редактирования.

Правила создания текста шаблона

Чтобы составить текст для шаблона, нужно знать стандартные операторы движка Handlebars. Их можно найти в официальной документации (ссылка на раздел).

Чаще всего используются следующие операторы:

• FullName – полное наименование объекта. Примеры использования:

{{FullName}}.

• User – пользователь(субъект), которым были внесены изменения. Примеры использования:

{{User}}.

• Link – ссылка на карточку объекта. Оператор нельзя использовать для типа события «Удаление». Примеры использования:

<a href="{{Link}}" target="_blank">Ссылка на объект</a>

• Changes – изменения объекта за промежуток времени.

  • FullName – полное наименование объекта на момент изменения.

  • User – пользователь, выполнивший операцию изменения.

  • Alias – тип объекта.

  • Operation – тип операции изменения: создание, изменение, удаление.

  • Date – дата выполнения операции.

  • Fields – справочник измененных полей.

Оператор Changes не используется для типа события «Удаление». Примеры использования:

{{#each Changes}}
   {{#if (compare this.Alias == "geo")}}
       {{#if (compare this.Operation == "Создание")}}
           <li>Геоданные добавлены</li>
       {{else if (compare this.Operation == "Изменение")}}
           <li>Геоданные изменены</li>
       {{else if (compare this.Operation == "Удаление")}}
           <li>Геоданные удалены</li>
       {{/if}}
   {{else}}
       {{#each this.Fields}}
           <li>{{this.description}}<br>Старое значение: {{this.old}}<br>Новое значение: {{this.new}}</li>
       {{/each}}
   {{/if}}
{{/each}}``

• {{[datetime] token «format»}} – вывод даты/времени в необходимом формате.

  • token – поле типа дата/время для обращения в шаблоне.

  • format – формат, в котором будет выведена данная дата/время.

Примеры использования:

{{[datetime] Service.DateUpdate "dd.MM.yyyy HH:mm:ss"}}

• {{[current-datetime] «format»}} - вывод текущей даты/времени в необходимом формате. Текущая дата – дата на момент формирования шаблона.

  • format - Формат, в котором будет выведена данная дата/время.

Примеры использования:

{{[current-datetime] "dd.MM.yyyy HH:mm:ss"}}

• {{compare obj1 operator obj2}} – сравнивает значения obj1 и obj2.

  • operator - Оператор сравнения:

    • «==» – равно;

    • «!=» – не равно

    • «>»» – больше

    • «>=» – больше или равно

    • «<» – меньше

    • «<=» – меньше или равно

Примеры использования:

{{#if (compare new "<" old)}}<p>new</p>{{else}}<p>old</p>{{/if}}

• {{and condition1 condition2 … conditionN}} – логическая операция «И», принимает на вход от 2-х аргументов.

Примеры использования:

{{#if (and (compare new ">" 5) (compare new "<" 7))}}<p>new равно 6</p>{{else}}<p>new не равно 6</p>{{/if}}

• {{or condition1 condition2 … conditionN}} – логическая операция «ИЛИ», принимает на вход от 2-х аргументов.

Примеры использования:

{{#if (or (compare Operation == "Создание") (compare Operation == "Изменение"))}}<p>Данные добавлены или изменены</p>{{else}}<p>Данные удалены</p>{{/if}}

• {{empty obj}} – проверка, что obj имеет значение null, или является пустой строкой, или строкой, состоящей только из пробелов.

Примеры использования:

{{#if (empty new)}}<p>Значение пустое или null</p>{{else}}<p>{{new}}</p>{{/if}};

{{#if (empty "  ")}}<p>Значение пустое или null</p>{{/if}}

Как добавить к тексту изображение

В шаблон можно добавить изображение. Для этого:

1. Раскройте пункт Добавить изображение и нажмите .

2. В открывшемся окне файлового менеджера выберите необходимое изображение.

После добавления отобразится виде тега в шаблоне и миниатюра изображения.

Чтобы удалить изображение, проставьте напротив изображения флажок и нажмите .

Как просмотреть/отредактировать/удалить шаблон письма

Чтоы просмотреть/отредактировать шаблон, нажмите в его строке . Измените его настройки и нажмите .

Удалить шаблон можно с помощью кнопки в конце строки с шаблоном.