Назначение
Создаёт письма из табличных данных или одно сводное письмо для всего набора. Поддерживает получателей, копии, скрытые копии, форматированный текст, входную таблицу и вложения.
Входы и выходы
Получатель со входом in и необязательными выходами success/failure. Отправка выполняется во время записи активного получателя.
Параметры
| Параметр | Настройки и значения | Варианты и ограничения |
|---|---|---|
role | Роль блока: источник читает данные; получатель записывает результат. | По умолчанию: target |
connection_id | Сохранённое подключение, через которое блок обращается к системе. | По умолчанию: emptyДо 64 символов |
to | Адреса основных получателей или шаблон с полем строки. | По умолчанию: emptyДо 4000 символов |
cc | Адреса копии. | По умолчанию: emptyДо 4000 символов |
bcc | Адреса скрытой копии. | По умолчанию: emptyДо 4000 символов |
to_people | Пользователи и роли UBC Data Bridge для основных получателей. | |
cc_people | Пользователи и роли для копии. | |
bcc_people | Пользователи и роли для скрытой копии. | |
subject | Однострочная тема письма; поддерживает теги. | По умолчанию: emptyДо 998 символов |
body | Тело письма, включая форматирование и подстановку таблицы. | По умолчанию: emptyДо 100000 символов |
format | text или html; новый блок редактора использует форматированный текст. | Варианты: text, htmlПо умолчанию: text |
attachments | Вложения из Менеджера файлов, папки или поля «Прикреплённый файл» параметров запуска. | Количество: 0–20 |
time_zone | Часовой пояс для системных подстановок даты и времени. | По умолчанию: Europe/KyivДо 64 символов |
Шаблоны и количество сообщений
Подстановка {{Назва поля}} использует значение текущей строки. Системные теги: {{$date}}, {{$time}}, {{$datetime}}, {{$flow}}, {{$rows}}, {{$row}}, {{$table}}.
- Если любой шаблон получателя, темы или тела содержит поле строки или {{$row}}, для каждой строки создаётся отдельное письмо. Иначе создаётся одно письмо для всего входа.
- {{$table}} доступен только в теле сообщения. Он включает до 1000 строк и указание оставшихся.
- Все поля тегов должны существовать во входе; TEMPLATE_FIELD_MISSING определяется при подготовке.
- Даты и время используют заданный time_zone. Значения данных экранируются для форматированных сообщений.
Пошаговая настройка
- Создайте и проверьте подключение SMTP. Добавьте использующий его блок.
- Задайте получателей адресами, тегом поля или пользователями и ролями.
- Напишите тему и тело; вставляйте теги из списка доступных полей.
- Проверьте подсказку: будет одно письмо для набора или по одному на строку.
- Добавьте вложения и часовой пояс. До отправки проверьте подготовку в симуляции.
Правила и диагностика
- Адреса пользователей и участников ролей читаются из актуальных профилей во время запуска.
- Тема не может содержать переносы строк; имена тегов проверяются.
- До 20 источников вложений; один источник нельзя добавить дважды. Вложение из поля параметра отсутствует, если пользователь не добавил файл.
- Папка Менеджера файлов добавляет содержащиеся в ней на момент запуска файлы.
- Внешняя доставка может иметь частичный или неопределённый результат. Перед повторным запуском после ошибки проверьте журнал, чтобы избежать повторных писем.
- Пустой активный вход не создаёт сообщение: EMPTY_STAGE. Допускается до 10000 сообщений на блок за запуск; для большего количества отфильтруйте или разделите набор.
- Потеря ответа при внешней отправке считается неопределённым результатом: система не отправляет это сообщение повторно автоматически.
- Разделяйте адреса запятыми, точками с запятой или переносами строк. Нужны хотя бы один получатель и непустая тема; суммарно до 500 получателей на письмо. Повторы между «Кому», «Копия» и «Скрытая копия» удаляются.
- Вложение папки добавляет до 100 файлов. Общий размер письма с вложениями ограничивается настройкой подключения SMTP.
Пример настройки
Для таблицы CustomerEmail, CustomerName, Amount задайте to={{CustomerEmail}}, subject=Your report, body=Hello, {{CustomerName}}. Amount: {{Amount}}. Это создаёт письмо для каждой строки. Для одного сводного письма используйте фиксированный адрес и тело «Обработано {{$rows}} строк. {{$table}}».