activiti7+springboot2.1.x流程变量（十）

在这里我们要介绍两种流程变量。

1. 全局变量，globle variable
2. 局部变量，local variable
   先说一下我自己对这两种变量的理解。
   全局变量：当启动一个流程实例以后，在整个流程的生命周期都起作用的。
   局部变量：只在某一个流程实例的某一个任务节点起作用的变量。

为了讲清楚流程变量，我们接下来还是参照之前的请假流程重新绘制一个流程图。不过这个流程图和之前的流程图有一点变化，这个变化就是新的流程图上主管审批向下执行流程有两条线，并且每一条线上都有附加执行条件，如果请假天数大于3天则需要经理审批，如果请假天数小于3天则无需经理审批这个流程直径进入人事审批流程。

image.png

接下来就按照之前的流程部署，部署一个流程。

全局变量

全局变量的设置我自己总结了有四种方式。

1. 启动流程的时候指定流程变量。通过RuntimeService.startInstanceById(processDefinitionId,Map map)这个方法，其中map就是将要设置的全局变量。

   
   
   image.png

    /**
     * 启动一个流程实例，并同时设置全局变量
     * @param tianshu 请假天数
     */
    @Override
    public void startProcessInstance(int tianshu){
        //查询流程定义
        ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery().processDefinitionKey("holiday3").singleResult();

        //定义全局变量
        Map variables = new HashMap<>();
        variables.put("tianshu",tianshu);

        //启动流程，并设置全局流程变量
        runtimeService.startProcessInstanceById(processDefinition.getId());
    }

启动流程后可以看到数据库表，act_run_variable多了一条记录。

image.png

2. 通过runtiimeservice.setVariable/s()。如果是添加一个变量用setVariable，多个变量用setVariables。通过这个方法也可以对前面启动流程时设置的全局变量进行修改。

/**
     * 在流程运行时设置全局变量
     * @param variables 全局流程变量
     * @param processInstanceId 流程实例id
     */
    @Override
    public void setGlobleVariables(Map variables,String processInstanceId) {
        runtimeService.setVariables(processInstanceId,variables);
    }

3. 用户完成任务的时候指定,taskService.complate(taskId,map变量)

    /**
     * 用户完成任务的时候指定全局变量
     * @param variables 全局流程变量
     * @param taskId 用户任务id
     */
    @Override
    public void setVariablesWhenComplateUserTast(Map variables,String taskId) {
        taskService.complete(taskId,variables);
    }

4. 用户任务上指定变量,taskService.setVariable/s()

/**
     * 用户任务上指定变量
     * @param variables
     * @param taskId
     */
    @Override
    public void setVariablesOnUserTask(Map variables,String taskId) {
        taskService.setVariables(taskId,variables);
    }

局部变量

局部变量的使用与全局变量的使用非常相似，主要的区别在于变量的作用域不同。局部变量只做用于当前用户流程节点。设置局部变量有两种方式。

1. 根据用户任务id直接设置

    /**
     * 在用户的任务流程节点上设置局部变量
     * 局部变量的作用域为当前的流程节点
     * @param variables 局部变量
     * @param taskId 任务id
     */
    @Override
    public void setLocalVariablesOnUserTask(Map variables,String taskId) {
        taskService.setVariablesLocal(taskId,variables);
    }

2. 完成任务时设置

    /**
     * 在用户完成任务流程时设置局部变量
     * 局部变量的作用域为当前的流程节点
     * @param variables 局部变量
     * @param taskId 任务id
     */
    @Override
    public void complateAndSetLocalVariablesOnUserTask(Map variables,String taskId) {
        //第三个参数表示，变量为局部变量
        taskService.complete(taskId,variables,true);
    }

注意

1、数据库表数据变化，act_ru_variable
2、流程必须是未完成状态
3、UEL表达式中的流程变量不存在则报错
4、如果UEL表达式中流程 变量值为NULL，流程不按UEL表达式执行，而流程结束
5、UEL表达式都不符合条件，流程结束
6、如果连线不设置条件，会flow符号小的那条线