============================================================
============Activiti7:Candidate-users 候选人==============
============================================================
需求:在流程定义中在任务结点的 assignee 固定设置任务负责人,在流程定义时将参与者固定设置在.bpmn 文件中,如果临时任务负责人变更则需要修改流程定义,系统可扩展性差。针对这种情况可以给任务设置多个候选人,可以从候选人中选择参与者来完成任务。
设置任务候选人:
在流程图中任务节点的配置中设置 candidate-users(候选人),多个候选人之间用逗号分开。
查看 bpmn 文件:
我们可以看到部门经理的审核人已经设置为 zhangsan,lishi这样的一组候选人,可以使用activiti:candiateUsers=”用户 1,用户 2,用户 3”的这种方式来实现设置一组候选人。
=============================================================
=============组任务流程===============
=============================================================
第一步:查询组任务
指定候选人,查询该候选人当前的待办任务。
候选人不能办理任务。
第二步:拾取(claim)任务
该组任务的所有候选人都能拾取。
将候选人的组任务,变成个人任务。原来候选人就变成了该任务的负责人。
***如果拾取后不想办理该任务?
需要将已经拾取的个人任务归还到组里边,将个人任务变成了组任务。
第三步:查询个人任务
查询方式同个人任务部分,根据 assignee 查询用户负责的个人任务。
第四步:办理个人任务
=============================================================
=============用户查询组任务===============
=============================================================
1:根据候选人查询组任务
@Test
public void findGroupTaskList() {
// 流程定义key
String processDefinitionKey = "holiday4";
// 任务候选人
String candidateUser = "zhangsan";
// 创建TaskService
TaskService taskService = processEngine.getTaskService();
//查询组任务
List<Task> list = taskService.createTaskQuery()//
.processDefinitionKey(processDefinitionKey)//
.taskCandidateUser(candidateUser)//根据候选人查询
.list();
for (Tasktask : list) {
System.out.println("----------------------------");
System.out.println("流程实例id:"+task.getProcessInstanceId());
System.out.println("任务id:"+ task.getId());
System.out.println("任务负责人:" + task.getAssignee());
System.out.println("任务名称:" + task.getName());
}
}
=============================================================
=============用户拾取组任务===============
=============================================================
1:候选人员拾取组任务后该任务变为自己的个人任务
@Test
public void claimTask(){
TaskService taskService = processEngine.getTaskService();
//要拾取的任务id
String taskId = "6302";
//任务候选人id
String userId = "lisi";
//拾取任务
//即使该用户不是候选人也能拾取(建议拾取时校验是否有资格)
//校验该用户有没有拾取任务的资格
Task task = taskService.createTaskQuery()//
.taskId(taskId)
.taskCandidateUser(userId)//根据候选人查询
.singleResult();
if(task!=null){
taskService.claim(taskId, userId);
System.out.println("任务拾取成功");
}
}
说明:即使该用户不是候选人也能拾取,建议拾取时校验是否有资格组任务拾取后,该任务已有负责人,通过候选人将查询不到该任务
=============================================================
=============用户查询个人待办任务===============
=============================================================
1:查询方式同个人任务查询
@Test
public voidfindPersonalTaskList() {
// 流程定义key
StringprocessDefinitionKey = "holiday4";
// 任务负责人
Stringassignee = "zhangsan";
// 创建TaskService
TaskServicetaskService = processEngine.getTaskService();
List<Task>list = taskService.createTaskQuery()//
.processDefinitionKey(processDefinitionKey)//
.taskAssignee(assignee).list();
for(Task task : list) {
System.out.println("----------------------------");
System.out.println(" 流 程 实 例 id : " +
task.getProcessInstanceId());
System.out.println("任务id:" +task.getId());
System.out.println("任务负责人:" + task.getAssignee());
System.out.println("任务名称:" + task.getName());
}
}
=============================================================
=============用户办理个人任务===============
=============================================================
1:完成任务
@Test
public void completeTask(){
//任务ID
String taskId = "12304";
processEngine.getTaskService()//
.complete(taskId);
System.out.println("完成任务:"+taskId);
}
说明:建议完成任务前校验该用户是否是该任务的负责人。
=============================================================
=============归还组任务===============
=============================================================
如果个人不想办理该组任务,可以归还组任务,归还后该用户不再是该任务的负责人
// 归还组任务,由个人任务变为组任务,还可以进行任务交接
@Test
public void setAssigneeToGroupTask() {
// 查询任务使用TaskService
TaskService taskService = processEngine.getTaskService();
// 当前待办任务
String taskId = "6004";
// 任务负责人
String userId = "zhangsan2";
// 校验userId是否是taskId的负责人,如果是负责人才可以归还组任务
Task task = taskService.createTaskQuery().taskId(taskId)
.taskAssignee(userId).singleResult();
if (task!= null) {
// 如果设置为null,归还组任务,该 任务没有负责人
taskService.setAssignee(taskId, null);
}
}
说明:建议归还任务前校验该用户是否是该任务的负责人也可以通过 setAssignee方法将任务委托给其它用户负责,注意被委托的用户可以不是候选人(建议不要这样使用)
=============================================================
=============任务交接===============
=============================================================
任务交接,任务负责人将任务交给其它候选人办理该任务
@Test
public void setAssigneeToCandidateUser() {
// 查询任务使用TaskService
TaskService taskService = processEngine.getTaskService();
// 当前待办任务
String taskId = "6004";
// 任务负责人
String userId = "zhangsan2";
// 将此任务交给其它候选人办理该任务
String candidateuser = "zhangsan";
// 校验userId是否是taskId的负责人,如果是负责人才可以归还组任务
Task task = taskService.createTaskQuery().taskId(taskId)
.taskAssignee(userId).singleResult();
if (task!= null) {
taskService.setAssignee(taskId, candidateuser);
}
}