Activiti-流程变量

1.什么是流程变量

　　流程变量在activiti中是一个非常重要的角色，流程运转有时需要靠流程变量，业务系统和activiti结合时少不了流程变量，流程变量就是activiti在管理工作流程时根据管理需要而设置的变量；

　　比如在请假流程流转时如果请假天数大于3天则由总经理审批，否则有人事直接审批，请假天数就可以设置为流程变量，在流程流转时使用；

　　注意：虽然流程变量中可以存储业务数据，通过activiti的api查询流程变量从而实现查询业务天数，但是不建议这样使用，因为业务数据查询由业务系统负责，activiti设置流程变量是为了流程执行需要而创建；

2.流程变量类型

　　

 　　注意：如果将pojo存储到流程变量中，必须实现序列化接口serializable，为了防止由新增字段无法反序列化，需要生成serialVersionUID；

3.流程变量作用域

　　流程变量的作用域默认是一个流程实例，也可以是一个任务或一个执行实例，这三个作用域流程实例的范围最大，可以成为global变量，任务和执行实例仅仅是针对一个任务和一个执行实例范围，范围没有流程实例大，称为local变量；

　　global变量中变量名不允许重复，设置相同名称的变量，后设置的值会覆盖前设置的变量值；local变量由于在不同的任务或不同的执行实例中，作用域互不影响，变量名可以相同没有影响；local变量名也可以和global变量名相同，没有影响；

4.流程变量的使用方法

　　4.1 设置流程变量

　　4.2 通过UEL表达式使用流程变量

　　　　4.2.1 可以在activiti处设置UEL表达式，表达式的值为任务的负责人；

　　　　　　比如：${assignee}，assignee就是一个流程变量名称；

　　　　　　activiti获取UEL表达式的值，即流程变量assignee的值，将assignee的值作为任务的负责人进行任务分配；

　　　　4.2.2 可以在连线上设置UEL表达式，决定流程走向；

　　　　　　比如：${price>=10000}和${price<10000}；price就是一个流程变量名称，UEL表达式结果类型为布尔类型；

　　　　　　如果UEL表达式是true，要巨鼎流程执行走向；

5.使用global变量控制流程

　　5.1 需求

　　　　创建请假审批流程，有部门经理审批，部门经理审批通过后请假三天以下有人事经理直接审批，三天以上先有总经理审批，再有人事经理存档；

　　　　

　　5.2 流程定义

　　　　请假天数小于等于三天：

　　　　　　

　　　　请假天数大于三天：

 　　　　　　

6.设置global流程变量

　　在部门经理审批前设置流程变量，变量值为请假单信息，部门经理审批后可以根据流程变量的值决定流程走向；

　　6.1 启动流程时设置

　　　　在启动流程时设置流程变量，变量的作用域是整个流程实例；

　　　　通过Map<key,value>设置流程变量，map中可以设置多个变量，这个key就是流程变量的名字；

package com.wn.entity;

import java.io.Serializable;
import java.util.Date;

/*业务实体*/
public class Hoilday implements Serializable {

    private Integer id;
    private String hoildayName; //申请人
    private Date startDate; //开始时间
    private Date endDate;   //结束时间
    private Integer num;    //请假天数
    private String reason;  //请假事由
    private String type;

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getHoildayName() {
        return hoildayName;
    }

    public void setHoildayName(String hoildayName) {
        this.hoildayName = hoildayName;
    }

    public Date getStartDate() {
        return startDate;
    }

    public void setStartDate(Date startDate) {
        this.startDate = startDate;
    }

    public Date getEndDate() {
        return endDate;
    }

    public void setEndDate(Date endDate) {
        this.endDate = endDate;
    }

    public Integer getNum() {
        return num;
    }

    public void setNum(Integer num) {
        this.num = num;
    }

    public String getReason() {
        return reason;
    }

    public void setReason(String reason) {
        this.reason = reason;
    }
}

package com.wn.hoilday;

import com.wn.entity.Hoilday;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RuntimeService;
import org.activiti.engine.runtime.ProcessInstance;

import java.util.HashMap;
import java.util.Map;

/*流程定义*/
public class StartInstance {
    public static void main(String[] args) {
        //获取ProcessEngine
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取RuntimeService
        RuntimeService runtimeService = processEngine.getRuntimeService();
        //设置流程变量
        Hoilday hoilday=new Hoilday();
        hoilday.setNum(3);
        //定义一个map集合，存放assignee的值
        Map<String ,Object> assMap=new HashMap<>();
        assMap.put("hoilday",hoilday);
        //启动一个流程实例
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("hoilday2", assMap);
        System.out.println("流程启动成功！");
    }
}

 　　6.2 任务办理时设置

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

　　　　这里需要在创建请假单任务完后时设置流程变量；

package com.wn.hoilday;

import com.wn.entity.Hoilday;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.TaskService;

import java.util.HashMap;
import java.util.Map;

/*任务处理
* `act_hi_identitylink`     历史参与者信息
* `act_hi_taskinst`         历史任务信息
* `act_ru_execution`        任务执行信息
* `act_ru_task`             任务信息
* 当所有任务处理完毕，对应当前流程实例信息删除，但是可以在历史中查看该信息
* */
public class CompleteTask {
    public static void main(String[] args) {
        //获取ProcessEngine
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取TaskService对象进行流程部署
        TaskService taskService = processEngine.getTaskService();
        //设置流程变量
        Hoilday hoilday=new Hoilday();
        hoilday.setNum(3);
        //定义一个map集合，存放assignee的值
        Map<String ,Object> assMap=new HashMap<>();
        assMap.put("hoilday",hoilday);
        //任务处理
        taskService.complete("7502",assMap);
    }
}

 　　　　说明：通过当前任务设置流程变量，需要指定当前任务id，如果当前执行的任务ID不存在则抛出异常，任务办理时也是通过map<key,value>设置流程变量，一次可以设置多个变量；

　　6.3 通过当前流程实例设置

　　　　通过流程实例ID设置全局变量，该流程实例必须未执行完成；

package com.wn.hoilday;

import com.wn.entity.Hoilday;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RuntimeService;

/*通过当前流程实例设置流程变量*/
public class GlobalVariableByExecutionId {
    public static void main(String[] args) {
        //获取ProcessEngine
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取RuntimeService
        RuntimeService runtimeService = processEngine.getRuntimeService();
        //设置流程变量
        Hoilday hoilday=new Hoilday();
        hoilday.setNum(3);
        runtimeService.setVariable("7502","hoilday",hoilday);

    }
}

　　　　注意:流程实例ID必须当前未结束的的，通常此id设置流程实例的ID，也可以通过runtimeService.getVariable()获取流程变量；

　　6.4 通过当前任务设置

package com.wn.hoilday;

import com.wn.entity.Hoilday;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.RuntimeService;

/*通过当前任务设置*/
public class GlobalVariableByTask {
    public static void main(String[] args) {
        //获取ProcessEngine
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取RuntimeService
        RuntimeService runtimeService = processEngine.getRuntimeService();
        //设置流程变量
        Hoilday hoilday=new Hoilday();
        hoilday.setNum(3);
        //当前代办任务ID
        runtimeService.setVariable("1404","hoilday",hoilday);
    }
}

　　　　注意：任务ID必须是当前代办任务ID，如果该任务已经结束，就会报异常；

7.注意事项

　　7.1 如果UEL表达式中流程变量不存在则报错；

　　7.2 如果UEL表达式中流程变量为空NULL，流程不按UEL表达式执行，而流程结束；

　　7.3 如果UEL表达式都不符合条件，流程结束；

　　7.4 如果连线不设置条件，会走flow序号小的那条线；