View Source

Где хранятся шаблоны

Шаблоны оповещений — отчёты Telerik Reporting (файлы .trdp) в списке «Шаблоны оповещений» пространства «Центр администрирования». Шаблон выбирается в действии «Отправить оповещение».

Преднастроенные шаблоны:

DocumentApproval.trdp — оповещение о рабочем процессе;
SimpleTask.trdp — оповещение о задаче/замечании.

Изменение шаблона

Скачать нужный шаблон.
Отредактировать в Telerik Report Designer версии не ниже R1 2020 (подробнее о работе с Telerik Report Designer).
Важно:
- параметры отчёта изменять нельзя (либо перед загрузкой на портал их нужно вернуть к исходным значениям);
- строки подключения источников данных перед загрузкой должны быть пустыми — при формировании письма система подставляет строку подключения к базе портала.
Загрузить отредактированный шаблон с тем же именем в тот же список.

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

Как формируется письмо

Элемент письма	Источник
Параметры отчёта	`id` — идентификатор элемента, на котором выполнено действие; `actionId` — идентификатор действия автоматизации; `hostUrl` — адрес портала (для формирования ссылок); `toEmailList` — список адресатов.
Тема письма	Текст элемента отчёта с CSS-классом `repotTitle` (именно в таком написании). Элемент удаляется из тела письма.
Тело письма	HTML, сформированный отчётом (формат HTML5), с постобработкой: удаляются пустые блоки, добавляются стили фона и «листа», элемент с классом `footerTitle` переносится в конец письма.
Логотип	Если в отчёте есть блок с классом `footerLogo`, содержащий ссылку, в ссылку встраивается логотип системы; блок переносится в конец письма.
Получатели	Результат формулы «Получатели» действия; каждому адресату отправляется отдельное письмо.

Настройка почтового сервера

Параметры SMTP задаются в файле конфигурации mail.json модуля Mail:

Параметр	Описание
`Host`	Адрес SMTP-сервера. Если файл отсутствует или параметр пуст, письма не отправляются (без ошибки).
`Port`	Порт; по умолчанию 25.
`Login`, `Password`	Учётные данные; если не заданы, аутентификация не выполняется.
`FromAddress`, `FromName`	Адрес и имя отправителя.
`SecureSocketOptions`	Режим шифрования (значения MailKit: None, Auto, SslOnConnect, StartTls, StartTlsWhenAvailable). Если не задан — без шифрования; нераспознанное значение — Auto.

{
  "Host": "smtp.example.ru",
  "Port": 587,
  "Login": "portal@example.ru",
  "Password": "********",
  "FromAddress": "portal@example.ru",
  "FromName": "Портал VITRO-CAD",
  "SecureSocketOptions": "StartTls"
}

Настройка отправки по событию

На Канбан-доске жизненного цикла нужного типа элемента создайте правило с типом действия «Отправить оповещение». Пример для оповещения по процессу:

Vitro-CAD MP - Документация > Настройка шаблонов оповещений > image-2025-2-21_11-47-52.png

Формула «Получатели» должна возвращать адреса электронной почты, например Select(This('Наблюдатели', true), 'Field(\"Почта\")'). Подробнее — Отправить оповещение.