（六）、Activiti 流程变量
（六）、Activiti 流程变量
一、什么是流程变量
官网介绍： https://www.activiti.org/userguide/#apiVariables
流程变量在 activiti 中是一个非常重要的角色，流程运转有时需要靠流程变量，业务系统和 activiti结合时少不了流程变量，流程变量就是 activiti 在管理工作流时根据管理需要而设置的变量。
比如在请假流程流转时如果请假天数大于 3 天则由总经理审核，否则由人事直接审核，请假天数就可以设置为流程变量，在流程流转时使用。
注意：虽然流程变量中可以存储业务数据可以通过 activiti 的 api 查询流程变量从而实现 查询业务数据，但是不建议这样使用，因为业务数据查询由业务系统负责，activiti 设置流程变量是为了流程执行需要而创建。
二、流程变量类型
String、Integer、short、long、double、boolean、date、binary、serializable。
注意：如果将 pojo 存储到流程变量中，必须实现序列化接口 serializable，为了防止由于新增字段无法反序列化，需要生成 serialVersionUID。
三、流程变量作用域
流程变量的作用域默认是一个流程实例(processInstance)，也可以是一个任务(task)或一个执行实例(execution)，这三个作用域流程实例的范围最大，可以称为 global 变量，任务和执行实例仅仅是针对一个任务和一个执行实例范围，范围没有流程实例大，称为 local 变量。
- global 变量中变量名不允许重复，设置相同名称的变量，后设置的值会覆盖前设置的变量值。
- Local 变量由于在不同的任务或不同的执行实例中，作用域互不影响，变量名可以相同没有影响。
- Local 变量名也可以和 global 变量名相同，没有影响。
四、流程变量使用方法
- 第一步：设置流程变量
- 第二步：通过 UEL 表达式使用流程变量
可以在 assignee 处设置 UEL 表达式，表达式的值为任务的负责人。比如：${assignee}，assignee 就是一个流程变量名称
Activiti 获取 UEL 表达式的值 ，即流程变量 assignee 的值 ，将 assignee 的值作为任务的负责人进行任务分配
可以在连线上设置 UEL 表达式，决定流程走向。
比如：${price>=10000}和${price<10000}: price 就是一个流程变量名称，uel 表达式结果类型为布尔类型。如果 UEL 表达式是 true，要决定 流程执行走向。
1、在启动流程时设置流程变量，变量的作用域是整个流程实例。
通过 map设置流程变量，map 中可以设置多个变量，这个 key 就是流程变量的名字。
//启动流程实例，同时还要设置流程变量的值
// 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(5);
map.put("holidayObject",holiday);
//4.启动流程实例，并且设置流程变量的值
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(key, map);
//5.输出实例信息
System.out.println(processInstance.getName());
System.out.println(processInstance.getProcessDefinitionId());
}
2、任务办理时设置流程变量
在完成任务时设置流程变量，该流程变量只有在该任务完成后其它结点才可使用该变量，它的作用域是整个流程实例，如果设置的流程变量的 key 在流程实例中已存在相同的名字则后设置的变量替换前边设置的变量。
这里需要在创建请假单任务完成时设置流程变量。
@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(5);
map.put("holiday",holiday);
//4.判断task!=null,说明当前用户有任务
if(task!=null){
taskService.complete(task.getId(),map);//完成任务时，设置流程变量的值
System.out.println("任务执行完毕");
}
}
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(5);
// map.put("holiday",holiday);
//4.通过实例id,来设置流程变量
//第一个参数：流程实例的id
//第二个参数：流程变量名
//第三个变量：流程变量名，所对应的值
runtimeService.setVariable("2501","holiday",holiday);
}
也可以通过 runtimeService.getVariable()获取流程变量
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)
}
五、设置 local 流程变量
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 变量，每个任务可以设置同名的变量，互不影响。
六、数据库表操作
设置流程变量会在当前执行流程变量表，同时也会在历史执行变量表插入记录。
# 当前正在执行的流程变量表
SELECT * FROM act_ru_variable
# 历史执行流程变量表
SELECT * FROM act_hi_varinst
