Activiti流程变量

1. 流程变量的含义：

　　我们可以在业务系统和流程系统当中，通过流程变量来制定对应的分支，如：员工请假
　　请假天数<=3那么部门经理审批后交给人事，如果>3那么部门经理审批结束后交给总经理审批，总经理结束后交给任务

2. 流程变量的数据类型：

　　string,double,boolean,short,long,Integer,binary,date日期
　　serializable，如果流程变量需要用到pojo当中的属性字段，则该pojo需要实现序列化接口

3. 流程变量的作用域

　　1.默认情况下，流程变量存在整个流程实例当中，每一个环节都可以获取到该变量，称之为global，类似于Java全局变量
　　2.任务和执行实例仅仅是针对一个任务和一个执行实例范围，范围没有流程实例大，称为local 变量。类似于Java局部变量

4.流程变量案例：

　　 请假天数<=3那么部门经理审批后交给人事，如果>3那么部门经理审批结束后交给总经理审批，总经理结束后交给任务

                    4.1 定义流程图，在流程线上设置流程变量的条件

　　　　　　

 

                    4.2 定义POJO，要去实现serializable接口

　　　　　　

/**
 * 业务实体
 */
public class Holiday implements Serializable {
    private static final long serialVersionUID = 1L;
    private Integer id;
    private String holidayName; //申请人
    private Date startDate; //开始时间
    private Date endDate;   //结束时间
    private Integer num;    //请假天数
    private String reason;  //请假事由
    private String type;    //请假类型

    public Integer getId() {

        return id;
    }

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

    public String getHolidayName() {
        return holidayName;
    }

    public void setHolidayName(String holidayName) {
        this.holidayName = holidayName;
    }

    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;
    }

    public String getType() {
        return type;
    }

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

                    4.3 流程部署

/**
     * 流程部署
     */
    @Test
    public void deployment() {
        //获取ProcessEngine对象   默认配置文件名称：activiti.cfg.xml  并且configuration的Bean实例ID为processEngineConfiguration
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取RepositoryService对象进行流程部署
        RepositoryService repositoryService = processEngine.getRepositoryService();
        //进行部署,将对应的流程定义文件生成到数据库当中，作为记录进行保存
        Deployment deployment = repositoryService.createDeployment()
                .addClasspathResource("holiday/holiday2.bpmn")     //加载流程文件
                .addClasspathResource("holiday/holiday2.png")
                .name("请假流程-流程变量")       //设置流程名称
                .deploy();                      //部署

        //输出部署信息
        System.out.println("流程名称：" + deployment.getName());
        System.out.println("流程ID：" + deployment.getId());
        System.out.println("流程Key：" + deployment.getKey());
    }

                    4.4 启动流程实例

/**
     * 启动流程实例
     */
    @Test
    public void startInstance() {
        //获取ProcessEngine对象   默认配置文件名称：activiti.cfg.xml  并且configuration的Bean实例ID为processEngineConfiguration
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取RuntimeService
        RuntimeService runtimeService = processEngine.getRuntimeService();
        //设置流程变量
        Holiday holiday = new Holiday();
        holiday.setNum(3);
        //定义一个Map集合，存放流程变量的值
        Map<String, Object> assMap = new HashMap<>();
        assMap.put("holiday", holiday);
        //启动流程
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("holiday2");
        System.out.println("流程实例启动成功~");
    }

 
                    4.5 测试流程执行

　　　　　　小于三天lisi执行完后直接到zhaoliu代办

 　　　　如果请假4天,则需要流转到wangwu审批通过后才能到zhaoliu

 

5. 任务执行时，设置流程变量    

                /**
                 * 任务执行时，设置流程变量
                 */
                @Test
                public void runTask() {


                    //获取ProcessEngine对象   默认配置文件名称：activiti.cfg.xml  并且configuration的Bean实例ID为processEngineConfiguration
                    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
                    //获取一个TaskService对象
                    TaskService taskService = processEngine.getTaskService();
                    //查询代办业务 createTaskQuery查询任务   taskCandidateOrAssigned查询任务执行者   processDefinitionKey：查询流程
                    /**
                     * taskCandidateOrAssigned匹配规则:1.Assigned   2.配置bpmn文件中定义的值
                     * taskAssignee匹配规则:1.Assigned
                     */
                    /*List<Task> list = taskService.createTaskQuery().taskCandidateOrAssigned("lisi").processDefinitionKey("holiday").list();*/
                    List<Task> list = taskService.createTaskQuery().taskAssignee("lisi").processDefinitionKey("holiday2").list();
                    //分页：List<Task> list = taskService.createTaskQuery().taskAssignee("zhangsan").processDefinitionKey("holiday").listPage(i,j);
                    for (Task task : list) {
                        System.out.println("任务名称：" + task.getName());
                        System.out.println("任务执行人：" + task.getAssignee());
                        System.out.println("任务ID：" + task.getId());
                        //设置流程变量
                        Holiday holiday = new Holiday();
                        holiday.setNum(5);
                        //定义一个Map集合，存放流程变量的值
                        Map<String, Object> assMap = new HashMap<>();
                        assMap.put("holiday", holiday);
                        //处理任务
                        taskService.complete(task.getId(),assMap);
                        System.out.println("流程实例ID：" + task.getProcessInstanceId());
                    }
                }

6. 通过流程实例ID设置流程变量的值

执行lisi分支任务之前,执行此方法设置值

                /**
                 * 获取到流程实例ID，跟据流程实例设置流程变量的值
                 */
                @Test
                public void getInstanceVar(){
                    //获取ProcessEngine对象   默认配置文件名称：activiti.cfg.xml  并且configuration的Bean实例ID为processEngineConfiguration
                    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
                    //获取RuntimeService
                    RuntimeService runtimeService = processEngine.getRuntimeService();
                    //设置流程变量
                    Holiday holiday = new Holiday();
                    holiday.setNum(3);
                    //设置流程变量
                    runtimeService.setVariable("25001","holiday",holiday);
                }

7. 根据任务ID，设置流程变量

                /**
                 * 根据任务ID，设置流程变量
                 */
                @Test
                public void runTask() {
                    //获取ProcessEngine对象   默认配置文件名称：activiti.cfg.xml  并且configuration的Bean实例ID为processEngineConfiguration
                    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
                    //获取一个TaskService对象
                    TaskService taskService = processEngine.getTaskService();
                    //查询代办业务 createTaskQuery查询任务   taskCandidateOrAssigned查询任务执行者   processDefinitionKey：查询流程
                    /**
                     * taskCandidateOrAssigned匹配规则:1.Assigned   2.配置bpmn文件中定义的值
                     * taskAssignee匹配规则:1.Assigned
                     */
                    /*List<Task> list = taskService.createTaskQuery().taskCandidateOrAssigned("lisi").processDefinitionKey("holiday").list();*/
                    List<Task> list = taskService.createTaskQuery().taskAssignee("lisi").processDefinitionKey("holiday2").list();
                    //分页：List<Task> list = taskService.createTaskQuery().taskAssignee("zhangsan").processDefinitionKey("holiday").listPage(i,j);
                    for (Task task : list) {
                        System.out.println("任务名称：" + task.getName());
                        System.out.println("任务执行人：" + task.getAssignee());
                        System.out.println("任务ID：" + task.getId());
                        //设置流程变量
                        Holiday holiday = new Holiday();
                        holiday.setNum(5);
                        taskService.setVariable(task.getId(),"holiday",holiday);
                        //处理任务
                        taskService.complete(task.getId());
                        System.out.println("流程实例ID：" + task.getProcessInstanceId());
                    }
                }

            
　　注意问题：
                1、如果UEL 表达式中流程变量名不存在则报错。
                2、如果UEL 表达式中流程变量值为空NULL，流程不按UEL 表达式去执行，而流程结束 。
                3、如果UEL 表达式都不符合条件，流程结束
                4、如果连线不设置条件，会走flow 序号小的那条线