1.组任务
1.1、需求
在流程定义中在任务结点的 assignee 固定设置任务负责人,在流程定义时将参与者固定设置在.bpmn 文件中,如果临时任务负责人变更则需要修改流程定义,系统可扩展性差。
针对这种情况可以给任务设置多个候选人,可以从候选人中选择参与者来完成任务。
1.2、设置任务候选人
在流程图中任务节点的配置中设置 candidate-users(候选人),多个候选人之间用逗号分开。
查看bpmn文件
<userTask activiti:candidateUsers="lisi,wangwu" activiti:exclusive="true" id="_3" name="经理审批"/> 复制代码
我们可以看到部门经理的审核人已经设置为 lisi,wangwu 这样的一组候选人,可以使用
activiti:candiateUsers=”用户 1,用户 2,用户 3”的这种方式来实现设置一组候选人
1.3、组任务
1.3.1、组任务办理流程
a、查询组任务
指定候选人,查询该候选人当前的待办任务。
候选人不能立即办理任务。
b、拾取(claim)任务
该组任务的所有候选人都能拾取。
将候选人的组任务,变成个人任务。原来候选人就变成了该任务的负责人。
如果拾取后不想办理该任务?
需要将已经拾取的个人任务归还到组里边,将个人任务变成了组任务。
c、查询个人任务
查询方式同个人任务部分,根据assignee查询用户负责的个人任务。
d、办理个人任务
1.3.2、 查询组任务
根据候选人查询组任务
/** * 查询组任务 */ @Test public void test03(){ String key = "evection1"; String candidateUser = "lisi"; ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); TaskService taskService = engine.getTaskService(); List<Task> list = taskService.createTaskQuery() .processDefinitionKey(key) .taskCandidateUser(candidateUser) .list(); for (Task task : list) { System.out.println("流程实例Id:" + task.getProcessInstanceId()); System.out.println("任务ID:" + task.getId()); System.out.println("负责人:" + task.getAssignee()); System.out.println("任务名称:" + task.getName()); } } 复制代码
4.3.3 、 拾取组任务
候选人员拾取组任务后该任务变为自己的个人任务。
/** * 候选人 拾取任务 */ @Test public void test04(){ ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); TaskService taskService = engine.getTaskService(); String taskId = "72505"; // 候选人 String userId = "lisi"; // 拾取任务 Task task = taskService.createTaskQuery() .taskId(taskId) .taskCandidateUser(userId) // 根据候选人查询 .singleResult(); if(task != null){ // 可以拾取任务 taskService.claim(taskId,userId); System.out.println("拾取成功"); } } 复制代码
1.3.4、 查询个人待办任务
查询方式同个人任务查询
@Test public void test03(){ String key = "evection1"; String candidateUser = "lisi"; ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); TaskService taskService = engine.getTaskService(); List<Task> list = taskService.createTaskQuery() .processDefinitionKey(key) //.taskCandidateUser(candidateUser) //.taskCandidateOrAssigned(candidateUser) .taskAssignee(candidateUser) .list(); for (Task task : list) { System.out.println("流程实例Id:" + task.getProcessInstanceId()); System.out.println("任务ID:" + task.getId()); System.out.println("负责人:" + task.getAssignee()); System.out.println("任务名称:" + task.getName()); } } 复制代码
1.3.5、 办理个人任务
同个人任务办理
/** * 完成个人任务 */ @Test public void test05(){ String taskId = "72505"; ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); TaskService taskService = engine.getTaskService(); taskService.complete(taskId); System.out.println("完成任务:" + taskId); } 复制代码
1.3.6、 归还组任务
如果个人不想办理该组任务,可以归还组任务,归还后该用户不再是该任务的负责人
/** * 归还任务 */ @Test public void test06(){ ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); TaskService taskService = engine.getTaskService(); String taskId = "75002"; String userId= "zhangsan"; Task task = taskService.createTaskQuery() .taskId(taskId) .taskAssignee(userId) .singleResult(); if(task != null){ // 如果设置为null,归还组任务,任务没有负责人 taskService.setAssignee(taskId,null); } } 复制代码
1,3,7、 任务交接
任务负责人将任务交给其他负责人来处理
/** * 任务交接 */ @Test public void test07(){ ProcessEngine engine = ProcessEngines.getDefaultProcessEngine(); TaskService taskService = engine.getTaskService(); String taskId = "75002"; String userId= "zhangsan"; Task task = taskService.createTaskQuery() .taskId(taskId) .taskAssignee(userId) .singleResult(); if(task != null){ // 设置该任务的新的负责人 taskService.setAssignee(taskId,"赵六"); } } 复制代码
4.3.8、 数据库表操作
查询当前任务执行表
SELECT * FROM act_ru_task 复制代码
任务执行表,记录当前执行的任务,由于该任务当前是组任务,所有assignee为空,当拾取任务后该字段就是拾取用户的id
查询任务参与者
SELECT * FROM act_ru_identitylink 复制代码
任务参与者,记录当前参考任务用户或组,当前任务如果设置了候选人,会向该表插入候选人记录,有几个候选就插入几个
与act_ru_identitylink对应的还有一张历史表act_hi_identitylink,向act_ru_identitylink插入记录的同时也会向历史表插入记录。任务完成