目录
- 定义
- 图形标记
- XML内容
- 邮件服务器配置
- 界面操作
定义
Flowable 支持通过自动的邮件服务任务(Email Task)增强业务流程,它可以向一个或多个收信人发送
邮件,支持 cc,bcc,HTML 内容等。
流程流转到邮件任务时,会给指定的人发送邮件。需要注意的是,邮件任务不是 BPMN 2.0 规范的
“官方”任务,所以也没有专用图标。在 Flowable 中,邮件任务是作为一种特殊的服务任务来实现的。
图形标记
在 Flowable 中邮件任务是在服务任务标签中加入一个type属性指定为邮件任务,BPMNJS的图形统一采用服务图标:
XML内容
邮件任务在 Flowable 中定义为一个专用的服务任务,这个服务任务的 type 属性设置为 mail。邮
件任务的 XML 表示格式如下
<serviceTask id="Activity_1rev938" name="邮件发送" flowable:type="mail">
<extensionElements>
<flowable:field name="to">
<flowable:expression>liuwenjun@163.com</flowable:expression>
</flowable:field>
<flowable:field name="subject">
<flowable:string>发送退款申请邮件</flowable:string>
</flowable:field>
<flowable:field name="html">
<flowable:expression><html><body><p>${user}发起退款${money}</p></body></html></flowable:expression>
</flowable:field>
<flowable:field name="charset">
<flowable:string>utf-8</flowable:string>
</flowable:field>
</extensionElements>
</serviceTask>
邮件任务可以通过属性注入的方式配置各种属性,这些属性的值可以使用 EL 表达式,并将在流程执
行时进行解析。邮件任务可以配置如表所示的属性:
属性 | 是否必须 | 描述 |
---|---|---|
to | 是 | 邮件接收者的邮箱地址。可以使用逗号分隔多个接收者邮箱地址 |
from | 否 | 邮件发送人的邮箱地址。如果不提供,会使用默认配置的地址(默认地址配置见下文介绍) |
subject | 否 | 邮件的主题 |
cc | 否 | 邮件抄送人的邮箱地址。可以使用逗号分隔多个抄送人邮箱地址 |
bcc | 否 | 邮件密送人的邮箱地址。可以使用逗号分隔多个密送人邮箱地址 |
charset | 否 | 用于指定邮件的字符集,对很多非英语语言是必须设置的 |
html | 否 | 邮件的 HTML 文本 |
text | 否 | 邮件的内容,用于纯文本邮件。对于不支持富文本内容的客户端,可以与 html 一起使用,邮件客户端可以降级为显式纯文本格式 |
htmlVar | 否 | 存储邮件 HTML 内容的流程变量名。与 html 属性的不同之处在于,这个属性会在邮件任务发送前,使用其内容进行表达式替换 |
textVar | 否 | 存储邮件纯文本内容的流程变量名。与 text 属性的不同之处在于,这个属性会在邮件任务发送前,使用其内容进行表达式替换。 |
ignoreException | 否 | 当处理邮件失败时,是忽略还是抛出 ActivitiException。默认值为 false |
exceptionVariableName | 否 | 如果设置 ignoreException = true,而处理邮件失败时,则使用此属性指定名字的变量保存失败信息 |
邮件服务器配置
为了使用邮件任务发送邮件,需要事先为 Flowable 配置支持 SMTP 功能的外部邮件服务器,可以在flowable配置文件中配置如表所示的属性
#配置发送邮箱地址
flowable.mail.server.default-from=xxxx@qq.com
#配置smtp
flowable.mail.server.host=smtp.qq.com
#用户名
flowable.mail.server.username=xxxx
#密码
flowable.mail.server.password=xxxx
#端口
flowable.mail.server.s-s-l-port=465
#是否是SSL
flowable.mail.server.use-ssl=true
#是否是TLS
flowable.mail.server.use-tls=false
界面操作
视频地址:
邮件任务