Activiti学习记录（二）

系列文章目录

前言

学习activiti记录过程中的一些问题。
springBoot 版本 2.5.2
activiti版本 7.1.0.M6

一、ProcessInstance

流程实例（ProcessInstance），流程的一个运行的实例，我们可以通过流程实例对象了解当前流程的进度信息等

1.1 BusinessKey

activiti通过操作数据库中的表来实现流程自动化运行，但是在实际应用中，比如请假的流程，请假申请单可能包含这些信息（请假理由，请假时长，开始时间，结束时间，附件），所以需要将请假申请表与activiti的流程实例关联起来才行。
BusinessKey这个字段就是专门用来保存业务记录的。

在启动流程的时，传入创建的请假申请单的id 1

        ProcessInstance instance = runtimeService.startProcessInstanceByKey("holiday","1");

二、挂起与激活

2.1.1全部挂起

流程定义为挂起状态，该流程定义不允许启动新实例，且该流程定义的全部实例被挂起

  /**
  	* processDefinitionId 流程定义id
  	* activateProcessInstances 激活
  	* activationDate 激活时间 null 表示立刻激活
   */
  void activateProcessDefinitionById(String processDefinitionId, boolean activateProcessInstances, Date activationDate);

        //查询流程定义对象
        ProcessDefinition definition = repositoryService.createProcessDefinitionQuery()
                .processDefinitionKey("holiday")
                .singleResult();
        //查询流程定义状态 true为挂起状态
        boolean suspended = definition.isSuspended();
        String id = definition.getId();
        if (suspended){
            //激活
            repositoryService.activateProcessDefinitionById(id,true,null);
        }else{
            //挂起
            repositoryService.suspendProcessDefinitionById(id,true,null);
        }

执行挂起后 act_ru_task中的SUSPENSION_STATE_只会被修改为2，运行实例就会报错

2.1.2单个实例挂起

单个实例挂起只有挂起的这个流程实例不会继续执行，其他流程实例不受到干扰

//查询流程实例
        ProcessInstance instance = runtimeService.createProcessInstanceQuery()
                .processInstanceId("ac9105ee-1848-11ec-a8c9-005056c00001")
                .singleResult();
        //查询流程实例状态 true为挂起状态
        boolean suspended = instance.isSuspended();
        String id = instance.getId()
        if (suspended){
            //激活
            runtimeService.activateProcessInstanceById(id);
        }else{
            //挂起
            runtimeService.suspendProcessInstanceById(id);
        }

三、个人任务处理

3.1 任务责任人分配

流程中的任分配给哪些人处理

3.1.1 固定分配

就是我们目前使用的，直接在流程定义文件中直接写出任务的负责人(assignee)，但是实际使用中可能不是会用到很多。

3.1.2 表达式分配

在activiti中支持使用UEL表达式
修改部分如下：activiti:assignee="${assignee0}

<userTask id="ServiceTask_1" name="填写请假申请单" activiti:assignee="${assignee0}"/>
<userTask id="ServiceTask_2" name="管理员审批" activiti:assignee="${assignee1}"/>

部署修改后的流程

        Deployment deploy = repositoryService.createDeployment()
                .addClasspathResource("/processes/holiday-uel.bpmn20.xml")
                .name("UEL表达式请假流程")
                .deploy();

启动流程实例

        Map<String,Object> map = new HashMap<>();
        map.put("assignee0","zhangsan");
        map.put("assignee1","lisi");
        //map中的值替换xml中的uel表达式
        ProcessInstance instance = runtimeService.startProcessInstanceByKey("holiday-uel",map);

3.1.3 监听器分配

使用监听器可以用来完成很多的activiti的流程业务，这里我们使用它来分配负责人

1. 实现在创建一个监听器，实现TaskListener

public class StartListener implements TaskListener {

    @Override
    public void notify(DelegateTask delegateTask) {
        if ("填写请假申请单".equals(delegateTask.getName())) {
        	//指定任务负责人
            delegateTask.setAssignee("张三");
        } else if ("管理员审批".equals(delegateTask.getName())) {
            delegateTask.setAssignee("李四");
        }
    }
}

2. 修改流程定义文件，在流程创建时触发监听器，设置负责人

  <userTask id="ServiceTask_1" name="填写请假申请单">
            <extensionElements>
                <activiti:taskListener event="create" class="com.chzu.activiti.listener.StartListener"></activiti:taskListener>
            </extensionElements>
        </userTask>
        <userTask id="ServiceTask_2" name="管理员审批">
            <extensionElements>
                <activiti:taskListener event="create" class="com.chzu.activiti.listener.StartListener"></activiti:taskListener>
            </extensionElements>
        </userTask>

      <attribute name="event" use="required">
        <annotation>
          <documentation>
            The event on which the delegation class or expression will be executed.
          </documentation>
        </annotation>
        <simpleType>
          <restriction base="string">
            <enumeration value="create" />//任务创建时触发
            <enumeration value="assignment" />//任务分配后触发
            <enumeration value="complete" />//任务完成后触发
          </restriction>
        </simpleType>
      </attribute>

3. 部署启动流程，完成任务

3.2 任务查询

实际使用中查询任务时，也要将其BusinessKey关联的信息查询

3.3 任务办理

实际使用实例id何负责人查询任务时，要判断之后在完成任务

        Task task = taskService.createTaskQuery()
                .taskId("xxxx")
                .taskAssignee("刘卫东")
                .singleResult();
        //该用户是否能够处理该任务
        if (task != null){
            taskService.complete(task.getId());
        }

总结

继续学习，加油