Activiti系列六: 流程变量

1. 流程图

2. 流程变量介绍

流程变量在整个工作流中扮演很重要的作用。例如：请假流程中有请假天数、请假原因等一些参数都为流程变量的范围。流程变量的作用域范围是只对应一个流程实例。也就是说各个流程实例的流程变量是不相互影响的。流程实例结束完成以后流程变量还保存在数据库中（存放到流程变量的历史表中）。

例如：

即：

3. 设置流程节点中定义的变量

如图，我们可以动态设置办理人:

代码实例如下：

在启动流程实例的时候设置

//开始流程
	public void startProcess(String deployId){
		ProcessEngine engine=ProcessEngines.getDefaultProcessEngine();
		RepositoryService repService=engine.getRepositoryService();
		//根据id查询具体的流程定义对象
		ProcessDefinition theDef=repService.createProcessDefinitionQuery().deploymentId(deployId).singleResult();
		//获得流程执行服务类对象
		RuntimeService runServ=engine.getRuntimeService();
		//启动流程的时候【动态设置每个步骤的执行人】,map的key值需要与Leave.bpmn中对应
		Map<String, Object> variables=new HashMap<String, Object>();
		variables.put("user1", "波波");
		variables.put("user2", "老谢");
		//启动流程得到流程实例,对应act_ru_execution表
		ProcessInstance pi= runServ.startProcessInstanceById(theDef.getId(), variables);
		System.out.println("流程实例id:"+pi.getId()+","+pi.getActivityId());
	}

注意，代码中的user1要和上图中的${user1}对应起来

4. 定义流程实例中的流程变量

(1) taskService设置方式

获取：

(2) RuntimeService设置方式

//查询当前是谁执行的流程并执行
	public void queryAndExecTasks(String deployId){
		ProcessEngine engine=ProcessEngines.getDefaultProcessEngine();
		//获得流程执行服务类对象
		RuntimeService runServ=engine.getRuntimeService();
		//获得任务管理服务类对象
		TaskService taskServ=engine.getTaskService();
		TaskQuery taskQuery= taskServ.createTaskQuery().deploymentId(deployId);
		List<Task> taskList=taskQuery.orderByTaskCreateTime().asc().list();
		for(Task task:taskList){
			if(task.getTaskDefinitionKey().equals("leaveApply01")){
				System.out.println("当前进行流程第一步,进行第一步流程变量定义");
				LeaveVariableEntity variableEntity=new LeaveVariableEntity();
				variableEntity.setLeavePerson(task.getAssignee());
				variableEntity.setReason("回家结婚");
				variableEntity.setHours(8);
				runServ.setVariable(task.getProcessInstanceId(), "leave01", variableEntity);
			}
			if(task.getTaskDefinitionKey().equals("managerApprove02")){
				System.out.println("当前进行流程第二步,获取上一步流程变量");
				LeaveVariableEntity processVariableEntity=runServ.getVariable(task.getProcessInstanceId(), "leave01", LeaveVariableEntity.class);
				System.out.println("请假人:"+processVariableEntity.getLeavePerson()+",原因:"+processVariableEntity.getReason()+",请假时间:"+processVariableEntity.getHours());
			}
			System.out.println("taskId:"+task.getId()+",taskName:"+task.getName()+",办理人assinger:"+task.getAssignee());
			
			
		}
	}

RuntimeService 和TaskService 获取和设置流程变量方式差不多

RuntimeService 与流程实例及执行对象相关，对于的表是：act_ru_execution
TaskService 与任务相关对应的表是act_ru_variable
使用基本类型获取流程变量，在taskService中使用任务ID，流程变量的名称，获取流程变量的值。
Javabean类型设置获取流程变量，除了需要这个javabean实现了Serializable接口外，还要求流程变量对象的属性不能发生变化，否则抛出异常。解决方案，固定序列化ID

5. 查询历史的流程变量

说明：

1）历史的流程变量查询，指定流程变量的名称，查询act_hi_varinst表（也可以针对，流程实例ID，执行对象ID，任务ID查询）

6. 流程变量的支持的类型

如图是从官网列出来的流程变量的类型：

从图中可以看出包括了大部分封装类型和Date、String和实现了Serializable接口的类的类型。

7. 总结

1：流程变量

在流程执行或者任务执行的过程中，用于设置和获取变量，使用流程变量在流程传递的过程中传递业务参数。

对应的表：

act_ru_variable：正在执行的流程变量表

act_hi_varinst：流程变量历史表

2：扩展知识：setVariable和setVariableLocal的区别

setVariable：设置流程变量的时候，流程变量名称相同的时候，后一次的值替换前一次的值，而且可以看到TASK_ID的字段不会存放任务ID的值

setVariableLocal：

1：设置流程变量的时候，针对当前活动的节点设置流程变量，如果一个流程中存在2个活动节点，对每个活动节点都设置流程变量，即使流程变量的名称相同，后一次的版本的值也不会替换前一次版本的值，它会使用不同的任务ID作为标识，存放2个流程变量值，而且可以看到TASK_ID的字段会存放任务ID的值

例如act_hi_varinst 表的数据：不同的任务节点，即使流程变量名称相同，存放的值也是不同的。

如图：

2：还有，使用setVariableLocal说明流程变量绑定了当前的任务，当流程继续执行时，下个任务获取不到这个流程变量（因为正在执行的流程变量中没有这个数据），所有查询正在执行的任务时不能查询到我们需要的数据，此时需要查询历史的流程变量。