Flowable-服务-邮件任务

✨✨✨ 最好用的Flowable流程设计器

---

定义

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>&lt;html&gt;&lt;body&gt;&lt;p&gt;${user}发起退款${money}&lt;/p&gt;&lt;/body&gt;&lt;/html&gt;</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

界面操作

视频地址：

邮件任务

演示demo

邮件任务

本文中内容和案例出自贺波老师的书《深入Activiti流程引擎：核心原理与高阶实战》，书中的介绍更全面、详细，推荐给大家。
深入Activiti流程引擎