工作流(activiti7)-进阶使用(流程实例,个人任务,组任务)(三)
工作流(activiti7)-进阶使用(流程变量,网关,监听器,拦截器)(四)
工作流(activiti7)-进阶使用(子流程CallActivity详细使用)(五)
一,流程实例
每次启动一个流程,就是一个流程实例,他是动态的。。。
比如画了一个流程图,张三来请假,发起一个流程就是一个流程实例,李四来发起又是一个实例。。。如下图:
启动流程实例
流程部署后,也就是流程图画好部署到数据库后。。就可以启动流程实例了。。。代码如下,和之前启动流程一样。。
@Test
public void test3() {
//开启流程
String processDefinitionId = "qjlc:1:4";
ProcessInstance pi = pe.getRuntimeService().startProcessInstanceById(processDefinitionId);
// ProcessInstance pi = pe.getRuntimeService().startProcessInstanceByKey(); //多种方式请求
System.out.println(pi.getId());
}
Businesskey(业务标识)
关联业务的标识,比如请假流程的表单业务id,报销流程表单id,,,如果不满足业务,也可以自己添加字段满足。。。
@Test
public void test33(){
// 根据流程定义的key启动一个流程实例
String businessKey = "hello";
ProcessInstance processInstance = pe.getRuntimeService()
.startProcessInstanceByKey("qjlc", businessKey);
}
这样启动后在 act_hi_procinst 中就回插入该值:
挂起、激活流程实例
全部流程实例
@Test
public void suspendOrActivateProcessDefinition() {
// 挂起激活流程定义--全部流程实例
String processDefinitionId = "qjlc";
RepositoryService repositoryService = pe.getRepositoryService();
// 获得流程定义
ProcessDefinition processDefinition = repositoryService .createProcessDefinitionQuery()
.processDefinitionId(processDefinitionId).singleResult();
//是否暂停
boolean suspend = processDefinition.isSuspended();
if(suspend){
//如果暂停则激活,这里将流程定义下的所有流程实例全部激活
repositoryService.activateProcessDefinitionById(processDefinitionId, true, null);
System.out.println("流程定义:"+processDefinitionId+"激活");
}else{
//如果激活则挂起,这里将流程定义下的所有流程实例全部挂起
repositoryService.suspendProcessDefinitionById(processDefinitionId, true, null);
System.out.println("流程定义:"+processDefinitionId+"挂起");
}
}
单个流程实例
@Test
public void suspendOrActiveProcessInstance() {
// 流程实例id
String processInstanceId = "";
// 获取RunTimeService
RuntimeService runtimeService = pe.getRuntimeService();
//根据流程实例id查询流程实例
ProcessInstance processInstance = runtimeService.createProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
boolean suspend = processInstance.isSuspended();
if(suspend){
//如果暂停则激活
runtimeService.activateProcessInstanceById(processInstanceId);
System.out.println("流程实例:"+processInstanceId+"激活");
}else{
//如果激活则挂起
runtimeService.suspendProcessInstanceById(processInstanceId);
System.out.println("流程实例:"+processInstanceId+"挂起");
}
}
二,个人任务
1.一种是通过在画流程图的时候,配置。。(用的少)。。具体参考上篇博客
2.代码中动态配置,,场景(业务系统选人后传递用户数据,后端动态设置任务的执行人)
@Test
public void setAssi() {
//设置执行人
pe.getTaskService().setAssignee("taskid","userId");
}
查询执行人下的任务
@Test
public void test4() {
//查询指派人下的任务
TaskQuery taskQuery = pe.getTaskService().createTaskQuery();
String assignee = "张三"; //指定人就是当前人下的任务,不指定人就是所有任务
taskQuery.taskAssignee(assignee);
taskQuery.orderByTaskCreateTime().desc();
List<Task> list = taskQuery.list();
for (Task task : list) {
String id = task.getId();
String name = task.getName();
String assignee2 = task.getAssignee();
System.out.println(id + "---" + name + "----" + assignee2);
}
}
三,组任务
在流程定义中在任务结点的assignee固定设置任务负责人,在流程定义时将参与者固定设置在.bpmn文件中,如果临时任务负责人变更则需要修改流程定义,系统可扩展性差。针对这种情况可以给任务设置多个候选人,可以从候选人中选择参与者来完成任务。
1,第一种通过流程图设置(很少用) 如下; 可以看到Assignee(个人),CandidateUsers(候选人),CandidateGroup(后选组)
如果设置只需要在流程图中任务节点的配置中设置candidate-users(候选人),多个候选人之间用逗号分开。
具体操作流程:
第一步:查询组任务
指定候选人,查询该候选人当前的待办任务。
候选人不能办理任务。
第二步:拾取(claim)任务
该组任务的所有候选人都能拾取。
将候选人的组任务,变成个人任务。原来候选人就变成了该任务的负责人。
如果拾取后不想办理该任务?
需要将已经拾取的个人任务归还到组里边,将个人任务变成了组任务。
第三步:查询个人任务
查询方式同个人任务部分,根据assignee查询用户负责的个人任务。
第四步:办理个人任务
任务拾取代码
@Test
public void claimTask(){
TaskService taskService = pe.getTaskService();
//要拾取的任务id
String taskId = "15002";
//任务候选人id
String userId = "zhangsan";
//拾取任务
// 即使该用户不是候选人也能拾取(建议拾取时校验是否有资格)
// 校验该用户有没有拾取任务的资格
Task task = taskService.createTaskQuery().taskId(taskId)
.taskCandidateUser(userId)//根据候选人查询
.singleResult();
if(task!=null){
taskService.claim(taskId, userId);
System.out.println("任务拾取成功");
}
}
拾取后就可以执行任务了。。如果拾取后发现拾取的任务不是自己的,或者想要取消可以执行以下操作
@Test
public void setAssigneeToGroupTask() {
// 查询任务使用
TaskService taskService = pe.getTaskService();
// 当前待办任务
String taskId = "15002";
// 任务负责人
String userId = "zhangsan";
// 校验userId是否是taskId的负责人,如果是负责人才可以归还组任务
Task task = taskService.createTaskQuery().taskId(taskId)
.taskAssignee(userId).singleResult();
if (task != null) {
// 如果设置为null,归还组任务,该 任务没有负责人
taskService.setAssignee(taskId, null);
}
}
代码地址 https://github.com/itwsj/activitidemo