电子邮件任务

概览

发送电子邮件任务（Email Sending Task） 可以在流程的执行过程中发送电子邮件。 使用该功能需要安装 电子邮件 扩展组件。

这是 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 bean 方法以表达式的形式提供，该方法返回以下类型之一：File、FileRef、byte[] 或 FileDescription。

附件名称是可选的。如果未提供名称，则默认从文件内容中派生名称。当使用 byte[] 作为文件内容时，默认命名规则为 attachment_<incremental_part>。