camunda_18_user_task_assignment

Camunda 后台数据库内建有几个人员/组织数据表, 但在User task assignment方便, 并不强制我们要将自己的人员/组织数据导入到这些table中. 举例讲, 我们需要将某个user task指派给 demo123 这个用户, 直接在该user task设定 assignee 为 demo123 即可, 就这么简单.

指定 Assignment 的几种形式:

• Assignee: 直接指派到人.
• Candidate Users, 指派多个人, 按逗号分隔.
• Candidate Groups, 指派到多个组, 按逗号分隔.
  说明: 在TaskList应用中, 对于后两种形式的指派, 操作人员在执行user task之前, 还需要先做任务认领, 谁认领任务, 谁就获得执行权.
  但如果是自己的流程引擎的应用, 其实可以设计认领过程, 也可以省略认领步骤.

Assignment 的设定时机

• 流程设计时设定. 在流程设计时即使用固定值指定任务执行人, 比如设定 demo123.
• 流程启动时设定. Assignee/CandidateUsers/CandidateGroups, 都支持表达式设定, 我们可以在流程设计时, 指定user task的执行人为 ${user} , 在流程启动时间, 设定这些流程变量, 即完成人员指派.
• 流程流转过程中设定. 流程设计时通过变量设定执行人, 然后在流程流转时, 在前置节点代码指定后续节点的执行人, 或者在本user task的 executionListener的 start 事件或 taskListener 的 create 事件中动态设定执行人. 下图executionListener 和 taskListener 常用event的执行顺序图:

通过create TaskListener 指派人员的示例代码

public class MyUserTaskListener implements TaskListener {

  @Override
  public void notify(DelegateTask delegateTask) {
    if (delegateTask.getEventName().equals("create")) {
      //直接指派人
      delegateTask.setAssignee("demo123");
      //或者, 设定流程变量userId
      delegateTask.setVariable("userId","demo123");
    }
  }
}

User task 任务处理

SpringBoot 的引擎项目, DI 容器可以直接注入 TaskService 实例, 然后就可以按照process 和当前用户UserId/group 遍历到要 todo 清单, 进而完成业务处理.
下面是一个简单的代码示例:

@SpringBootApplication
@EnableProcessApplication
public class WebappExampleProcessApplication {
  @Autowired
  TaskService taskService;

  public static void main(String... args) {
    SpringApplication.run(WebappExampleProcessApplication.class, args);
  }

  public void doTask() {
    List<Task> tasks = null;
    tasks = taskService.createTaskQuery().taskAssignee("demo123").processInstanceBusinessKey("procKey").list();
    tasks = taskService.createTaskQuery().taskCandidateUser("demo123").processInstanceBusinessKey("procKey").includeAssignedTasks().list();
    tasks = taskService.createTaskQuery().taskCandidateGroup("Group1").processInstanceBusinessKey("procKey").includeAssignedTasks().list();
    if (tasks != null && tasks.size() > 0) {
            Task task= tasks.get(0) ;
      String taskId = task.getId();

      // 业务处理代码省略

      
      // 如果原来分配到group或candidateUsers, 可设定具体执行人
      taskService.setAssignee(taskId, "demo123");

      // 提交task
      taskService.complete(taskId);
      taskService.handleBpmnError(taskId, "some error"); // 抛出 Bpmn 异常

    }
  }

}

参考

• ​​https://www.jianshu.com/p/77766def8dae​​