在这里我们要介绍两种流程变量。
- 全局变量,globle variable
- 局部变量,local variable
先说一下我自己对这两种变量的理解。
全局变量:当启动一个流程实例以后,在整个流程的生命周期都起作用的。
局部变量:只在某一个流程实例的某一个任务节点起作用的变量。
接下来就按照之前的流程部署,部署一个流程。
全局变量
全局变量的设置我自己总结了有四种方式。
-
启动流程的时候指定流程变量。通过RuntimeService.startInstanceById(processDefinitionId,Map<String,Object> map)这个方法,其中map就是将要设置的全局变量。
/**
* 启动一个流程实例,并同时设置全局变量
* @param tianshu 请假天数
*/
@Override
public void startProcessInstance(int tianshu){
//查询流程定义
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().processDefinitionKey("holiday3").singleResult();
//定义全局变量
Map<String,Object> variables = new HashMap<>();
variables.put("tianshu",tianshu);
//启动流程,并设置全局流程变量
runtimeService.startProcessInstanceById(processDefinition.getId());
}
启动流程后可以看到数据库表,act_run_variable多了一条记录。- 通过runtiimeservice.setVariable/s()。如果是添加一个变量用setVariable,多个变量用setVariables。通过这个方法也可以对前面启动流程时设置的全局变量进行修改。
/**
* 在流程运行时设置全局变量
* @param variables 全局流程变量
* @param processInstanceId 流程实例id
*/
@Override
public void setGlobleVariables(Map<String,Object> variables,String processInstanceId) {
runtimeService.setVariables(processInstanceId,variables);
}
- 用户完成任务的时候指定,taskService.complate(taskId,map变量)
/**
* 用户完成任务的时候指定全局变量
* @param variables 全局流程变量
* @param taskId 用户任务id
*/
@Override
public void setVariablesWhenComplateUserTast(Map<String,Object> variables,String taskId) {
taskService.complete(taskId,variables);
}
- 用户任务上指定变量,taskService.setVariable/s()
/**
* 用户任务上指定变量
* @param variables
* @param taskId
*/
@Override
public void setVariablesOnUserTask(Map<String,Object> variables,String taskId) {
taskService.setVariables(taskId,variables);
}
局部变量
局部变量的使用与全局变量的使用非常相似,主要的区别在于变量的作用域不同。局部变量只做用于当前用户流程节点。设置局部变量有两种方式。
- 根据用户任务id直接设置
/**
* 在用户的任务流程节点上设置局部变量
* 局部变量的作用域为当前的流程节点
* @param variables 局部变量
* @param taskId 任务id
*/
@Override
public void setLocalVariablesOnUserTask(Map<String,Object> variables,String taskId) {
taskService.setVariablesLocal(taskId,variables);
}
- 完成任务时设置
/**
* 在用户完成任务流程时设置局部变量
* 局部变量的作用域为当前的流程节点
* @param variables 局部变量
* @param taskId 任务id
*/
@Override
public void complateAndSetLocalVariablesOnUserTask(Map<String,Object> variables,String taskId) {
//第三个参数表示,变量为局部变量
taskService.complete(taskId,variables,true);
}
注意
1、数据库表数据变化,act_ru_variable
2、流程必须是未完成状态
3、UEL表达式中的流程变量不存在则报错
4、如果UEL表达式中流程 变量值为NULL,流程不按UEL表达式执行,而流程结束
5、UEL表达式都不符合条件,流程结束
6、如果连线不设置条件,会flow符号小的那条线