Задача отправки электронной почты

Обзор

Задача отправки электронной почты позволяет отправлять электронные письма во время выполнения процесса. Для успешной отправки должно быть установлено дополнение Email.

Это собственная задача Jmix, а не стандартная задача BPMN.

Графическая нотация

Задача изображается как прямоугольник со скругленными углами и небольшим значком конверта в левом верхнем углу. Значок закрашен, что обозначает семантику отправки.

email task

Свойства

В моделере BPMN можно задать следующие свойства задачи отправки электронной почты:

email task properties

Свойство

Описание

Id

Идентификатор элемента. Он генерируется автоматически, но его можно заменить на более понятный, чтобы логи было проще читать.

Name

Имя задачи, не более 255 символов. Обычно задачи называют по схеме «глагол + объект», например «Согласовать заказ» или «Отправить счет».

To, Cc, Bcc, From

Адреса получателей и отправителя. См. Задание адресов.

Subject, Content

Тема и текст письма. См. Задание адресов.

Send asynchronously

Отправляется ли письмо асинхронно дополнением Email. См. Асинхронная отправка.

Attachments

См. Вложения.

Execution listeners

См. Слушатели выполнения.

Asynchronous execution

  • Asynchronous

  • Exclusive

  • Asynchronous leave

  • Asynchronous leave exclusive

Обновлено в Jmix 3.1

Documentation

Описание и дополнительные сведения об элементе.

У задачи отправки электронной почты нет свойств множественного экземпляра. Но ее можно использовать внутри встроенного подпроцесса, который выполняется как множественный экземпляр. См. раздел Множественный экземпляр.

Параметры письма

У задачи есть общие параметры отправки писем: получатель, отправитель, тема и т. д.

Задание адресов

  • Адреса получателей

    • To — адреса основных получателей. Адрес можно задать переменной процесса или выражением либо ввести напрямую. Допускается несколько адресов.

    • Cc — получатели копии. Можно использовать переменную процесса или ввести адреса напрямую. Допускается несколько адресов.

    • Bcc — получатели скрытой копии. Можно использовать переменную процесса или ввести адреса напрямую. Допускается несколько адресов.

  • From — адрес отправителя, поэтому допускается только одно значение. Это поле можно задать значением или выражением.

  • Subject — тема письма. Для динамических значений поддерживаются переменные процесса.

  • Content — текст письма. В редакторе можно выбрать тип содержимого: HTML или обычный текст. Для динамического формирования содержимого здесь также можно использовать переменные процесса.

Асинхронная отправка

По умолчанию письма отправляются асинхронно. Это можно изменить флажком Send asynchronously.

Вложения

Чтобы приложить файлы, используйте раздел Attachments. Содержимое нужно передать выражением через переменную процесса или вызовом метода бина Spring, который возвращает один из типов: File, FileRef, byte[] или FileDescription.

Имя вложения указывать необязательно. Если имя не задано, используется имя, полученное из содержимого файла. Если содержимое файла передается как byte[], имя по умолчанию строится по шаблону attachment_<incremental_part>.