集成Activiti必须了解的内容

简介

目前选用的版本是 5.22.0, 入门 activiti 需要了解的内容:

1.bpmn 规范, activiti 提供的 Service , activiti 内置的表;

2.流程定义,流程部署,启动流程,流程查询,任务表单

3.重构用户组,动态分配任务,集成 modeler ,定时任务

推荐参考: 咖啡兔, 官网API

spring boot,mybatis,activiti

bpmn规范

bpmn 用于定义业务流程图, activiti 支持 bpmn2.0 规范,并加入了一些自定义的属性;

阅读 demo 中的 bpmn 文件即可大致了解;

流程与表之间的基本关联描述

1.deploy

流程部署成功后,打包上传的 bpmn 和 png 文件属于静态资源文件,保存在 act_ge_bytearray 中;

除了资源文件外,生成的部署信息和流程定义分别保存在 act_re_deployment 和 act_re_procdef 中;

2.model

流程的一种形式,以 model 形式保存流程,信息保存在表 act_re_model,act_ge_bytearray 中;

model 流程的部署同 bpmn 流程, 生成 bpmn 和 png 文件保存在 act_ge_bytearray 中

3.processInstance

流程每次启动都会生成一个流程实例,保存在 act_hi_procint 表中, proc_inst_id_ 是流程实例的 id ;

4.execution

execution 指一个流程实例要执行的过程对象,保存在 act_ru_execution 表中;

execution 表的 id_ 字段通常与 proc_inst_id_ 字段一致,不一致时代表该 execution 是子流程;

5.task

流程图中的每个节点都是一个任务,上一个任务完成后,下一个任务就会被插入到 act_hi_taskinst 和 act_ru_task 表中;

6.变量

执行任务过程中产生的变量信息(也包含动态表单的信息)存储在 act_ru_variable 和 act_hi_varinst 表中;

任务完成后,历史变量信息会被存储在 act_hi_detail 表中(该表存储哪些信息由配置中的 HistoryLevel 决定)

7.执行者

任务的执行者信息存储在 act_ru_identitylink 和 act_hi_identitylink 表中;

activiti提供的Service

activiti 提供了如下七类接口便于部署、启动、执行、查询流程实例、任务及表单信息;

可参考 demo 项目和官方api;

RepositoryService	管理流程定义,查询、部署流程
RuntimeService	执行管理,包括启动、推进、删除流程实例等操作,查询正在运行的流程信息
TaskService	任务管理,如查询某个人的代办任务
HistoryService	历史数据管理
IdentityService	组织机构管理,查询activiti内置的用户组织结构信息
FormService	一个可选服务，任务表单管理,如查询动态表单属性值
ManagementService	Service for admin and maintenance operations on the process engine. These operations will typically not be used in a workflow driven application, but are used in for example the operational console.

流程内置的表

activiti 内置25张表,表字段详情参考

内置表以 ACT 开头,表名第二部分代表表的类型,如:

ACT_GE_* -> General, ACT_HI_* -> History, ACT_ID_* -> Identity, ACT_RE_ -> Repository, ACT_RU_* -> Runtime;

表分类	表名	解释
一般数据	ACT_GE_BYTEARRAY	通用的流程定义和流程资源
	ACT_GE_PROPERTY	系统相关属性
流程历史记录	ACT_HI_ACTINST	历史的流程实例
	ACT_HI_ATTACHMENT	历史的流程附件
	ACT_HI_COMMENT	历史的说明性信息
	ACT_HI_DETAIL	历史的流程运行中的细节信息
	ACT_HI_IDENTITYLINK	历史的流程运行过程中用户关系
	ACT_HI_PROCINST	历史的流程实例
	ACT_HI_TASKINST	历史的任务实例
	ACT_HI_VARINST	历史的流程运行中的变量信息
用户用户组表	ACT_ID_GROUP	身份信息-组信息
	ACT_ID_INFO	身份信息-组信息
	ACT_ID_MEMBERSHIP	身份信息-用户和组关系的中间表
	ACT_ID_USER	身份信息-用户信息
流程定义表	ACT_RE_DEPLOYMENT	部署单元信息
	ACT_RE_MODEL	模型信息
	ACT_RE_PROCDEF	已部署的流程定义
运行实例表	ACT_RU_EVENT_SUBSCR	运行时事件
	ACT_RU_EXECUTION	运行时流程执行实例
	ACT_RU_IDENTITYLINK	运行时用户关系信息
	ACT_RU_JOB	运行时作业
	ACT_RU_TASK	运行时任务
	ACT_RU_VARIABLE	运行时变量表

表单

bpmn文件中有两种定义表单的方式:

1.动态表单

<userTask activiti:candidateGroups="emp" activiti:exclusive="true" id="usertask6" name="员工发起请假申请">
    <extensionElements>
        <activiti:formProperty datePattern="yyyy-MM-dd" id="startTime" name="开始时间" type="date"/>
        <activiti:formProperty datePattern="yyyy-MM-dd" id="endTime" name="结束时间" type="date"/>
        <activiti:formProperty id="restReason" name="请假原因" type="string"/>
    </extensionElements>
</userTask>

可通过 formService 获取表单属性、赋值、提交并完成当前任务;

2.外置表单(普通表单)

<userTask activiti:candidateGroups="fz" activiti:exclusive="true" activiti:formKey="audit.jsp" id="usertask11" name="审批"/>

可通过 formService 获取 formKey 自行处理,formKey一般来说是路径+名称;

自定义用户组

activiti 内置了一套用户组以及认证管理,结构较为简单,不符合使用场景,需要替换为自定义用户组管理;

参考博客:重构用户组数据的多种方案比较

目前采用的是自定义 sessionFactory 的方式,即替换 activiti 原生的用户组查询模块,实现描述如下:

1.配置 activiti 使用自定义 sessionFactory

2.自定义 UserManagerFactory 和 GroupManagerFactory 实现 SessionFactory 接口

3.继承 activiti 定义的 UserEntityManager 和 GroupEntityManager , 重写主要方法

替换后可删除表 act_id_* ;

该方案在使用的时候需要避免调用未重写的方法;

任务的动态分配

任务的动态分配与指派有多种实现方式,适用于不同场景,按需选择;

1.实现 TaskListener 接口,如:

bpmn中的定义:

<userTask activiti:candidateGroups="2" activiti:exclusive="true" activiti:formKey="audit_bz.jsp" id="usertask7" name="项目组长审批">
	<extensionElements>
	    <activiti:taskListener event="create" class="com.xxx.TaskListenerImpl"/>
	</extensionElements>
</userTask>

TaskListenerImpl 的实现:

		
public class TaskListenerImpl implements TaskListener {
    @Override
    public void notify(DelegateTask delegateTask) {
        delegateTask.deleteCandidateGroup("manager");
        delegateTask.addCandidateGroup("president");
    }
}
	

2.直接指定办理人,如:

<userTask id="hrAudit" name="人事审批" activiti:assignee="${hrUserId}" />

任务完成后传递该变量;

Map variables = new HashMap();
variables.put("hrUserId", hrUserId);
taskService.complete(taskId, variables);

注意 assignee 与 candidateGroups 的查询方式不同,故不能混用;

activiti modeler

activiti 提供的网页绘制工具,已集成至 demo 项目,参考博客;

定时任务

act_ru_job,尚未在demo中尝试运用

spring boot

采用注解取代xml配置项

配置文件application.yml

流程回退&撤销

需要自定义扩展

owner和assignee

指定办理人 > claim || setAssignee

发生委托，A委托给B

则 任务的办理人由A变成B 同时owner被赋值A