Flowable 设置任务处理人的四种方式

@[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 设置任务处理人的四种方式

1. 指定具体用户

1.1 重新指定任务处理人

1.2 自己处理

2. 通过变量设置

3. 通过监听器设置

4. 其他情况

江南一点雨

引用和评论

SpringBoot 3.3.5 试用CRaC，启动速度提升3到10倍

在Java程序中监听mysql的binlog

Jerry和您聊聊Chrome开发者工具

Bitmap 和布隆过滤器傻傻分不清？你这不应该啊

Spring和idea为什么不推荐使用@Autowired注入

Just for fun——迅速写完快速排序

Spring 实现 3 种异步流式接口，干掉接口超时烦恼

Flowable 设置任务处理人的四种方式

1. 指定具体用户

1.1 重新指定任务处理人

1.2 自己处理

2. 通过变量设置

3. 通过监听器设置

4. 其他情况

江南一点雨

引用和评论

SpringBoot 3.3.5 试用CRaC，启动速度提升3到10倍

在Java程序中监听mysql的binlog

Jerry和您聊聊Chrome开发者工具

Bitmap 和 布隆过滤器傻傻分不清？你这不应该啊

Spring和idea为什么不推荐使用@Autowired注入

Just for fun——迅速写完快速排序

Spring 实现 3 种异步流式接口，干掉接口超时烦恼

Bitmap 和布隆过滤器傻傻分不清？你这不应该啊