Activiti学习笔记6 — 变量与历史记录

一、 变量的使用

1、创建流程引擎对象

private ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

2、启动流程

/**
     * 2、启动流程
     */
    @Test
    public void testStartProcess() {
        // 获取服务对象的实例
        RuntimeService runtimeService = processEngine.getRuntimeService();

        // 当使用ByKey方式时会自动执行相对应流程的最高版本
        String processDefinitionKey = "leaveflow2";

        // 设置启动时的流程变量
        Map<String, Object> variables = new HashMap<String, Object>();
        variables.put("test", "测试");

        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);

        logger.info("Id:" + processInstance.getId());
        logger.info("ActivitiId:" + processInstance.getActivityId());
    }

3、设置流程变量

/**
     * 3、设置流程变量
     *         1、在办理时设置流程变量
     *         2、在完成时设置流程变量
     */
    @Test
    public void testProcessTask(){
        //获取服务对象的实例
        TaskService taskService = processEngine.getTaskService();
        
        //1、在办理时设置流程变量
        //1.1、获取任务,查询正在执行的任务        
        String assignee = "employee";
        TaskQuery query = taskService.createTaskQuery()
                                                       .taskAssignee(assignee)
                                                       .orderByTaskCreateTime()
                                                       .desc();
        Task task = query.list().get(0);
        String taskId = task.getId();
        //1.2、向任务中设置流程变量
        //设置一个流程变量
        //taskService.setVariable(taskId, "请假天数", 2);
        //taskService.setVariable(taskId, "请假原因", "约会");
        //设置多个流程变量
        //taskService.setVariables(taskId, variables);
        
        //2、在完成时设置流程变量
        Map<String, Object> variables = new HashMap<String, Object>();
        variables.put("请假天数", 4);
        variables.put("请假原因", "外出培训");
        variables.put("请假借款", 1000.5);
        variables.put("请假开始日期", new Date());
        variables.put("是否用车", false);
        taskService.complete(taskId, variables);
        
    }

4、查看流程变量

/**
     * 4、查看流程变量
     * 流程变量不与Task相关
     */
    @Test
    public void testQueryProcessVariable() {
        // 1、获取服务对象的实例
        TaskService taskService = processEngine.getTaskService();

        // 2、查询正在执行的任务
        String assignee = "employee";
        TaskQuery query = taskService.createTaskQuery()
                                                       .taskAssignee(assignee)
                                                       .orderByTaskCreateTime()
                                                       .desc();
        Task task = query.list().get(0);
        
        //3、根据任务ID与流程变量的Key获取流程变量信息
        String taskId = task.getId();
        logger.info("TaskId: " + task.getId() );
        //3.1、获取单个流程变量
        String variableName = "test";
        String varilable =  (String) taskService.getVariable(taskId, variableName);
        
        logger.info("Varilable:" + varilable);
        
        //3.2、获取多个流程变量
        Map<String, Object> varMap = new HashMap<String, Object>();
        varMap = taskService.getVariables(taskId);
        
        logger.info("Map - Key: test, Value: " + varMap.get("test"));
        
    }

二、历史记录

1、查看按照某个规则一共执行了多少次流程　　

　　HistoricProcessInstance ：包含当前和已经结束的流程实例信息。

2、查看某一次流程执行，一共经历了多少步骤

　　HistoricActivityInstance：包含一个活动（流程上的节点）的执行信息。

3、Activiti的历史信息维护策略

　　在流程活动产生时，同时会产生一个对应的历史，记录开始相关的记录，然后在活动结束后，把结束时间维护进去。　

4、配置文件 activiti.cfg.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.2.xsd
        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.2.xsd">

    <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <!-- 数据库连接属性 -->
        <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/activiti?characterEncoding=utf-8"></property>
        <property name="jdbcDriver" value="com.mysql.jdbc.Driver"></property>
        <property name="jdbcUsername" value="root"></property>
        <property name="jdbcPassword" value="root"></property>
        
        <!-- 数据库更新策略 -->
        <property name="databaseSchemaUpdate" value="true"></property>
        
        <!-- 
        Activiti默认提供4种历史级别:
            1、none: 不保存任何历史记录，可以提高系统的性能；
            2、activity：保存所有的流程实例、任务、活动信息；
            3、audit：也是Activiti的默认级别，保存所有的流程实例、任务、活动、表单属性；
            4、full：最完整的历史记录，除了包含Audit级别的信息之外还能保存详细信息，例如：流程变量。
         -->
        <property name="history" value="activity"></property>
        
        <property name="jobExecutorActivate" value="false"></property>
        
        <!-- 邮件服务地址 -->
        <property name="mailServerHost" value="mail.wxintl.com"></property>
        <property name="mailServerPort" value="5025"></property>
    </bean>

</beans>