工作流---流程变量

一：简介
流程变量就是if(条件)中使用到的变量用于参与条件表达式的计算。

变量都是有作用域的，在程序中方法内部的变量是属于局部变量，方法外的变量属于全局变量，同样流程变量也分全局变量global（作用在整个流程实例范围）和本地变量local（作用在单个任务或者单个执行实例）。

二：流程变量设置时机
2.1 启动实例时设置为全局变量

runtimeService.startProcessInstanceByKey(key, map);
1

2.2 任务办理时设置变量
在完成任务时设置流程变量，该流程变量只有在该任务完成后其它结点才可使用该变量，它的作用域是整个流程实例，如果设置的流程变量的key在流程实例中已存在相同的名字则后设置的变量替换前边设置的变量。

String assingee = "张三";
Task task = taskService.createTaskQuery()
                .processDefinitionKey(key)
                .taskAssignee(assingee)
                .singleResult();
if(task != null){
    //完成任务时为以后的节点设置流程变量的值
    taskService.complete(task.getId(),map);
}
1
2
3
4
5
6
7
8
9

2.3 通过流程实例设置变量
通过流程实例id设置全局变量，该流程实例必须未执行完成。executionId必须当前未结束的流程实例执行id，通常此id设置流程实例的id。也可以通runtimeService.getVariable()获取流程变量。

@Test
public void setGlobalVariableByExecutionId(){
    String executionId="2601";
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

    RuntimeService runtimeService = processEngine.getRuntimeService();
    Evection evection = new Evection();
    evection.setNum(3d);
//      通过流程实例 id设置流程变量
    runtimeService.setVariable(executionId, "evection", evection);
//      一次设置多个值
//      runtimeService.setVariables(executionId, variables)
}
1
2
3
4
5
6
7
8
9
10
11
12
13

2.4 通过当前任务设置变量

@Test
public void setGlobalVariableByTaskId(){
	String taskId="1404";
	ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
	TaskService taskService = processEngine.getTaskService();
	Evection evection = new Evection();
	evection.setNum(3);
	//通过任务设置流程变量
	taskService.setVariable(taskId, "evection", evection);
	//一次设置多个值 
	//taskService.setVariables(taskId, variables)
}
1
2
3
4
5
6
7
8
9
10
11
12

2.5 办理任务前设置局部变量
任务办理时设置local流程变量，当前运行的流程实例只能在该任务结束前使用，任务结束该变量无法在当前流程实例使用，可以通过查询历史任务查询。

//  设置local变量，作用域为该任务
Map<String, Object> variables = new HashMap<>();
// 设置单个
taskService.setVariableLocal(taskId, "xxx", evection);
// 设置多个
taskService.setVariablesLocal(taskId, variables);
taskService.complete(taskId);
1
2
3
4
5
6
7

总结：
设置流程变量可以通过：
（1）启动流程时设置（全局变量）
（2）任务办理完成时设置（全局变量，只对后面的任务生效）
（3）通过流程实例设置变量（全局变量）
（4）通过当前任务设置变量（全局变量）
（5）设置局部变量需要加local（setVariablesLocal）（局部变量）