Назначение
Отправляет оповещение по электронной почте, сформированное по шаблону Telerik Reporting из списка «Шаблоны оповещений».
Сведения о типе действия
| Параметр | Значение |
|---|---|
| Название в портале | Отправить оповещение |
| Activity в Elsa (обработчик) | Отправить оповещение (SendMailActivity) |
| ID типа элемента действия | 59345258-ce20-4150-b904-46a10f1f57bd |
| Проверка условий правила | Да |
| Поддержка «Исходный элемент(ы) (формула)» | Да |
Атрибуты действия
| Атрибут | Обязательный | Описание | Пример |
|---|---|---|---|
| Название | Да | Текст. Название действия. | Отправить оповещение (Наблюдатели) |
| Получатели | Да | Формула, возвращающая адрес электронной почты (строку) или список адресов. Вычисляется в контексте целевого элемента. | Select(This('Наблюдатели', true), 'Field(\"Почта\")') |
| Шаблон оповещения | Да | Выбор шаблона из списка «Шаблоны оповещений». См. Настройка шаблонов оповещений . | DocumentApproval.trdp |
Получатели — это адреса
Формула «Получатели» должна возвращать именно адреса (строки), а не пользователей. Для атрибута-подстановки на пользователей получайте почту через Select(..., 'Field(\"Почта\")'). Возврат объектов-пользователей приведёт к ошибке выполнения действия.
Как работает
- Проверяются условия правила; определяются целевые элементы.
- Вычисляется список адресов (повторы удаляются). Если список пуст — письмо не отправляется.
- Движок вызывает API модуля Mail (
POST mail/api/mail/send/{ID шаблона}) с параметрами:id— ID элемента,actionId— ID действия,hostUrl— адрес портала,toEmailList— адреса. - Модуль Mail формирует HTML по шаблону (параметры передаются в отчёт), берёт тему письма из заголовка отчёта и отправляет письмо каждому адресату отдельно.
Примеры получателей
| Кому | Формула |
|---|---|
| Наблюдателям процесса | Select(This('Наблюдатели', true), 'Field(\"Почта\")') |
| Инициатору | This('Инициатор.Почта') |
| Фиксированный адрес | "pto@example.ru" |
Особенности
- Если модуль Mail не настроен (нет файла
mail.jsonили не задан SMTP-сервер), письма не отправляются, ошибки не возникает. - Ошибка формирования шаблона или отправки прерывает цепочку.
- Преднастроенные шаблоны: DocumentApproval.trdp — оповещение по рабочему процессу, SimpleTask.trdp — по задаче/замечанию.