目录
- 引言
- 1. 指定具体用户
- 1.1 重新指定任务处理人
- 1.2 自己处理
- 2. 通过变量设置
- 3. 通过监听器设置
- 4. 其他情况
引言
@[toc] 上篇文章松哥和大家分享了 Flowable 中的 ReceiveTask，这只是流程中任务的一种，今天我们就一起来看另外一个更为常见的 Task--UserTask。
UserTask 看名字就知道，需要人工干预，而人工处理的方式有很多种，我们可以设置节点是由哪个用户处理，也可以设置是由哪个用户组来处理（相当于是由哪个角色来处理），今天这篇文章我主要和大家分享设置用户的三种方式，至于如何设置用户组，这个咱们下篇文章再聊。
现在，假设我有如下一个简单的流程图：
那么我该如何设置这个用户节点的处理人呢？
1. 指定具体用户
第一种方式，是我们在绘制流程图的时候，可以选中这个节点，然后直接设置流程的处理人，像下面这样：
然后在打开的窗口中选择固定值，设置具体分配的用户是 javaboy，如下图：
好了，现在这个节点就固定的由一个名为 javaboy 的用户去处理了。
对应的 XML 文件如下：
<process id="demo01" name="demo01" isExecutable="true">
<documentation>demo01</documentation>
<startEvent id="startEvent1" flowable:formFieldValidation="true"></startEvent>
<userTask id="sid-5F901234-AFF1-480E-9D66-2D196B910BA3" flowable:assignee="javaboy" flowable:formFieldValidation="true">
<extensionElements>
<modeler:initiator-can-complete xmlns:modeler="http://flowable.org/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
</extensionElements>
</userTask>
<sequenceFlow id="sid-71FB3A81-F753-419D-9A0A-2FC6E5361CED" sourceRef="startEvent1" targetRef="sid-5F901234-AFF1-480E-9D66-2D196B910BA3"></sequenceFlow>
<endEvent id="sid-D0B9E5BF-8C1A-4F8F-B2C2-F423F5DC556D"></endEvent>
<sequenceFlow id="sid-DEBE03CD-F247-4EF3-BB67-ABBA94739B0A" sourceRef="sid-5F901234-AFF1-480E-9D66-2D196B910BA3" targetRef="sid-D0B9E5BF-8C1A-4F8F-B2C2-F423F5DC556D"></sequenceFlow>
</process>
在上面这段 XML 中，小伙伴们看到 UserTask 节点中有一个 flowable:assignee="javaboy"，这句话就是设置这个 UserTask 的处理人。
接下来，我们部署并启动这个流程（具体的部署启动方式可以参考本系列之前的文章），启动之后，我们可以在数据库的 ACT_RU_TASK 表中看到，这个 UserTask 的处理人是 javaboy，如下图：
现在我们可以通过 Java 代码去查询 javaboy 需要处理的 UserTask 了，如下：
@Autowired
TaskService taskService;
@Test
void test11() {
List<Task> list = taskService.createTaskQuery().taskAssignee("javaboy").list();
for (Task task : list) {
logger.info("id:{},name:{}",task.getId(),task.getName());
}
}
这个查询，本质上其实就是去 ACT_RU_TASK 表中查询的，我们来看看执行的 SQL：
查询到这个任务之后，javaboy 有两种选择：
- 将这个任务指定给另外一个人，例如 zhangsan。
- 自己处理。
1.1 重新指定任务处理人
假设 javaboy 查询到自己的任务之后，想把这个任务交给 zhangsan 去处理，方式如下：
@Autowired
TaskService taskService;
@Test
void test11() {
List<Task> list = taskService.createTaskQuery().taskAssignee("javaboy").list();
for (Task task : list) {
taskService.setAssignee(task.getId(),"zhangsan");
}
}
这行代码执行完成后，我们看数据库中的 ACT_RU_TASK 表，还是刚才那条记录，但是处理人变了，变成了 zhangsan：
小伙伴们看到，版本号从 1 变为 2 了，说明这条记录被更新过了，处理人则从 javaboy 变为了 zhangsan。
最后我们再来看下这个操作所执行的 SQL，来验证一下我们前面的结论：
小伙伴们注意看这里执行的 SQL，以及对应的参数，说明我们上面的分析是没有问题的。
1.2 自己处理
如果 javaboy 想自己处理这个任务也是可以的，方式如下：
@Autowired
TaskService taskService;
@Test
void test11() {
List<Task> list = taskService.createTaskQuery().taskAssignee("javaboy").list();
for (Task task : list) {
taskService.complete(task.getId());
}
}
处理完成后，ACT_RU_TASK 表中的记录也会被自动删除掉（执行过的 UserTask 会被自动删除）。
这种方式是指定了具体的用户，很显然这种硬编码的方式使用起来很不方便，我们需要的是能够动态指定任务处理人的方式。
2. 通过变量设置
如果想动态指定 UserTask 的处理人，则可以通过变量来实现，具体方式如下：
在绘制流程图的时候，还是指定流程的具体处理人，但是在指定的时候，使用变量代替，如下图：
这里的 #{manager} 表示这个 UserTask 由一个名为 manager 的变量来指定，此时的 XML 文件则是下面这样：
<process id="demo01" name="demo01" isExecutable="true">
<documentation>demo01</documentation>
<startEvent id="startEvent1" flowable:formFieldValidation="true"></startEvent>
<userTask id="sid-5F901234-AFF1-480E-9D66-2D196B910BA3" flowable:assignee="#{manager}" flowable:formFieldValidation="true">
<extensionElements>
<modeler:initiator-can-complete xmlns:modeler="http://flowable.org/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
</extensionElements>
</userTask>
<sequenceFlow id="sid-71FB3A81-F753-419D-9A0A-2FC6E5361CED" sourceRef="startEvent1" targetRef="sid-5F901234-AFF1-480E-9D66-2D196B910BA3"></sequenceFlow>
<endEvent id="sid-D0B9E5BF-8C1A-4F8F-B2C2-F423F5DC556D"></endEvent>
<sequenceFlow id="sid-DEBE03CD-F247-4EF3-BB67-ABBA94739B0A" sourceRef="sid-5F901234-AFF1-480E-9D66-2D196B910BA3" targetRef="sid-D0B9E5BF-8C1A-4F8F-B2C2-F423F5DC556D"></sequenceFlow>
</process>
小伙伴们看到，UserTask 节点中的 flowable:assignee="#{manager}" 就表示这个 UserTask 的处理人由 manager 变量指定。
对于这样的流程，我们在上一个节点处就需要指定下一个节点的处理人，对于当前案例来说，当然是要在流程启动的时候，指定这个 UserTask 的处理人，方式如下：
@Test
void test01() {
Map<String, Object> variables = new HashMap<>();
variables.put("manager", "javaboy");
ProcessInstance pi = runtimeService.startProcessInstanceByKey("demo01",variables);
logger.info("id:{},activityId:{}", pi.getId(), pi.getActivityId());
}
当流程启动成功之后，大家去查看 ACT_RU_TASK 表，就可以看到，有一个待处理的 UserTask，处理人是 javaboy，如下图：
能看到这条记录，就说明这个 UserTask 的处理人我们已经设置成功了。
接下来具体的处理逻辑，则参考 1.1 和 1.2 小节。
3. 通过监听器设置
当然，我们也可以通过监听器来设置任务的处理人。具体方式如下：
首先我们在绘制流程图的时候，不需要给 UserTask 分配用户，如下图：
然后我们为这个 UserTask 设置一个任务监听器，步骤如下：
首先点击 + 号，然后选择 CREATE 事件，最后再给出事件对应的实体类，如下：
当然这个实体类是我们项目中真实存在的一个类，如下：
public class MyTaskListener implements TaskListener {
@Override
public void notify(DelegateTask delegateTask) {
delegateTask.setAssignee("javaboy");
}
}
当这个 UserTask 创建的时候，就会触发这个监听器，为该 UserTask 设置处理人。
我们来看看这个流程图对应的 XML 文件是什么样子的：
<process id="demo01" name="demo01" isExecutable="true">
<documentation>demo01</documentation>
<startEvent id="startEvent1" flowable:formFieldValidation="true"></startEvent>
<userTask id="sid-5F901234-AFF1-480E-9D66-2D196B910BA3" flowable:formFieldValidation="true">
<extensionElements>
<flowable:taskListener event="create" class="org.javaboy.flowableidm.MyTaskListener"></flowable:taskListener>
</extensionElements>
</userTask>
<sequenceFlow id="sid-71FB3A81-F753-419D-9A0A-2FC6E5361CED" sourceRef="startEvent1" targetRef="sid-5F901234-AFF1-480E-9D66-2D196B910BA3"></sequenceFlow>
<endEvent id="sid-D0B9E5BF-8C1A-4F8F-B2C2-F423F5DC556D"></endEvent>
<sequenceFlow id="sid-DEBE03CD-F247-4EF3-BB67-ABBA94739B0A" sourceRef="sid-5F901234-AFF1-480E-9D66-2D196B910BA3" targetRef="sid-D0B9E5BF-8C1A-4F8F-B2C2-F423F5DC556D"></sequenceFlow>
</process>
小伙伴们看到，event="create" class="org.javaboy.flowableidm.MyTaskListener" 就是我们设置的内容了。
现在我们部署并启动这个流程，当我们流程启动后，就可以在 ACT_RU_TASK 表中看到一条 javaboy 待处理的任务了。
4. 其他情况
最后再来说说一种特殊情况，就是这个 UserTask 由任务的发起人处理，任务是谁发起的，谁来处理人这个 UserTask。
这个首先需要在流程启动事件上设置任务的发起人变量名，如下，流程的启动节点，然后设置任务的发起人：
接下来，在给 UserTask 设置处理人的时候，设置处理人和任务的发起人的变量是同一个，如下图：
好啦，这就可以了。来看看对应的 XML 文件：
<process id="demo01" name="demo01" isExecutable="true">
<documentation>demo01</documentation>
<startEvent id="startEvent1" flowable:initiator="INITATOR" flowable:formFieldValidation="true"></startEvent>
<userTask id="sid-5F901234-AFF1-480E-9D66-2D196B910BA3" flowable:assignee="#{INITATOR}" flowable:formFieldValidation="true">
<extensionElements>
<modeler:initiator-can-complete xmlns:modeler="http://flowable.org/modeler"><![CDATA[false]]></modeler:initiator-can-complete>
</extensionElements>
</userTask>
<sequenceFlow id="sid-71FB3A81-F753-419D-9A0A-2FC6E5361CED" sourceRef="startEvent1" targetRef="sid-5F901234-AFF1-480E-9D66-2D196B910BA3"></sequenceFlow>
<endEvent id="sid-D0B9E5BF-8C1A-4F8F-B2C2-F423F5DC556D"></endEvent>
<sequenceFlow id="sid-DEBE03CD-F247-4EF3-BB67-ABBA94739B0A" sourceRef="sid-5F901234-AFF1-480E-9D66-2D196B910BA3" targetRef="sid-D0B9E5BF-8C1A-4F8F-B2C2-F423F5DC556D"></sequenceFlow>
</process>
startEvent 中有一个 flowable:initiator="INITATOR" 表示设置流程发起人的变量为 INITATOR。后续在 UserTask 中使用该变量即可。
将这个流程部署成功之后，按照如下方式启动流程：
@Test
void test01() {
Authentication.setAuthenticatedUserId("javaboy");
ProcessInstance pi = runtimeService.startProcessInstanceByKey("demo01");
logger.info("id:{},activityId:{}", pi.getId(), pi.getActivityId());
}
Authentication.setAuthenticatedUserId("javaboy"); 表示设置流程的发起人为 javaboy。
好啦，今天的文章就和小伙伴们介绍了如何给 UserTask 设置处理人，后面松哥再和大家分享如何给 UserTask 设置候选人和候选组，更多关于Flowable 设置任务处理人的资料请关注自由互联其它相关文章！