一、什么是流程变量
流程变量在 activiti 中是一个非常重要的角色,流程运转有时需要靠流程变量,业务系统和 activiti结合时少不了流程变量,流程变量就是 activiti 在管理工作流时根据管理需要而设置的变量。
比如在请假流程流转时如果请假天数大于 3 天则由总经理审核,否则由人事直接审核,请假天数就可以设置为流程变量,在流程流转时使用。
注意:虽然流程变量中可以存储业务数据可以通过 activiti 的 api 查询流程变量从而实现 查询业务数据,但是不建议这样使用,因为业务数据查询由业务系统负责,activiti 设置流程变量是为了流程执行需要而创建。
二、流程变量类型
注意:如果将 pojo 存储到流程变量中,必须实现序列化接口 serializable,为了防止由于新增字段无法反序列化,需要生成 serialVersionUID。
三、流程变量作用域
流程变量的作用域默认是一个流程实例(processInstance),也可以是一个任务(task)或一个执行实例(execution),这三个作用域流程实例的范围最大,可以称为 global 变量,任务和执行实例仅仅是针对一个任务和一个执行实例范围,范围没有流程实例大,称为 local 变量。
如下图:
- global 变量中变量名不允许重复,设置相同名称的变量,后设置的值会覆盖前设置的变量值。
- Local 变量由于在不同的任务或不同的执行实例中,作用域互不影响,变量名可以相同没有影响。
- Local 变量名也可以和 global 变量名相同,没有影响。
四、流程变量使用方法
第一步:设置流程变量
第二步:通过 UEL 表达式使用流程变量
1、 可以在 assignee 处设置 UEL 表达式,表达式的值为任务的负责人
比如:${assignee},assignee 就是一个流程变量名称
Activiti 获取 UEL 表达式的值 ,即流程变量 assignee 的值 ,将 assignee 的值作为任务的负责人进行任务分配
2、 可以在连线上设置 UEL 表达式,决定流程走向
比如:${price>=10000}和${price<10000}: price 就是一个流程变量名称,uel 表达式结果类型为布尔类型
如果 UEL 表达式是 true,要决定 流程执行走向。
五、使用 Global 变量控制流程
5.1需求
员工创建请假申请单,由部门经理审核,部门经理审核通过后请假 3 天及以下由人事经理直接审核,3 天以上先由总经理审核,总经理审核通过再由人事经理存档。
5.2 流程定义
5.3设置global
在部门经理审核前设置流程变量,变量值为请假单信息(包括请假天数),部门经理审核后可以根据流程变量的值决定流程走向。
5.3.1 启动流程时设置
在启动流程时设置流程变量,变量的作用域是整个流程实例。
通过 map
//启动流程实例,同时还要设置流程变量的值
// act_ge_bytearray
// act_ru_variable
@Test
public void process1( ) {
//1.得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//2.得到RuntimeService
RuntimeService runtimeService = processEngine.getRuntimeService();
//3.流程定义的key问题 myProcess_1
String key = "holiday";
Map<String ,Object> map = new HashMap<>();
Holiday holiday = new Holiday();
holiday.setNum(5F);
map.put("holidayObject",holiday);
//4.启动流程实例,并且设置流程变量的值
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(key, map);
//5.输出实例信息
System.out.println(processInstance.getName());
System.out.println(processInstance.getProcessDefinitionId());
}
5.3.2 任务办理时设置流程变量
在完成任务时设置流程变量,该流程变量只有在该任务完成后其它结点才可使用该变量,它的作用域是整个流程实例,如果设置的流程变量的 key 在流程实例中已存在相同的名字则后设置的变量替换前边设置的变量。
这里需要在创建请假单任务完成时设置流程变量。
//完成任务 zhangsan -----lishi----判断流程变量的请假天数,1天----分支:人事经理存档(zhaoliu)
@Test
public void variable2() {
//1.得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//2.得到TaskService
TaskService taskService = processEngine.getTaskService();
//3.查询当前用户是否有任务
String key = "holiday";
Task task = taskService.createTaskQuery().processDefinitionKey(key)
.taskAssignee("zhangsan").singleResult();
//初始化一些参数
Map<String ,Object> map = new HashMap<>();
Holiday holiday = new Holiday();
holiday.setNum(5F);
map.put("holiday",holiday);
//4.判断task!=null,说明当前用户有任务
if(task!=null){
taskService.complete(task.getId(),map);//完成任务时,设置流程变量的值
System.out.println("任务执行完毕");
}
}
5.3.3 通过当前流程实例设置
通过流程实例 id 设置全局变量,该流程实例必须未执行完成。
// 通过流程实例id,来测试流程变量
public void variable3() {
//1.得到ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//2.得到RuntimeService
RuntimeService runtimeService = processEngine.getRuntimeService();
//3.流程定义的key问题 myProcess_1
//Map<String ,Object> map = new HashMap<>();
Holiday holiday = new Holiday();
holiday.setNum(5F);
// map.put("holiday",holiday);
//4.通过实例id,来设置流程变量
//第一个参数:流程实例的id
//第二个参数:流程变量名
//第三个变量:流程变量名,所对应的值
runtimeService.setVariable("2501","holiday",holiday);
}
注意:
executionId 必须当前未结束 流程实例的执行 id,通常此 id 设置流程实例 的 id。
也可以通过 runtimeService.getVariable()获取流程变量
5.3.4 通过当前任务设置
// 通过任务id设置流程变量,来测试流程变量
public void variable4(){
//当前待办任务id
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
String taskId="1404";
TaskService taskService = processEngine.getTaskService();
Holiday holiday = new Holiday();
holiday.setNum(3F);
//通过任务设置流程变量
taskService.setVariable(taskId, "holiday", holiday);
//一次设置多个值
//taskService.setVariables(taskId, variables)
}
注意:
任务id必须是当前待办任务id,act_ru_task中存在。如果该任务已结束,报错:
也可以通过 taskService.getVariable()获取流程变量。
六、设置 local 流程变量
Local 变量在任务结束后无法在当前流程实例执行中使用,如果后续的流程执行需要用到此变量则会报错。
6.1 办理任务时设置
任务办理时设置 local 流程变量,当前运行的流程实例只能在该任务结束前使用,任务结束该变量无法在当前流程实例使用,可以通过查询历史任务查询。
// 办理任务时设置local流程变量
@Test
public void variable1() {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//任务id
String taskId = "";
TaskService taskService = processEngine.getTaskService();
// 定义流程变量
Map<String, Object> variables = new HashMap<String, Object>();
Holiday holiday = new Holiday();
holiday.setNum(3F);
//变量名是holiday,变量值是holiday对象
variables.put("holiday", holiday);
// 设置local变量,作用域为该任务
taskService.setVariablesLocal(taskId, variables);
taskService.complete(taskId);
}
说明:
设置作用域为任务的 local 变量,每个任务可以设置同名的变量,互不影响。
6.2通过当前任务设置
//通过当前任务设置流程变量local
@Test
public void variable2() {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
//当前待办任务id
String taskId = "1404";
TaskService taskService = processEngine.getTaskService();
Holiday holiday = new Holiday();
holiday.setNum(3f);
//通过任务设置流程变量
taskService.setVariableLocal(taskId, "holiday", holiday);
//一次设置多个值
//taskService.setVariablesLocal(taskId, variables)
}