Activiti工作流笔记
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 variables = new HashMap();
// 流程 变更名称是assignee，流程变量值是"张三"
variables.put("assignee", "张三");
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey, variables); 2.5.2 在完成任务时设置流程变量（常用）
在完成任务时设置流程变量，在该 任务的后续结点可以使用该 变量，变量的作用域还是整个流程实例 。
//完成任务时设置流程变量
Map variables = new HashMap();
// 流程 变更名称是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
varaibles.put("order", orderCustom);
taskService.complete(taskId, varaibles);
4 设置局部变量
4.1 在任务完成设置局部变量
在任务完成时设置局部变量，任务完成后，后续结点无法使用局部变量。
// 完成任务时设置流程变量，使用pojo
OrderCustom orderCustom = new OrderCustom();
orderCustom.setPrice(10000f);
Map
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
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
variables.put("order", orderCustom);
// 设置流程变量，值 为采购单信息
taskService.complete(taskId,variables);
// System.out.println("完成任务：" + taskId);
}
修改 service中采购单审核方法：
设置流程变量：firstAudit、secondAudit、thirdAudit
if (task != null) {
// 说明assignee是该任务的办理人，有权限完成
Map
//根据 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
注意：查询组任务，必须指定 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
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
List
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
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表达式中使用流程变量
网关：
排他网关：
经过排他网关的分支只有一条。
并行网关：
经过并行网关分支结点所有分支不管条件是否满足都 会经过并行网关的汇聚结点。
并行网关常用于会签任务（多个用户共同办理的任务）
包含网关：
经过包含网关分支结点，只有满足条件的分支才经过包含网关的汇聚结点。
第六步：流程完成
所有结点完成执行完成，流程自动完成。
注意：如果使用并行网关或包含网关，必须经过分支的流程全部执行完成才能到达汇聚结点，并行网关或包含风关就结束。