1 概要介绍
1)什么是流程定义 ?
流程定义是按照bpmn2.0标准定义业务流程,将流程定义的文件(.bpmn和.png(不是必须的))部署到activiti中,activiti就可以管理该业务流程。
2)什么是流程实例 ?
参与者(可以用户,也可以程序)按照流程定义发起一个流程,这个流程就是一个流程实例 。流程定义的内容就是一个静态文件(.bpmn),流程实例的内容是该 流程的执行过程(动态)。
3)如何启动一个流程实例 ?
常用方式:启动一个流程实例时指定一个业务标识。
// 业务标识 ,如果 是采购流程就是采购单id
String businessKey = "001";
// 启动流程实例时指定业务标识
String processDefinitionKey = "purchasingflow";
ProcessInstance processInstance = runtimeService
.startProcessInstanceByKey(processDefinitionKey, businessKey);
businessKey:业务标识,作用:通过activiti的api查询activiti的流程数据时,可以通过businessKey关联查询业务系统 的数据,通常业务标识记录业务系统表的主键,比如:如果采购流程,businesskey就是采购单id,如果是请假流程,businessKey就是请假单(请假信息表)的id。
启动一个流程实例 后,该流程运行到第一个结点,activiti需要给该 任务结点分配任务负责人。
任务分配三种方式:
第一种:采用固定分配方法,设置task结点的assignee(任务负责人)属性,不常用。
第二种:采用UEL表达式,表达使用流程变量设置任务负责人,在企业开发中常用。
第三种:采用监听器(自定义监听器实现 TaskListener接口),可以在监听器中扩展代码,在企业开发中常用。
查询待办任务:
查询待办任务中如果包括 业务系统 数据,如果查询?
通过Taskid得到任务所属的流程实例id
通过流程实例id得到流程实例对象ProcessInstance。
从ProcessInstance获取businessKey
通过businessKey关联查询业务数据
4)Activiti开发步骤:
1、 在需求阶段,分析出业务流程
2、 设计阶段,确定哪些业务流程由activiti管理,对工作流管理的流程进行流程定义
流程定义时和功能设计同步进行:
1》 确定流程启动所对应的功能
2》 确定流程执行中哪些功能和流程结点对应,哪个功能可以将流程向后推进一步
Activiti开发遵循原则:
1、 角色分工明确,activiti负责流程管理 ,业务系统 负责业务功能。
2、 业务系统 中通常在service层将activiti和控制层、持久层进行隔离(解耦),比如在业务功能中需要查询activiti的流程数据,需要自定义一个对象存储activiti的数据。
3、 数据共享问题,在activiti中存储businesskey(业务标识),通过businesskey查询业务系统 数据,在业务系统 中存储activiti的标识(比如在采购单中存储流程实例 的id),在查询业务数据时通过此流程实例 id查询activiti的数据。达到目标:activiti和业务系统 能互相关联查询。
办理任务(完成任务):
需要参数:任务id(activiti的api要求),用户id(进行权限校验使用)
在完成任务之前需要校验该 用户是否有该 任务的完成权限。
2 流程变量
2.1 什么是流程变量
在activiti在管理流程中,可能需要通过流程变量控制流程的执行。
注意:流程变量只是用于控制流程的执行,而不是存储业务数据!!
2.2 流程变量作用域
Activiti的流程变量包括 global全局变量和local局部变量。
Activiti常用全局变量进行流程控制,因为local局部变量作用域小一般不用,可以查询历史的局部变量。
global全局变量:作用域是整体流程实例,如果流程实例结束,变量无效。
local局部变量: 作用域小,可以是一个任务(task)也可以是一个执行分支(execution)。任务或执行分支结束,local局部变量无效。
通过historyService查询历史流程变量值。
不同的流程实例,global全局变量互不影响。
同一个流程实例,无法设置两个相同名称 global全局变量,后设置的相同名称 global全局变量会覆盖前边的变量值 。
任务中local变量,不同任务的local变量互不影响。Local变量名称可以和global全局变量相同。
2.3 流程变量的类型
注意:如果将pojo对象存储到流程变量中,必须实现序列化接口serializable,为了防止由于新增字段无法反序列化,需要生成serialVersionUID,如下:
注意:由于OrderCustom也继承了PurBusOrder类,PurBusOrder也必须实现序列化接口,否则 PurBusOrder中的属性无法反序列化。
总结:
1、如果需要将pojo中的属性从流程变量获取(activiti进行反序列化),需要将属性所在pojo实现serializable接口。
2、需要在pojo中设置serialVersionUID,如果不设置该版本id,日后在pojo中新增字段,如果之前将未新增字段的pojo对象存储在activiti的流程变量中,如果从流程变量中获取之前 的pojo对象,将报错。
2.4 流程变量的使用方法
第一步:设置流程变量
第二步:使用流程变量控制流程的执行
例子:
1) 在task结点的assignee通过UEL表达式使用流程变量
${assignee}:assignee就是一个流程变量名称
Activiti获取UEL表达式的值 ,即流程变量assignee的值 ,将assignee的值作为任务的负责人进行任务分配.
2)在连线上的candition条件上通过UEL表达式使用流程变量
${price>=10000}和${price<10000}: price就是一个流程变量名称,uel表达式结果类型为布尔类型
如果UEL表达式是true,要决定 流程执行走向。
比如:如果采购金额大于10000元由总经理审核,否则由财务直接审核。
2.5 设置全局变量
2.5.1 可以流程启动时设置流程变量(常用)
由于设置了全局变量,该流程启动后,在下边每个结点都可以使用该变量。
在task结点的assignee通过UEL表达式使用流程变量。
代码:
// 得到runtimeService
RuntimeService runtimeService = processEngine.getRuntimeService();
// 根据流程定义的key(标识 )来启动一个实例,activiti找该key下版本最高的流程定义
// 一般情况下为了方便开发使用该方法启动一个流程实例。
String processDefinitionKey = "purchasingflow";
// 在流程启动时设置全局变量,第二个参数variables存储流程变量
Map<String, Object> variables = new HashMap<String, Object>();
// 流程 变更名称是assignee,流程变量值是"张三"
variables.put("assignee", "张三");
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);
2.5.2 在完成任务时设置流程变量(常用)
在完成任务时设置流程变量,在该 任务的后续结点可以使用该 变量,变量的作用域还是整个流程实例 。
//完成任务时设置流程变量
Map<String, Object> variables = new HashMap<String, Object>();
// 流程 变更名称是assignee,流程变量值是"张三"
variables.put("assignee", "李四");
taskService.complete(taskId, variables);
测试发现,在同一个流程实例下,同名的全局变量,后设置的会覆盖前边设置的。
2.5.3 通过当前流程实例 id设置
通过此方法可以在流程实例未结束时任意设置流程变量。
RuntimeService runtimeService = processEngine.getRuntimeService();
//设置单个 变量
//第一个参数:executionId是流程实例 的执行 id,通常使用流程实例 id,必须是当前正在运行的流程实例 id
//第二个参数:变量名
//第三个参数:变量值
runtimeService.setVariable("2001", "price", 10000);
//一次设置多个变量,第二个参数是map
//runtimeService.setVariables(executionId, variables)
注意:第一个参数executionId是流程实例 的执行 id,通常使用流程实例 id,必须是当前正在运行的流程实例 id
获取变量:
runtimeService.getVariable(executionId, variableName)
2.5.4 通过当前待办任务id设置
通过此方法可以在流程实例未结束时任意设置流程变量。
TaskService taskService = processEngine.getTaskService();
//设置单个 变量
//第一个参数:taskId是当前待办任务id,在act_ru_task存在
//第二个参数:变量名
//第三个参数:变量值
//activiti根据 任务id查询所属流程实例 id,存储act_ru_variable表。
taskService.setVariable("2902", "price", 10000);
//一次设置多个变量,第二个参数是map
//taskService.setVariables(taskId, variables)
activiti根据 任务id查询所属流程实例 id,将流程变量值存储act_ru_variable表,不管使用什么任务id,找到流程实例 id相同就会覆盖原来的变量。
获取变量方法:
System.out.println(taskService.getVariable("3302", "price"));
3 全局变量测试
什么时候设置流程变量?
采购流程中,在提交采购单时设置流程变量,因为提交采购单后采购单信息不再修改了。
使用完成提交采购单任务时设置流程变量。
// 完成任务时设置流程变量,使用pojo
OrderCustom orderCustom = new OrderCustom();
orderCustom.setPrice(10000f);
Map<String, Object> varaibles = new HashMap<String, Object>();
varaibles.put("order", orderCustom);
taskService.complete(taskId, varaibles);
4 设置局部变量
4.1 在任务完成设置局部变量
在任务完成时设置局部变量,任务完成后,后续结点无法使用局部变量。
// 完成任务时设置流程变量,使用pojo
OrderCustom orderCustom = new OrderCustom();
orderCustom.setPrice(10000f);
Map<String, Object> varaibles = new HashMap<String, Object>();
varaibles.put("order", orderCustom);
//设置局部变量
taskService.setVariablesLocal(taskId, varaibles);
//完成任务
taskService.complete(taskId);
当局部变量消失后,再使用该变量会报错。
4.2 查询历史任务时查询流程变量
//查询历史 任务查询流程变量
historicTaskInstanceQuery.includeTaskLocalVariables();
//从activiti的流程变量取出pojo对象 ,经过反序列化
OrderCustom orderCustom = (OrderCustom) historicTaskInstance.getTaskLocalVariables().get("order");
System.out.println("历史 流程变量采购单信息:"+orderCustom.getPrice());
注意:使用流程变量不建议存储业务数据,因为通过activiti的api查询流程变量,特别是pojo变量,速度很慢。
流程变量要用于流程控制。
4.3 通过当前任务id设置变量
//通过当前任务id设置局部变量
@Test
public void setVariableByTaskId(){
TaskService taskService = processEngine.getTaskService();
//设置单个 局部变量
taskService.setVariableLocal("5305", "price", 50000);
//一次设置多个局部变量
//taskService.setVariablesLocal(taskId, variables)
}
注意:任务id为当前待办理的任务id。
4.4 流程变量数据表跟踪
SELECT * FROM act_ru_variable #当前流程变量表
记录当前流程实例使用的流程变量
Type_:变量类型
Name_:变量名称
Execution_id_:流程实例执行id(global和local变量存储)
Proc_inst_id_:流程实例 id(global和local变量存储)
Task_id_:流程变量所属的任务id(local变量存储)
BYTEARRAY_ID_:如果流程变量为pojo,字段存储引用act_ge_bytearray表的主键,在资源表act_ge_bytearray存储pojo流程变量的序列化信息。
Long_和text_:根据变量类型存储变量值
SELECT * FROM act_hi_varinst #历史 流程变量表
记录流程执行所创建的所有流程变量
5 案例1
5.1 需求
员工创建采购单,由部门经理审核,部门经理审核通过后一万元以下由财务直接审核,一万元以上先由总经理审核,总经理审核通过再由财务审核。
5.2 流程定义
5.3 开发
采购流程中,在提交采购单时设置流程变量,因为提交采购单后采购单信息不再修改了。
使用完成提交采购单任务时设置流程变量。
修改提交 采购单service,在完成任务时设置流程变量。
修改orderService中saveOrderSubmitStauts提交采购单方法:
if (task != null) {
// 说明assignee是该任务的办理人,有权限完成
OrderCustom orderCustom = new OrderCustom();
// 采购信息获取
// 根据 任务对象 获取流程实例 id
String processInstanceId = task.getProcessInstanceId();
// 查询流程实例 对象
ProcessInstance processInstance = runtimeService
.createProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
// 从流程实例 对象 中获取businessKey
String businessKey = processInstance.getBusinessKey();
// 根据 businessKey查询采购单信息
PurBusOrder purBusOrder = purBusOrderMapper.selectByPrimaryKey(businessKey);
BeanUtils.copyProperties(purBusOrder, orderCustom);
//流程变量,值 为orderCustom即采购单信息
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("order", orderCustom);
// 设置流程变量,值 为采购单信息
taskService.complete(taskId,variables);
// System.out.println("完成任务:" + taskId);
}
6 案例2
6.1 需求
在上边的基础上添加审核不通过的连线。
需求如下:
在采购系统中实现流程审核不通过分支,功能如下:
1 部门经理审核不通过由员工重新修改采购单
2 总经理审核不通过由员工重新修改采购单再提交
3 财务审核不通过由员工重新审核
6.2 流程定义
6.2.1 对审核不通的由流程发起人再提交采购单
设置流程发起人:
在开始结点,设置initiator(发起人)。
设置创建采购单的任务负责人为:
修改orderService中的saveOrder方法,在启动流程时设置任务发起人:
注意:
任务发起人设置在启动流程实例之前设置。
6.2.2 增加审核不通过的连线
部门经理审核 :
审核通过candition:
${order.price>=10000 && firstAudit. status==’1’} 部门经理审核通过且采购金额大于等于10000元由总经理审核
${order.price<10000 && firstAudit. status==’1’}部门经理审核通过且采购金额小于10000元由财务审核
firstAudit和order都是流程变量名称
审核 不通过candition :
${ firstAudit. status==’0’}:部门经理审核不通过由流程发起人重新修改采购单再提交
总经理审核 :
审核通过candition:${ secondAudit. status==’1’} 总经理审核通过
审核 不通过candition : ${ secondAudit. status==’0’}总经理审核不通过
财务审核 :
审核通过candition:${ thirdAudit. status==’1’} 财务审核通过
审核 不通过candition : ${ third Audit. status==’0’}财务审核不通过
注意:上边的firstAudit、secondAudit、thirdAudit分别存储三级审核信息。
6.3 开发
修改orderService中saveOrderSubmitStauts提交采购单方法:
if (task != null) {
// 说明assignee是该任务的办理人,有权限完成
OrderCustom orderCustom = new OrderCustom();
// 采购信息获取
// 根据 任务对象 获取流程实例 id
String processInstanceId = task.getProcessInstanceId();
// 查询流程实例 对象
ProcessInstance processInstance = runtimeService
.createProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
// 从流程实例 对象 中获取businessKey
String businessKey = processInstance.getBusinessKey();
// 根据 businessKey查询采购单信息
PurBusOrder purBusOrder = purBusOrderMapper.selectByPrimaryKey(businessKey);
BeanUtils.copyProperties(purBusOrder, orderCustom);
//流程变量,值 为orderCustom即采购单信息
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("order", orderCustom);
// 设置流程变量,值 为采购单信息
taskService.complete(taskId,variables);
// System.out.println("完成任务:" + taskId);
}
修改 service中采购单审核方法:
设置流程变量:firstAudit、secondAudit、thirdAudit
if (task != null) {
// 说明assignee是该任务的办理人,有权限完成
Map<String,Object> variables = new HashMap<String,Object>();
//根据 auditType判断是几级审核
if(auditType.equals("firstAudit")){
//部门经理审核
variables.put("firstAudit", orderAuditCustom);
}else if(auditType.equals("secondAudit")){
//总经理审核
variables.put("secondAudit", orderAuditCustom);
}else if(auditType.equals("thirdAudit")){
//财务审核
variables.put("thirdAudit", orderAuditCustom);
}
//提交审核时,设置流程变量,变量值就是审核 信息
taskService.complete(taskId,variables);
// System.out.println("完成任务:" + taskId);
}
7 Candidate-user候选人
7.1 什么是候选人
采用固定分配方法给任务指定负责人,如果任务负责人出现变更,需要修改流程定义,就可以采用候选人分配方式,先给任务分配多个候选人,候选人通过拾取组任务进行个人任务办理。
给任务分配候选人,如果分配多个候选人中间使用半角逗号分隔。
7.2 什么是组任务
多个候选人有资格完成该 任务,这个任务叫做组任务。
组任务具备条件:
任务没有设置assignee任务负责人
任务具有候选人
7.3 候选人办理任务过程
第一步:给任务设置候选人(多个, 中间使用半角逗号分隔)
候选人是无法办理任务
第二步:候选人查询组任务
使用taskService查询,指定candidate候选人。
第三步:候选人拾取(claim)组任务
候选人拾取组任务后,该 候选人变为任务的负责人,该任务变为个人任务
如果候选人拾取组任务后,不想办理该 任务,可以将个人任务归还,该个人任务变为组任务
第四步:查询待办个人任务
第五步:办理任务
第六步:流程结束
7.4 Candidate-user办理任务api
7.4.1 候选人查询组任务
使用taskService指定candidateUser候选人查询组任务。
//任务查询对象
TaskQuery taskQuery = taskService.createTaskQuery();
//候选人
String candidateUser = "zhangsan";
taskQuery.taskCandidateUser(candidateUser);
//流程定义key
String processDefinitionKey = "purchasingflow";
taskQuery.processDefinitionKey(processDefinitionKey);
List<Task> list = taskQuery.list();
注意:查询组任务,必须指定 candidateUser候选人,查询该候选人有资格办理的组任务。
7.4.2 拾取组任务
通过taskService,指定任务id和候选人拾取任务:
TaskService taskService = processEngine.getTaskService();
//组任务id
String taskId = "5604";
//任务候选人,claim拾取后该 候选人变为任务负责人
String userId = "zhangsan";
//任务拾取
taskService.claim(taskId, userId);
注意:如果拾取人不是该任务的候选人也可以拾取成功,在拾取之前需要校验,该 候选人是否有资格拾取该 任务.
// 组任务id
String taskId = "6004";
// 任务候选人,claim拾取后该 候选人变为任务负责人
String candidateUser = "zhangsan4";
//根据候选人和组任务id查询,如果有记录说明该 候选人有资格拾取该 任务
Task task = taskService.createTaskQuery().taskId(taskId)
.taskCandidateUser(candidateUser).singleResult();
if(task!=null){
// 任务拾取
taskService.claim(taskId, candidateUser);
System.out.println("任务拾取成功");
}
7.4.3 组任务归还
// 归还组任务,由个人任务变为组任务,还可以进行任务交接
@Test
public void setAssignee() {
// 查询任务使用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);
}
}
7.4.4 任务交接
任务负责人也可以将任务交给其它候选人办理该任务
代码如下:
@Test
public void setAssigneeToCandidateUser() {
// 查询任务使用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) {
// 将此任务交给其它候选人办理该 任务
String candidateuser = "zhangsan";
// 根据候选人和组任务id查询,如果有记录说明该 候选人有资格拾取该 任务
Task task2 = taskService.createTaskQuery().taskId(taskId)
.taskCandidateUser(candidateuser).singleResult();
if (task2 != null) {
// 才可以交接
taskService.setAssignee(taskId, candidateuser);
}
}
}
8 Candidate-group候选组
8.1 什么候选组
即使给任务指定了多个候选人,多个候选人都有办理任务资格,但是候选的人数有限,无法动态扩展,如果需要添加或删除候选,需要修改流程定义 文件,不利于系统 扩展。
采用候选组方式解决上边的问题。
给任务设置候选组,在组中有多个用户并且可以动态扩展用户,组中的用户都是候选人,候选人先拾取组任务,将组任务变为自己的个人任务,进行个人任务办理。
8.2 候选组办理任务过程
第一步:Activiti会自动从候选组中找用户,将这些用户作为该 任务的候选人。
下边的流程同候选人办理任务过程!!
第二步:给任务设置候选人(多个, 中间使用半角逗号分隔)
候选人是无法办理任务
第三步:候选人查询组任务
使用taskService查询,指定candidate候选人。
第四步:候选人拾取(claim)组任务
候选人拾取组任务后,该 候选人变为任务的负责人,该任务变为个人任务
如果候选人拾取组任务后,不想办理该 任务,可以将个人任务归还,该个人任务变为组任务
第五步:查询待办个人任务
第六步:办理任务
第七步:流程结束
8.3 设置候选组
8.4 设置组和用户信息
Activiti中采用以下表记录组信息、用户信息、组和用户关系 信息
SELECT * FROM act_id_group #组信息
SELECT * FROM act_id_user #用户信息
SELECT * FROM act_id_membership #组和用户关系信息
8.4.1 Api设置方法
以下设置的信息和业务系统的用户信息、角色信息保存一致。
先设置组信息
再设置用户信息
再设置组和用户关系信息
代码如下:
//设置组和用户信息
@Test
public void setUserGroup(){
IdentityService identityService = processEngine.getIdentityService();
//设置组信息
//添加之前应该校验组信息是否存在,不存在再进行添加
if(identityService.createGroupQuery().groupId("10").singleResult()==null){
//添加新组
GroupEntity groupEntity = new GroupEntity();
groupEntity.setId("10");
groupEntity.setName("员工");
identityService.saveGroup(groupEntity);
}
if(identityService.createGroupQuery().groupId("11").singleResult()==null){
//添加新组
GroupEntity groupEntity = new GroupEntity();
groupEntity.setId("11");
groupEntity.setName("部门经理");
identityService.saveGroup(groupEntity);
}
if(identityService.createGroupQuery().groupId("12").singleResult()==null){
//添加新组
GroupEntity groupEntity = new GroupEntity();
groupEntity.setId("12");
groupEntity.setName("总经理");
identityService.saveGroup(groupEntity);
}
if(identityService.createGroupQuery().groupId("13").singleResult()==null){
//添加新组
GroupEntity groupEntity = new GroupEntity();
groupEntity.setId("13");
groupEntity.setName("财务");
identityService.saveGroup(groupEntity);
}
//设置用户信息
//添加之前应该校验用户信息是否存在,不存在再进行添加
if(identityService.createUserQuery().userId("zhangsan").singleResult()==null){
//添加新用户
UserEntity userEntity = new UserEntity();
userEntity.setId("zhangsan");
userEntity.setFirstName("张三");
identityService.saveUser(userEntity);
}
if(identityService.createUserQuery().userId("lisi").singleResult()==null){
//添加新用户
UserEntity userEntity = new UserEntity();
userEntity.setId("lisi");
userEntity.setFirstName("李四");
identityService.saveUser(userEntity);
}
if(identityService.createUserQuery().userId("wangwu").singleResult()==null){
//添加新用户
UserEntity userEntity = new UserEntity();
userEntity.setId("wangwu");
userEntity.setFirstName("王五");
identityService.saveUser(userEntity);
}
if(identityService.createUserQuery().userId("zhaoliu").singleResult()==null){
//添加新用户
UserEntity userEntity = new UserEntity();
userEntity.setId("zhaoliu");
userEntity.setFirstName("赵六");
identityService.saveUser(userEntity);
}
//设置用户和组的关系信息
//采用先删除再添加
identityService.deleteMembership("zhangsan", "10");
identityService.createMembership("zhangsan", "10");
identityService.deleteMembership("lisi", "11");
identityService.createMembership("lisi", "11");
identityService.deleteMembership("wangwu", "12");
identityService.createMembership("wangwu", "12");
identityService.deleteMembership("zhaoliu", "13");
identityService.createMembership("zhaoliu", "13");
}
8.4.2 与业务系统同步方法(常用)
方法1 :
数据库触发器方法
企业中在进行数据同步的常用方法,一般在一个数据库中采用此方法。
业务系统 用户表----》activiti的act_id_user
在业务系统 用户表添加触发器:新增、删除、修改
注意:如果act_id_user有外键关系,需要先删除依赖关系。
业务系统 角色表----》activiti的act_id_group
业务系统 角色和用户关系表—》activiti的act_id_membership
方法2 :
采用即时触发java程序。
用户角色同步:
在操作业务系统 用户角色表时执行以下操作:
业务系统添加角色-àactiviti添加角色
业务系统修改角色àactiviti修改角色
业务系统删除角色àactiviti删除角色,删除之前将用户角色关系表先删除(根据角色删除)
用户信息同步
在操作业务系统 用户表时执行以下操作
业务系统添加用户----》activiti添加用户,添加用户与角色关系表
业务系统修改用户---》activiti修改用户,先删除原来用户与角色关系表,再添加用户与角色关系
业务系统删除用户—》activiti删除用户,删除之前将用户角色关系表删除(根据用户删除)
8.5 组任务办理过程api
8.5.1 设置组和用户信息
参考上边设置组和用户api
正式开发时,需要将业务系统 用户和角色信息同步到activiti中。
8.5.2 候选人查询组任务
参考candidate-user的api
注意:
在activiti的用户、组、用户和组关系表中随时添加数据,不受流程启动先后顺序影响。
9 网关
9.1 排他网关
9.1.1 什么排他网关
排他网关用于决策,选择分支执行流程,分支上需要设置condition条件,如果分支的条件结果为true,那么该分支会通过排他网关。排他网关只会选择一条分支去执行。
9.1.2 定义方法
图标:
流程定义:
9.1.3 排他网关测试
第一步:流程定义部署
第二步:启动流程实例
设置price流程变量值,因为price 在排他网关的两分支使用
第三步:查询待办任务
也可以在部门经理审核后设置price流程变量值,因为price 在排他网关的两分支使用
第四步:办理任务
如果分支上的条件都不满足,没有一条线经过排他网关,activiti会抛出异常:
org.activiti.engine.ActivitiException: No outgoing sequence flow of the exclusive gateway 'exclusivegateway1' could be selected for continuing the process at org.activiti.engine.impl.bpmn.behavior.ExclusiveGatewayActivityBehavior.leave(ExclusiveGatewayActivityBehavior.java:85)
如果多条分支都满足,只会有一条线经过排他网关。
上边两种情况必须在开发避免!!!
9.2 并行网关
9.2.1 什么并行网关
并行网关(parallelGateway),包括分支和汇聚两个结点,所有的分支不判断条件都经过分支结点,所有经过分支结点的分支都要进行汇聚,所有的分支全部执行完成,并行网关执行完成。
Fork(分支)
所有的分支不判断条件都经过分支结点
Join(汇聚)
所有经过分支结点的分支都要进行汇聚
分支的数量等于汇聚数量!
9.2.2 流程定义
图标:
注意:经过并行网关的分支结点,不需要设置condition条件。
9.2.3 并行网关测试
当流程执行到并行的分支结点时,
向act_ru_execution #流程实例执行表执行并行分支(结算,入库)
Execution表中8501的记录数等于分支数+1
只有一条记录的流程实例 id和流程实例执行id相等的,这一条为流程执行主线。
向当前任务表中插入两条记录(结算、入库)
9.3 包含网关
9.3.1 什么是包含网关
包含网关是排他网关和并行网关的结合体。
包含网关(IncluesiveGateway),包括分支和汇聚两个结点,经过分支结点需要判断条件,满足条件经过分支结点,所有经过分支结点的线边最终会进行汇聚。
Fork(分支)
所有的分支需要判断条件,满足条件的经过分支结点
Join(汇聚)
所有满足条件的分支都要进行汇聚
10 案例
10.1 需求
将采购流程改为组任务(使用候选组)实现
在采购流程中实现排他网关
在采购流程中实现并行网关
需求描述:
员工创建采购单
经过部门经理审核
审核通过:
部门经理审核通过,如果采购金额大于等于1万元,由总经理审核
部门经理审核通过,如果采购金额小于1万元,由财务审核
审核不通过:
部门经理审核不通过,由员工重新修改采购单进行提交
总经理审核
总经理审核通过由财务审核通过
总经理审核不通过,由员工重新修改采购单进行提交
财务审核
财务审核通过并行执行财务结算和入库
财务审核不通过,由员工重新修改采购单进行提交
财务结算和入库两个操作可以并行执行。
10.2 流程定义
部门经理审核通过后,通过排他网关决定走总经理审核还是财务审核。
财务审核通过后,经过并行网关,财务结算和入库并行执行。
审核分支设置condition 条件:
部门经理审核 :
审核通过candition:
${order.price>=10000 && firstAudit. status==’1’} 部门经理审核通过且采购金额大于等于10000元由总经理审核
${order.price<10000 && firstAudit. status==’1’}部门经理审核通过且采购金额小于10000元由财务审核
firstAudit和order都是流程变量名称
审核 不通过candition :
${ firstAudit. status==’0’}:部门经理审核不通过由流程发起人重新修改采购单再提交
总经理审核 :
审核通过candition:${ secondAudit. status==’1’} 总经理审核通过
审核 不通过candition : ${ secondAudit. status==’0’}总经理审核不通过
财务审核 :
审核通过candition:${ thirdAudit. status==’1’} 财务审核通过
审核 不通过candition : ${ third Audit. status==’0’}财务审核不通过
10.3 分析
10.3.1 需要开发结算和入库功能
真正的结算和入库很复杂,确定一个功能将流程向后推进一步。
为了教学方便,开发结算和入库功能实现activiti任务完成。
10.3.2 候选人查询组任务
由于任务结点改变 候选组方式分配任务,实现候选人查询组任务。
实现 方法:
调用taskService,指定candidateUser候选人查询组任务。
10.4 开发
接口功能:候选人查询组任务
接口参数:候选人candidateUserId,(实际开发需要查询条件)
接口实现 :
调用taskService,指定candidateUser候选人查询组任务
public List<OrderCustom> findOrderGroupTaskList(String userId)
throws Exception {
// 任务查询对象
TaskQuery taskQuery = taskService.createTaskQuery();
// 候选人,在act_id_user表中存在,从act_id_membership通过group_id_查询出用户
String candidateUser = userId;
// 指定候选人
taskQuery.taskCandidateUser(candidateUser);
// 流程定义key
String processDefinitionKey = ResourcesUtil.getValue(
"diagram.purchasingflow", "purchasingProcessDefinitionKey");
taskQuery.processDefinitionKey(processDefinitionKey);
List<Task> list = taskQuery.list();
List<OrderCustom> orderList = new ArrayList<OrderCustom>();
for (Task task : list) {
OrderCustom orderCustom = new OrderCustom();
//下边的代码同采购单处理列表代码...
// 流程实例id
String processInstanceId = task.getProcessInstanceId();
// 根据流程实例id找到流程实例对象
ProcessInstance processInstance = runtimeService
.createProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
// 从流程实例对象中获取businessKey
String businessKey = processInstance.getBusinessKey();
// 根据businessKey查询业务系统
// 采购单id
String orderId = businessKey;
PurBusOrder purBusOrder = purBusOrderMapper
.selectByPrimaryKey(orderId);
// 获取采购单名称、采购金额等采购单信息
// 将purBusOrder内容拷贝到orderCustom
BeanUtils.copyProperties(purBusOrder, orderCustom);
// 下边向orderCustom开始设置任务信息
// 任务id、任务标识 、任务名称
// 任务id
orderCustom.setTaskId(task.getId());
// 任务标识
orderCustom.setTaskDefinitionKey(task.getTaskDefinitionKey());
// 任务名称
orderCustom.setTaskName(task.getName());
orderList.add(orderCustom);
}
return orderList;
}
查询组任务方法:
代码基本上同采购单处理列表的代码:
// 采购单组任务列表
@RequestMapping("/orderGroupTaskList")
public String orderGroupTaskList(HttpSession session, Model model)
throws Exception {
// 当前登陆用户
ActiveUser activeuser = UserUtil.getUserFromSession(session);
// 用户id
String userId = activeuser.getUserid();
List<OrderCustom> list = orderService.findOrderGroupTaskList(userId);
model.addAttribute("list", list);
return "order/orderGroupTaskList";
}
接口功能:拾取组任务
接口参数:taskId任务id,candidateUserId候选人
接口实现 :
调用taskService,指定组任务id和candidateUserId候选人。
拾取任务之前需要校验候选人是否资格拾取该组任务。
@Override
public void saveClaimTask(String taskId, String candidateUserId)
throws Exception {
// 根据候选人和组任务id查询,如果有记录说明该 候选人有资格拾取该 任务
Task task = taskService.createTaskQuery().taskId(taskId)
.taskCandidateUser(candidateUserId).singleResult();
if (task != null) {
// 任务拾取
taskService.claim(taskId, candidateUserId);
System.out.println("任务拾取成功");
}
}
拾取组任务方法:
需要从页面传入taskId组任务id.
// 拾取组任务
@RequestMapping("/claimTask")
public String claimTask(HttpSession session, String taskId)
throws Exception {
// 当前登陆用户
ActiveUser activeuser = UserUtil.getUserFromSession(session);
// 用户id
String userId = activeuser.getUserid();
orderService.saveClaimTask(taskId, userId);
//返回采购单组任务列表
return "redirect:orderGroupTaskList.action";
}
修改组任务列表页面,添加“拾取组任务”连接:
1.2 测试
测试注意点:
1、组任务(使用候选组)
准备组和用户的数据,调用activiti的api设置组、用户、组和用户关系信息
正式开发,将业务系统 用户角色数据实时同步到activiti中。
2、测试组任务办理流程
a>查询组任务功能
b>拾取组任务功能
3、测试排他网关
修改原来的功能是否存在bug。
4、测试并行网关
结算功能和入库功能是否并行执行.
11 总结
什么是工作流?
工作流是通过计算机自动管理业务流程,实现多个参与者按照预定义的流程自动执行业务流程。
什么是activiti?
Activiti是一个工作流的引擎(框架,jar、组件),对业务流程的自动化管理。Activiti按照bpmn2.0标准进行流程定义,按照定义流程(bpmn文件) 去自动执行业务流程。
第一步:线下进行流程定义
Activiti按照bpmn2.0标准进行流程定义,定义文件包括 .bpmn和.png,其中.bpmn是必须的文件。
第二步:进行流程定义部署
将线下流程定义文件.bpmn部署到activiti的数据库中。这样activiti方可按照定义流程(bpmn文件) 去自动执行业务流程。
两种方法部署方法:
1、 单个文件部署方法
2、 Zip包部署方法
建议使用单个文件 部署,建议一次部署只部署一个流程定义 。
第三步:启动一个流程 实例
流程定义和流程实例 的区别:
流程定义 是一个静态文件(.bpmn),流程实例是动态的流程执行过程。如果要activiti去管理业务流程的执行,需要首先发起一个流程实例 。
第四步:查询待办任务
个人任务:
通过固定设置方法或UEL表达式设置方法设置task结点的assignee属性。
组任务:
通过设置多个候选人或多个候选组的方法。
组任务常用,组任务中以candidate-group候选组方式最常用。
组任务办理过程:
通过候选人查询任务
拾取任务
同个人任务办理流程。
第五步:办理任务
流程的执行可能需要通过流程变量决定执行分支。
流程变量:
常用全局变量
需要在启动流程实例 或完成任务时设置流程变量
在UEL表达式中使用流程变量
网关:
排他网关:
经过排他网关的分支只有一条。
并行网关:
经过并行网关分支结点所有分支不管条件是否满足都 会经过并行网关的汇聚结点。
并行网关常用于会签任务(多个用户共同办理的任务)
包含网关:
经过包含网关分支结点,只有满足条件的分支才经过包含网关的汇聚结点。
第六步:流程完成
所有结点完成执行完成,流程自动完成。
注意:如果使用并行网关或包含网关,必须经过分支的流程全部执行完成才能到达汇聚结点,并行网关或包含风关就结束。