流程变量
1流程变量的作用域范围是只对应一个流程实例。所以只要设置就行了,不用管在哪个阶段设置
2各个流程实例的流程变量是不相互影响的。
3流程实例结束完成以后流程变量还保存在数据库中(存放到流程变量的历史表中)。
4基本类型设置流程变量,在taskService中使用任务ID,定义流程变量的名称,设置流程变量的值。
5Javabean类型设置流程变量,需要这个javabean实现了Serializable接口
6设置流程变量的时候,向act_ru_variable这个表添加数据
7RuntimeService对象可以设置流程变量和获取流程变量
8TaskService对象可以设置流程变量和获取流程变量
9流程实例启动的时候可以设置流程变量
10任务办理完成的时候可以设置流程变量
11流程变量可以通过名称/值的形式设置单个流程变量
12流程变量可以通过Map集合,同时设置多个流程变量,key表示流程变量的名称,value表示流程变量的值
变量的类型:
这里写图片描述
影响的表
act_ru_variable:正在执行的流程变量表
act_hi_varinst:流程变量历史表
setVariable和setVariableLocal的区别
setVariable:设置流程变量的时候,流程变量名称相同的时候,后一次的值替换前一次的值,而且可以看到TASK_ID的字段不会存放任务ID的值
setVariableLocal:
1:设置流程变量的时候,针对当前活动的节点设置流程变量,如果一个流程中存在2个活动节点,对每个活动节点都设置流程变量,即使流程变量的名称相同,后一次的版本的值也不会替换前一次版本的值,它会使用不同的任务ID作为标识,存放2个流程变量值,而且可以看到TASK_ID的字段会存放任务ID的值
2:还有,使用setVariableLocal说明流程变量绑定了当前的任务,当流程继续执行时,下个任务获取不到这个流程变量(因为正在执行的流程变量中没有这个数据),所有查询正在执行的任务时不能查询到我们需要的数据,此时需要查询历史的流程变量。

流程变量api

/**流程变量api*/
    public void setAndGetVariables(){
        /**与流程实例,执行对象(正在执行)*/
        RuntimeService runtimeService = processEngine.getRuntimeService();
        /**与任务(正在执行)*/
        TaskService taskService = processEngine.getTaskService();

        /**设置流程变量*/
        //表示使用执行对象ID,和流程变量的名称,设置流程变量的值(一次只能设置一个值)
//      runtimeService.setVariable(executionId, variableName, value)
        //表示使用执行对象ID,和Map集合设置流程变量,map集合的key就是流程变量的名称,
        //map集合的value就是流程变量的值(一次设置多个值)
//      runtimeService.setVariables(executionId, variables)

//      taskService.setVariable(taskId, variableName, value)
//      taskService.setVariables(taskId, variables)
//      启动流程实例的同时,可以设置流程变量,用Map集合
//      runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);
//      完成任务的同时,设置流程变量,用Map集合
//      taskService.complete(taskId, variables)

        /**获取流程变量*/
        //使用执行对象ID和流程变量的名称,获取流程变量的值
//      runtimeService.getVariable(executionId, variableName);
        //使用执行对象ID,获取所有的流程变量,将流程变量放置到Map集合中,key就是流程变量的名称,
        //value就是流程变量的值
//      runtimeService.getVariables(executionId);
        //使用执行对象ID,获取流程变量的值,通过设置流程变量的名称存放到集合中,
        //获取指定流程变量名称的流程变量的值,值存放到Map集合中
//      runtimeService.getVariables(executionId, variableNames);



//      taskService.getVariable(taskId, variableName);
//      taskService.getVariables(taskId);
//      taskService.getVariables(taskId, variableNames);

    }

测试数据

/**部署流程定义*/
@Test
public void deploymentProcessDefinition1(){
    InputStream inputStreamBpmn = this.getClass().getResourceAsStream("askForLeave.bpmn");
    InputStream inputStreamPng = this.getClass().getResourceAsStream("askForLeave.png");
    Deployment deployment = processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service
            .createDeployment()// 创建一个部署对象
            .name("请假申请流程定义")// 添加部署的名称
            .addInputStream("askForLeave.bpmn", inputStreamBpmn)
            .addInputStream("askForLeave.png", inputStreamPng)
            .deploy();// 完成部署
    System.out.println("部署ID:"+deployment.getId());
    System.out.println("部署名称:"+deployment.getName());  
    System.out.println("部署时间:"+deployment.getDeploymentTime()); 
//    输出:
//    部署ID:1601
//    部署名称:请假申请流程定义
//    部署时间:Wed Sep 06 11:26:30 CST 2017
}

/**启动流程实例*/
@Test
public void startProcessInstance(){
    //流程定义的key.,key对应helloworld.bpmn文件中id的属性值,使用key值启动,默认是按照最新版本的流程定义启动
    String processDefinitionKey = "askForLeave";
    ProcessInstance pi = processEngine.getRuntimeService()//与正在执行的流程实例和执行对象相关的Service
                    .startProcessInstanceByKey(processDefinitionKey);//使用流程定义的key启动流程实例,
    System.out.println("流程实例ID:"+pi.getId());// 
    System.out.println("流程定义ID:"+pi.getProcessDefinitionId());// 
//  输出:
//    流程实例ID:1701
//    流程定义ID:askForLeave:9:1604
}

查看任务id
这里写图片描述

设置流程变量1


    @Test
    public void setVariables(){
        //影响的表
        //ACT_RU_VARIABLE  :正在执行的流程变量表
        //ACT_HI_VARINST:历史流程变量表
        /**与任务(正在执行)*/
        TaskService taskService = processEngine.getTaskService();
        //任务ID
        String taskId = "1704";
        /**一:设置流程变量,使用基本数据类型*/
        taskService.setVariableLocal(taskId, "请假天数", 2);//与任务ID绑定,绑定后就不能传递给下一个节点
        taskService.setVariable(taskId, "请假日期", new Date());//不和任务ID绑定,能传递给下一个节点
        taskService.setVariable(taskId, "请假原因", "准备结婚");//不和任务ID绑定,能传递给下一个节点
        System.out.println("设置流程变量成功!");
    }
    输出:
    设置流程变量成功!

/**获取流程变量*/
    @Test
    public void getVariables(){
        /**与任务(正在执行)*/
        TaskService taskService = processEngine.getTaskService();
        //任务ID
        String taskId = "1704";
        /**一:获取流程变量,使用基本数据类型*/
        Integer days = (Integer) taskService.getVariable(taskId, "请假天数");
        Date date = (Date) taskService.getVariable(taskId, "请假日期");
        String resean = (String) taskService.getVariable(taskId, "请假原因");
        System.out.println("请假天数:"+days);
        System.out.println("请假日期:"+date);
        System.out.println("请假原因:"+resean);
    }
输出:
请假天数:2
请假日期:Wed Sep 06 11:29:29 CST 2017
请假原因:准备结婚

影响的表
ACT_RU_VARIABLE
这里写图片描述
ACT_HI_VARINST
这里写图片描述
设置流程变量2

    /**设置流程变量*/
    @Test
    public void setVariables(){
        //影响的表
        //ACT_RU_VARIABLE  :正在执行的流程变量表
        //ACT_HI_VARINST:历史流程变量表
        /**与任务(正在执行)*/
        TaskService taskService = processEngine.getTaskService();
        //任务ID
        String taskId = "1704";
        /**二:设置流程变量,使用javabean类型*/
        //影响的表ACT_GE_BYTEARRAY
        Person p = new Person();
        p.setId(45);
        p.setName("陈道明");
        taskService.setVariable(taskId, "人员信息", p);

        System.out.println("设置流程变量成功!");
//      输出:
//      设置流程变量成功!
    }

    /**获取流程变量*/
    @Test
    public void getVariables(){
        /**与任务(正在执行)*/
        TaskService taskService = processEngine.getTaskService();
        //任务ID
        String taskId = "1704";
        /**二:获取流程变量,使用javabean类型*/
        Person p = (Person)taskService.getVariable(taskId, "人员信息");
        System.out.println(p);
//      输出:
//      Person [id=45, name=陈道明]
    }

影响的表
ACT_RU_VARIABLE
这里写图片描述
ACT_HI_VARINST
这里写图片描述
ACT_GE_BYTEARRAY
这里写图片描述

查询流程变量的历史表

    /**查询流程变量的历史表*/
    @Test
    public void findHistoryProcessVariables(){
        List<HistoricVariableInstance> list = processEngine.getHistoryService()//
                        .createHistoricVariableInstanceQuery()//创建一个历史的流程变量查询对象
                        .variableName("请假日期")
                        .list();
        if(list!=null && list.size()>0){
            for(HistoricVariableInstance hvi:list){
                System.out.println("-----------"+hvi.getVariableName()+"----------");
                System.out.println("变量id :   "+hvi.getId());
                System.out.println("流程实例id :   "+hvi.getProcessInstanceId());
                System.out.println("变量名称 :   "+hvi.getVariableName());
                System.out.println("变量类型:   "+hvi.getVariableTypeName());
                System.out.println("变量值:   "+hvi.getValue());
//              输出:
//              -----------请假日期----------
//              变量id :   1802
//              流程实例id :   1701
//              变量名称 :   请假日期
//              变量类型:   date
//              变量值:   Wed Sep 06 11:29:29 CST 2017
            }
        }
posted on 2017-09-06 15:19  2637282556  阅读(453)  评论(0编辑  收藏  举报