Призначення
Формує листи за даними таблиці або один підсумковий лист для всього набору. Підтримує адресатів, копії, приховані копії, форматований текст, таблицю входу та вкладення.
Входи та виходи
Отримувач із in і необов’язковими success/failure. Надсилання відбувається під час запису активного отримувача.
Параметри
| Параметр | Налаштування та значення | Варіанти й межі |
|---|---|---|
role | Роль блоку: джерело читає дані, отримувач записує результат. | Типово: target |
connection_id | Збережене підключення, через яке блок звертається до системи. | Типово: порожньоДо 64 символів |
to | Адреси основних отримувачів або шаблон за полем рядка. | Типово: порожньоДо 4000 символів |
cc | Адреси копії. | Типово: порожньоДо 4000 символів |
bcc | Адреси прихованої копії. | Типово: порожньоДо 4000 символів |
to_people | Користувачі та ролі UBC Data Bridge для основних отримувачів. | |
cc_people | Користувачі та ролі для копії. | |
bcc_people | Користувачі та ролі для прихованої копії. | |
subject | Однорядкова тема листа, підтримує теги. | Типово: порожньоДо 998 символів |
body | Текст листа, зокрема форматування й підстановка таблиці. | Типово: порожньоДо 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=Ваш звіт, body=Вітаємо, {{CustomerName}}. Сума: {{Amount}}. Це створить лист для кожного рядка. Для одного підсумку використайте сталу адресу й текст «Оброблено {{$rows}} рядків. {{$table}}».