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