activiti 7 + springboot2（九） 流程变量的使用
（一）基本概念
流程变量就是activiti在管理工作流时根据管理需要而设置的变量。比如在请假流程流转时如果请假天数大于3天则由总经理审核，否则由人事直接审核，请假天数就可以设置为流程变量，在流程流转时使用。
（二）作用域
流程变量的作用域默认是一个流程实例(processInstance)，也可以是一个任务(task)或一个执行实例(execution)，这三个作用域流程实例的范围最大，可以称为global变量，任务和执行实例仅仅是针对一个任务和一个执行实例范围，范围没有流程实例大，称为local变量。
（三）变量类型
| string | java.lang.String |
| integer | java.lang.Integer |
| short | java.lang.Short |
| long | java.lang.Long |
| double | java.lang.Double |
| date | java.lang.Date |
| binary | byte[] |
| serializable | java.lang.Serializable 实现 |
（四）使用方法
1）设置流程变量
2）通过UEL表达式使用流程变量
- 可以在assignee处设置UEL表达式，表达式的值为任务的负责人，比如：${assignee}，assignee就是一个流程变量名称，Activiti获取UEL表达式的值，即流程变量assignee的值，将assignee的值作为任务的负责人进行任务分配。
- 可以在连线上设置UEL表达式，决定流程走向，比如：${price>=10000}和${price<10000}:price就是一个流程变量名称，uel表达式结果类型为布尔类型，如果UEL表达式是true，要决定流程执行走向。
（五）使用Global变量控制流程
流程：员工创建请假申请单，由部门经理审核，部门经理审核通过后请假3天及以下由人事直接审核，3天以上先由总经理审核，总经理审核通过再由人事审核存档。
测试代码：
package com.activiti.example; import java.io.Serializable; import java.util.Date; /** * 请假实体 * 必须实现序列化接口serializable，为了防止由于新增字段无法反序列化，需要生成serialVersionUID */ public class Holiday implements Serializable { private static final long serialVersionUID = 373046364072498634L; private Integer id; /** * 申请人的名字 */ private String holidayName; /** * 开始时间 */ private Date beginDate; /** * 结束日期 */ private Date endDate; /** * 请假天数 */ private Float days; /** * 事由 */ private String reason; /** * 请假类型 */ private String type; public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getHolidayName() { return holidayName; } public void setHolidayName(String holidayName) { this.holidayName = holidayName; } public Date getBeginDate() { return beginDate; } public void setBeginDate(Date beginDate) { this.beginDate = beginDate; } public Date getEndDate() { return endDate; } public void setEndDate(Date endDate) { this.endDate = endDate; } public Float getDays() { return days; } public void setDays(Float days) { this.days = days; } public String getReason() { return reason; } public void setReason(String reason) { this.reason = reason; } public String getType() { return type; } public void setType(String type) { this.type = type; } }
1）启动流程时设置
在启动流程时设置流程变量，变量的作用域是整个流程实例。通过map<key,value>设置流程变量，map中可以设置多个变量，这个key就是流程变量的名字。
/** * 启动一个实例 * 动态设置设置assignee和假期变量 */ @Test public void startProcessInstance() { Holiday holiday = new Holiday(); holiday.setDays(5F); Map<String, Object> variables = new HashMap<>(); //设置assignee variables.put("user1","张三"); variables.put("user2","李四"); variables.put("user3","王五"); //定义流程变量holiday variables.put("holiday", holiday); //启动流程实例，同时还要设置流程定义的变量值 ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("myProcess_1", variables); System.out.println("流程实例id：" + processInstance.getProcessInstanceId()); }
2）任务办理时设置
/** * 完成任务 */ @Test public void completeTask() { String assignee = "张三"; Task task = taskService.createTaskQuery().processDefinitionKey("myProcess_1").taskAssignee(assignee).singleResult(); Holiday holiday = new Holiday(); holiday.setDays(4F); //初始化一些参数 Map<String, Object> map = new HashMap<>(); map.put("holiday", holiday); if (task != null) { taskService.complete(task.getId(), map);//完成任务时，设置流程变量的值 System.out.println("任务执行完毕"); } }
3）通过当前流程实例设置
executionId必须当前未结束流程实例的执行id，通常此id设置流程实例的id。也可以通过runtimeService.getVariable()获取流程变量。
/** * 通过当前流程实例设置变量 */ @Test public void setGlobalVariableByExecutionId() { String executionId = "9d5079d9-38e3-11ea-903f-30b49ec7161f"; Holiday holiday = new Holiday(); holiday.setDays(3F); runtimeService.setVariable(executionId, "holiday", holiday); System.out.println(runtimeService.getVariable(executionId, "holiday")); }
4）通过当前任务设置
@Test public void setGlobalVariableByTaskId() { String taskId = "73eb4a5b-38e4-11ea-ba62-30b49ec7161f"; Holiday holiday = new Holiday(); holiday.setDays(5F); Map<String, Object> variables = new HashMap<>(); variables.put("holiday", holiday); taskService.setVariable(taskId, "holiday", holiday); System.out.println(taskService.getVariable(taskId, "holiday")); }
（六）设置local流程变量
1）任务办理时设置
任务办理时设置local流程变量，当前运行的流程实例只能在该任务结束前使用，任务结束该变量无法在当前流程实例使用，可以通过查询历史任务查询。
设置作用域为任务的local变量，每个任务可以设置同名的变量，互不影响。
/** * 任务完成时,设置local变量，作用域为该任务 */ @Test public void completeTaskLocal() { String taskId = "73eb4a5b-38e4-11ea-ba62-30b49ec7161f"; Map<String, Object> variables = new HashMap<>(); Holiday holiday = new Holiday(); holiday.setDays(3F); variables.put("holiday", holiday); //设置local变量，作用域为该任务 taskService.setVariablesLocal(taskId, variables); taskService.complete(taskId); }
（七）查询历史流程变量
/** * 查询历史流程变量 */ @Test public void queryHistoricLocalVariables() { HistoricTaskInstanceQuery historicTaskInstanceQuery = historyService.createHistoricTaskInstanceQuery(); List<HistoricTaskInstance> list = historicTaskInstanceQuery.includeTaskLocalVariables() .finished().list(); for (HistoricTaskInstance hti : list) { System.out.println("============================"); System.out.println("任务id:" + hti.getId()); System.out.println("任务名称:" + hti.getName()); System.out.println("任务负责人:" + hti.getAssignee()); System.out.println("任务local变量：" + hti.getTaskLocalVariables()); } }
