1.1 该方式为默认方式,流程启动方式和其他流程的启动方式一致
String processDefinitionKey = "receiveTask"; //流程定义的key
ProcessInstance pi = processEngine.getRuntimeService() //与正在执行的流程实例和执行对象相关的Service
.startProcessInstanceByKey(processDefinitionKey);
1.2 流程图中任务节点的配置如下:
1.3 说明
区别在于:如果是个人任务TYPE的类型表示participant(参与者)
如果是组任务TYPE的类型表示candidate(候选者)和participant(参与者)
2.分配个人任务方式二(使用流程变量)
2.1 该流程在启动流程实例时,通过HashMap设置流程变量,赋值给执行的流程实例
package com.ytdx.groupTask;
import java.io.InputStream;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.history.HistoricIdentityLink;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.IdentityLink;
import org.activiti.engine.task.Task;
import org.junit.Test;
/**
* 分配个人任务方式二(使用流程变量)
* @author lhy
*
*/
public class TaskTest {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
/**
* 部署流程定义(从inputStream)
*/
@Test
public void deploymentProcess_inputStream(){
InputStream inputStreamBpmn = this.getClass().getClassLoader().getResourceAsStream("GroupTask.bpmn");
InputStream inputStreamPng = this.getClass().getClassLoader().getResourceAsStream("GroupTask.png");
Deployment deployment = processEngine.getRepositoryService() //与流程定义和部署对象相关的Service
.createDeployment() //创建一个部署对象
.name("组任务一") //添加部署的名称
.addInputStream("GroupTask.bpmn", inputStreamBpmn)
.addInputStream("GroupTask.png", inputStreamPng)
.deploy(); //完成部署
System.out.println("部署ID:"+deployment.getId());
System.out.println("部署名称:"+deployment.getName());
}
/**
* 启动流程实例
*/
@Test
public void startProcessInstance(){
String processDefinitionKey = "GroupTask"; //流程定义的key
/**启动流程实例的同时,设置流程变量,使用流程变量用来指定任务的办理人,对应GroupTask.bpmn文件中#{userIDs}*/
Map variables = new HashMap();
variables.put("userIDs", "大大,中中,小小");
ProcessInstance pi = processEngine.getRuntimeService() //与正在执行的流程实例和执行对象相关的Service
.startProcessInstanceByKey(processDefinitionKey,variables); //使用流程定义的key启动流程实例,key对应task.bpmn文件中id的属性值,使用key值启动,默认是按照最新版本的流程定义启动
System.out.println("流程实例ID:"+pi.getId());
System.out.println("流程定义ID:"+pi.getProcessDefinitionId());
}
/**
* 查询当前人的个人任务
*/
@Test
public void findPersonalTask(){
String assignee = "海哥";
List list = processEngine.getTaskService() //与正在执行的任务管理相关的Service
.createTaskQuery() //创建任务查询对象
/**查询条件(where部分)*/
.taskAssignee(assignee) //指定个人任务查询,指定办理人
// .taskCandidateUser(candidateUser) //组任务的办理人查询
/**排序*/
.orderByTaskCreateTime().asc() //使用创建时间的升序排列
/**返回结果集*/
.list(); //返回列表
if(list!=null && list.size()>0){
for(Task task:list){
System.out.println("任务ID:"+task.getId());
System.out.println("任务名称:"+task.getName());
System.out.println("任务的创建时间:"+task.getCreateTime());
System.out.println("任务的办理人:"+task.getAssignee());
System.out.println("流程实例ID:"+task.getProcessInstanceId());
System.out.println("执行对象ID:"+task.getExecutionId());
System.out.println("流程定义ID:"+task.getProcessDefinitionId());
System.out.println("########################################################");
}
}
}
/**
* 查询当前人的组任务
*/
@Test
public void findGroupTask(){
String candidateUser = "小小";
List list = processEngine.getTaskService() //与正在执行的任务管理相关的Service
.createTaskQuery() //创建任务查询对象
/**查询条件(where部分)*/
.taskCandidateUser(candidateUser) //组任务的办理人查询
/**排序*/
.orderByTaskCreateTime().asc() //使用创建时间的升序排列
/**返回结果集*/
.list(); //返回列表
if(list!=null && list.size()>0){
for(Task task:list){
System.out.println("任务ID:"+task.getId());
System.out.println("任务名称:"+task.getName());
System.out.println("任务的创建时间:"+task.getCreateTime());
System.out.println("任务的办理人:"+task.getAssignee());
System.out.println("流程实例ID:"+task.getProcessInstanceId());
System.out.println("执行对象ID:"+task.getExecutionId());
System.out.println("流程定义ID:"+task.getProcessDefinitionId());
System.out.println("########################################################");
}
}
}
/**
* 完成我的任务
*/
@Test
public void completePersonalTask(){
String taskId = "4905";
processEngine.getTaskService() //与正在执行的任务管理相关的Service
.complete(taskId);
System.out.println("完成任务:任务ID:"+taskId);
}
/**
* 查询正在执行的任务办理人表
*/
@Test
public void findRunPersonTask(){
String taskId = "5205";
List list = processEngine.getTaskService()
.getIdentityLinksForTask(taskId);
if(list!=null && list.size()>0){
for(IdentityLink identityLink:list){
System.out.println(identityLink.getTaskId()+" "+identityLink.getType()+" "+identityLink.getProcessInstanceId()+" "+identityLink.getUserId());
}
}
}
/**
* 查询历史任务的办理人表
*/
@Test
public void findHistoryPersonTask(){
String processInstanceId = "101"; //PROC_INST_ID_ 字段
List list = processEngine.getHistoryService()
.getHistoricIdentityLinksForProcessInstance(processInstanceId);
if(list!=null && list.size()>0){
for(HistoricIdentityLink identityLink:list){
System.out.println(identityLink.getTaskId()+" "+identityLink.getType()+" "+identityLink.getProcessInstanceId()+" "+identityLink.getUserId());
}
}
}
/**
* 拾取任务,将组任务分给个人任务,指定任务的办理人字段
*/
@Test
public void claim(){
String taskId = "2203"; //任务ID
String userId = "大大"; //分配的个人任务(可以是组任务中的成员,也可以是非组任务的成员),给字段ASSIGNEE_赋值
processEngine.getTaskService()
.claim(taskId, userId);
}
/**
* 将个人任务回退到组任务,前提,之前一定是个组任务
*/
@Test
public void setAssigee(){
String taskId = "2203";
processEngine.getTaskService()
.setAssignee(taskId, null);
}
/**
* 向组任务中添加成员(act_hi_identitylink表中查)
*/
@Test
public void addGroupUser(){
String taskId = "2203";
String userId = "小Y"; //成员办理人
processEngine.getTaskService()
.addCandidateUser(taskId, userId);
}
/**
* 从组任务中删除成员
*/
@Test
public void deleteGroupUser(){
String taskId = "2203";
String userId = "小Y"; //成员办理人
processEngine.getTaskService()
.deleteCandidateUser(taskId, userId);
}
}
2.2 流程图中任务节点的配置
2.3 说明
3.1 该流程实例在启动时,通过调用监听的TaskListenerImpl类,分配组任务的办理人
package com.ytdx.groupTask;
import org.activiti.engine.delegate.DelegateTask;
import org.activiti.engine.delegate.TaskListener;
@SuppressWarnings("serial")
public class TaskListenerImpl implements TaskListener {
/**
* 用来指定任务的办理人
*/
@Override
public void notify(DelegateTask delegateTask) {
//指定个人任务的办理人,也可以指定组任务的办理人
//个人任务:通过类去查询数据库,将下一个任务的办理人查询获取,然后通过setAssignee()的方法指定任务的办理人
//delegateTask.setAssignee("海哥");
//组任务:
delegateTask.addCandidateUser("郭靖");
delegateTask.addCandidateUser("黄蓉");
}
}
package com.ytdx.groupTask;
import java.io.InputStream;
import java.util.List;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.history.HistoricIdentityLink;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.IdentityLink;
import org.activiti.engine.task.Task;
import org.junit.Test;
/**
* 分配个人任务方式二(使用类)
* @author lhy
*
*/
public class GroupTaskTest {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
/**
* 部署流程定义(从inputStream)
*/
@Test
public void deploymentProcess_inputStream(){
InputStream inputStreamBpmn = this.getClass().getClassLoader().getResourceAsStream("GroupTasks.bpmn");
InputStream inputStreamPng = this.getClass().getClassLoader().getResourceAsStream("GroupTasks.png");
Deployment deployment = processEngine.getRepositoryService() //与流程定义和部署对象相关的Service
.createDeployment() //创建一个部署对象
.name("组任务二") //添加部署的名称
.addInputStream("GroupTasks.bpmn", inputStreamBpmn)
.addInputStream("GroupTasks.png", inputStreamPng)
.deploy(); //完成部署
System.out.println("部署ID:"+deployment.getId());
System.out.println("部署名称:"+deployment.getName());
}
/**
* 启动流程实例
*/
@Test
public void startProcessInstance(){
String processDefinitionKey = "GroupTasks"; //流程定义的key
ProcessInstance pi = processEngine.getRuntimeService() //与正在执行的流程实例和执行对象相关的Service
.startProcessInstanceByKey(processDefinitionKey); //使用流程定义的key启动流程实例,key对应task.bpmn文件中id的属性值,使用key值启动,默认是按照最新版本的流程定义启动
System.out.println("流程实例ID:"+pi.getId());
System.out.println("流程定义ID:"+pi.getProcessDefinitionId());
}
/**
* 查询当前人的个人任务
*/
@Test
public void findPersonalTask(){
String assignee = "郭靖";
List list = processEngine.getTaskService() //与正在执行的任务管理相关的Service
.createTaskQuery() //创建任务查询对象
/**查询条件(where部分)*/
.taskAssignee(assignee) //指定个人任务查询,指定办理人
// .taskCandidateUser(candidateUser) //组任务的办理人查询
/**排序*/
.orderByTaskCreateTime().asc() //使用创建时间的升序排列
/**返回结果集*/
.list(); //返回列表
if(list!=null && list.size()>0){
for(Task task:list){
System.out.println("任务ID:"+task.getId());
System.out.println("任务名称:"+task.getName());
System.out.println("任务的创建时间:"+task.getCreateTime());
System.out.println("任务的办理人:"+task.getAssignee());
System.out.println("流程实例ID:"+task.getProcessInstanceId());
System.out.println("执行对象ID:"+task.getExecutionId());
System.out.println("流程定义ID:"+task.getProcessDefinitionId());
System.out.println("########################################################");
}
}
}
/**
* 查询当前人的组任务
*/
@Test
public void findMyGroupTask(){
String candidateUser = "郭靖";
List list = processEngine.getTaskService() //与正在执行的任务管理相关的Service
.createTaskQuery() //创建任务查询对象
/**查询条件(where部分)*/
.taskCandidateUser(candidateUser) //组任务的办理人查询
/**排序*/
.orderByTaskCreateTime().asc() //使用创建时间的升序排列
/**返回结果集*/
.list(); //返回列表
if(list!=null && list.size()>0){
for(Task task:list){
System.out.println("任务ID:"+task.getId());
System.out.println("任务名称:"+task.getName());
System.out.println("任务的创建时间:"+task.getCreateTime());
System.out.println("任务的办理人:"+task.getAssignee());
System.out.println("流程实例ID:"+task.getProcessInstanceId());
System.out.println("执行对象ID:"+task.getExecutionId());
System.out.println("流程定义ID:"+task.getProcessDefinitionId());
System.out.println("########################################################");
}
}
}
/**
* 完成我的任务
*/
@Test
public void completePersonalTask(){
String taskId = "6404";
processEngine.getTaskService() //与正在执行的任务管理相关的Service
.complete(taskId);
System.out.println("完成任务:任务ID:"+taskId);
}
/**
* 查询正在执行的任务办理人表
*/
@Test
public void findRunPersonTask() {
String taskId = "6704";
List list = processEngine.getTaskService().getIdentityLinksForTask(taskId);
if (list != null && list.size() > 0) {
for (IdentityLink identityLink : list) {
System.out.println(identityLink.getTaskId() + " " + identityLink.getType() + " "
+ identityLink.getProcessInstanceId() + " " + identityLink.getUserId());
}
}
}
/**
* 查询历史任务的办理人表
*/
@Test
public void findHistoryPersonTask(){
String processInstanceId = "6704";
List list = processEngine.getHistoryService()//
.getHistoricIdentityLinksForProcessInstance(processInstanceId);
if(list!=null && list.size()>0){
for(HistoricIdentityLink identityLink:list){
System.out.println(identityLink.getTaskId()+" "+identityLink.getType()+" "+identityLink.getProcessInstanceId()+" "+identityLink.getUserId());
}
}
}
/**
* 拾取任务,将组任务分给个人任务,指定任务的办理人字段
* 拾取之后,便可从查询当前人的个人任务中查询
*/
@Test
public void claim(){
String taskId = "6704";
//分配的个人任务(可以是组任务中的成员,也可以是非组任务的成员)
String userId = "郭靖";
processEngine.getTaskService()
.claim(taskId, userId);
}
/**
* 将个人任务回退到组任务,前提,之前一定是个组任务
*/
@Test
public void setAssigee(){
String taskId = "6704";
processEngine.getTaskService()
.setAssignee(taskId, null);
}
/**
* 向组任务中添加成员(在表act_ru_identitylink中添加)
*/
@Test
public void addGroupUser(){
//任务ID
String taskId = "6704";
String userId = "大H";
processEngine.getTaskService()
.addCandidateUser(taskId, userId);
}
/**
* 从组任务中删除成员
*/
@Test
public void deleteGroupUser(){
String taskId = "6704";
String userId = "大H";
processEngine.getTaskService()
.deleteCandidateUser(taskId, userId);
}
}
3.2 流程图中任务节点的配置
3.3 说明
注意:认领任务的时候,可以是组任务成员中的人,也可以不是组任务成员的人,此时通过Type的类型为participant来指定任务的办理人
组任务及三种分配方式:
1:在taskProcess.bpmn中直接写 candidate-users=“小A,小B,小C,小D"
2:在taskProcess.bpmn中写 candidate-users =“#{userIDs}”,变量的值要是String的。
使用流程变量指定办理人
Map variables = new HashMap();
variables.put("userIDs", "大大,小小,中中");
3: 使用TaskListener接口,使用类实现该接口,在类中定义:
delegateTask.addCandidateUser(userId1); //添加组任务的用户
delegateTask.addCandidateUser(userId2);
组任务分配给个人任务(认领任务):
processEngine.getTaskService().claim(taskId, userId);
个人任务分配给组任务:
processEngine.getTaskService(). setAssignee(taskId, null);
向组任务添加人员:
processEngine.getTaskService().addCandidateUser(taskId, userId);
向组任务删除人员:
processEngine.getTaskService().deleteCandidateUser(taskId, userId);
个人任务和组任务存放办理人对应的表:
act_ru_identitylink表存放任务的办理人,包括个人任务和组任务,表示正在执行的任务
act_hi_identitylink表存放任务的办理人,包括个人任务和组任务,表示历史任务
区别在于:如果是个人任务TYPE的类型表示participant(参与者)
如果是组任务TYPE的类型表示candidate(候选者)和participant(参与者)