Flowable表结构认识

工作流程的相关操作都是操作存储在对应的表结构中,为了能更好的弄清楚Flowable的实现原理和细节,我们有必要先弄清楚Flowable的相关表结构及其作用。在Flowable中的表结构在初始化的时候会创建五类表结构。

Posted by Shrmars Blog on June 23, 2022

1.表结构讲解

  工作流程的相关操作都是操作存储在对应的表结构中,为了能更好的弄清楚Flowable的实现原理和细节,我们有必要先弄清楚Flowable的相关表结构及其作用。在Flowable中的表结构在初始化的时候会创建五类表结构,具体如下:

  • ACT_RE :’RE’表示 repository。 这个前缀的表包含了流程定义和流程静态资源 (图片,规则,等等)。
  • ACT_RU:’RU’表示 runtime。 这些运行时的表,包含流程实例,任务,变量,异步任务,等运行中的数据。 Flowable只在流程实例执行过程中保存这些数据, 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
  • ACT_HI:’HI’表示 history。 这些表包含历史数据,比如历史流程实例, 变量,任务等等。
  • ACT_GE: GE 表示 general。 通用数据, 用于不同场景下
  • ACT_ID: ’ID’表示identity(组织机构)。这些表包含标识的信息,如用户,用户组,等等。

具体的表结构的含义:

表分类 表名 解释
一般数据    
  [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_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] 运行时变量表
用户用户组表    
  [ACT_ID_BYTEARRAY] 二进制数据表
  [ACT_ID_GROUP] 用户组信息表
  [ACT_ID_INFO] 用户信息详情表
  [ACT_ID_MEMBERSHIP] 人与组关系表
  [ACT_ID_PRIV] 权限表
  [ACT_ID_PRIV_MAPPING] 用户或组权限关系表
  [ACT_ID_PROPERTY] 属性表
  [ACT_ID_TOKEN] 记录用户的token信息
  [ACT_ID_USER] 用户表

2.ProcessEngine讲解

2.1 硬编码的方式

  我们前面讲解案例的时候是通过ProcessEngineConfiguration这个配置类来加载的。

1
2
3
4
5
6
7
8
9
// 配置数据库相关信息 获取 ProcessEngineConfiguration
ProcessEngineConfiguration cfg = new StandaloneProcessEngineConfiguration()
    .setJdbcUrl("jdbc:mysql://localhost:3306/flowable?serverTimezone=UTC&nullCatalogMeansCurrent=true")
    .setJdbcUsername("root")
    .setJdbcPassword("123456")
    .setJdbcDriver("com.mysql.cj.jdbc.Driver")
    .setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
// 获取流程引擎对象
ProcessEngine processEngine = cfg.buildProcessEngine();

  这种方式会调用buildProcessEngine()方法,里面的核心代码为:

image-20220319113106848

image-20220319113139646

2.2 配置文件

  除了上面的硬编码的方式外,我们还可以在resources目录下创建一个flowable.cfg.xml文件,注意这个名称是固定的哦。内容如下:

1
2
3
4
5
6
7
8
9
10
11
12
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
    <bean id="processEngineConfiguration"
          class="org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/flow1?allowMultiQueries=true&amp;useUnicode=true&amp;characterEncoding=UTF-8&amp;useSSL=false&amp;serverTimezone=UTC&amp;nullCatalogMeansCurrent=true" /><property name="jdbcDriver" value="com.mysql.cj.jdbc.Driver" />
        <property name="jdbcUsername" value="root" />
        <property name="jdbcPassword" value="123456" />
        <property name="databaseSchemaUpdate" value="true" />
        <property name="asyncExecutorActivate" value="false" />
    </bean>
</beans>

  在上面的配置文件中配置相关的信息。我们在Java代码中就可以简化为:

1
2
3
4
5
6
    @Test
    public void test01(){
        // 获取流程引擎对象
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        System.out.println("processEngine = " + processEngine);
    }

  可以看下getDefaultProcessEngine的源码,在里面最终还是执行了和硬编码一样的代码

1
2
3
4
5
6
    public static ProcessEngine getProcessEngine(String processEngineName) {
        if (!isInitialized()) {
            init(); // 完成初始化操作
        }
        return processEngines.get(processEngineName);
    }

  进入init方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
    public static synchronized void init() {
        if (!isInitialized()) {
            if (processEngines == null) {
                // Create new map to store process-engines if current map is null
                processEngines = new HashMap<>();
            }
            ClassLoader classLoader = ReflectUtil.getClassLoader();
            Enumeration<URL> resources = null;
            try {
                resources = classLoader.getResources("flowable.cfg.xml"); // 加载flowable.cfg.xml配置文件
            } catch (IOException e) {
                throw new FlowableIllegalArgumentException("problem retrieving flowable.cfg.xml resources on the classpath: " + System.getProperty("java.class.path"), e);
            }

            // Remove duplicated configuration URL's using set. Some
            // classloaders may return identical URL's twice, causing duplicate
            // startups
            Set<URL> configUrls = new HashSet<>();
            while (resources.hasMoreElements()) {
                configUrls.add(resources.nextElement());
            }
            for (Iterator<URL> iterator = configUrls.iterator(); iterator.hasNext();) {
                URL resource = iterator.next();
                LOGGER.info("Initializing process engine using configuration '{}'", resource.toString());
                initProcessEngineFromResource(resource); // 初始化ProcessEngine
            }

            try {
                resources = classLoader.getResources("flowable-context.xml"); // 在整合Spring的情况下加载该文件
            } catch (IOException e) {
                throw new FlowableIllegalArgumentException("problem retrieving flowable-context.xml resources on the classpath: " + System.getProperty("java.class.path"), e);
            }
            while (resources.hasMoreElements()) {
                URL resource = resources.nextElement();
                LOGGER.info("Initializing process engine using Spring configuration '{}'", resource.toString());
                initProcessEngineFromSpringResource(resource); // 从Spring的资源文件中完成ProcessEngine的初始化
            }

            setInitialized(true);
        } else {
            LOGGER.info("Process engines already initialized");
        }
    }

  在源码中提供了单独使用好整合Spring的配置加载方式。再进入到initProcessEngineFromResource(resource)方法中:

image-20220319114011806

image-20220319114053252

image-20220319114210012

而且我们也可以看到ProcessEngine最终的实现是 ProcessEngineImpl对象。

2.3 自定义配置文件

  最后我们如果要加载自定义名称的配置文件可以通过ProcessEngineConfiguration中的对应构造方法来实现

1
2
3
4
5
6
7
    @Test
    public void test2() throws Exception{
        ProcessEngineConfiguration configuration = ProcessEngineConfiguration
                .createProcessEngineConfigurationFromResource("flowable.cfg.xml");
        ProcessEngine processEngine = configuration.buildProcessEngine();
        System.out.println("processEngine = " + processEngine);
    }

3. Servcie服务接口

Service是工作流引擎提供用于进行工作流部署、执行、管理的服务接口,我们使用这些接口可以就是操作服务对应的数据表

image-20220319223019186

3.1 Service创建方式

通过ProcessEngine创建Service

方式如下:

1
2
3
4
RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();
// ...

3.2 Service总览

service名称 service作用
RepositoryService Flowable的资源管理类
RuntimeService Flowable的流程运行管理类
TaskService Flowable的任务管理类
HistoryService Flowable的历史管理类
ManagerService Flowable的引擎管理类

简单介绍:

RepositoryService

是activiti的资源管理类,提供了管理和控制流程发布包和流程定义的操作。使用工作流建模工具设计的业务流程图需要使用此service将流程定义文件的内容部署到计算机。

除了部署流程定义以外还可以:查询引擎中的发布包和流程定义。

暂停或激活发布包,对应全部和特定流程定义。 暂停意味着它们不能再执行任何操作了,激活是对应的反向操作。获得多种资源,像是包含在发布包里的文件, 或引擎自动生成的流程图。

获得流程定义的pojo版本, 可以用来通过java解析流程,而不必通过xml。

RuntimeService

Activiti的流程运行管理类。可以从这个服务类中获取很多关于流程执行相关的信息

TaskService

Activiti的任务管理类。可以从这个类中获取任务的信息。

HistoryService

Flowable的历史管理类,可以查询历史信息,执行流程时,引擎会保存很多数据(根据配置),比如流程实例启动时间,任务的参与者, 完成任务的时间,每个流程实例的执行路径,等等。 这个服务主要通过查询功能来获得这些数据。

ManagementService

Activiti的引擎管理类,提供了对Flowable 流程引擎的管理和维护功能,这些功能不在工作流驱动的应用程序中使用,主要用于 Flowable 系统的日常维护。

4.图标介绍

  BPMN 2.0是业务流程建模符号2.0的缩写。它由Business Process Management Initiative这个非营利协会创建并不断发展。作为一种标识,BPMN 2.0是使用一些符号来明确业务流程设计流程图的一整套符号规范,它能增进业务建模时的沟通效率。目前BPMN2.0是最新的版本,它用于在BPM上下文中进行布局和可视化的沟通。接下来我们先来了解在流程设计中常见的 符号。

BPMN2.0的基本符合主要包含:

4.1 事件图标

  在Flowable中的事件图标启动事件,边界事件,中间事件和结束事件.

image-20220320103803308

4.2 活动(任务)图标

  活动是工作或任务的一个通用术语。一个活动可以是一个任务,还可以是一个当前流程的子处理流程; 其次,你还可以为活动指定不同的类型。常见活动如下:

image-20220320103929543

4.3 结构图标

  结构图标可以看做是整个流程活动的结构,一个流程中可以包括子流程。常见的结构有:

image-20220320104025737

4.4 网关图标

  网关用来处理决策,有几种常用网关需要了解:

image-20220320104157816

排他网关:只执行第一个符合条件的分支.
并行网关:顾名思义,就是通过这个网关,可以把一个顺序流分成多个顺序流来执行,然后再通过这个网关,把分出来的多条顺序流合并为一个顺序流继续执行。
包容网关:包容网关同时执行所有符合条件的分支,如果没有为包容网关的出口连接线设置过任何条件,在经过包容网关后的效果其实等同于上面的并行网关,它会生成多个顺序流.
事件网关:

5.流程部署详解

5.1 部署实现

  我们先来看下流程部署的具体过程。代码实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/**
     * 部署流程
     */
    @Test
    public void test3(){
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        RepositoryService repositoryService = processEngine.getRepositoryService();
        Deployment deploy = repositoryService.createDeployment()
                .addClasspathResource("holiday-request-new.bpmn20.xml")
                .name("请假流程...")
                .category("请假") // 分类
                .tenantId("dpb") // 租户id
                .deploy();
        System.out.println("deploy.getId() = " + deploy.getId());
        System.out.println("deploy.getName() = " + deploy.getName());
        System.out.println("deploy.getCategory() = " + deploy.getCategory());
    }

5.2 部署涉及表结构

涉及到的三张表:

部署资源表:act_ge_bytearray

字段 名称 备注
ID_ 主键  
REV_ 版本号  
NAME_ 名称 部署的文件名称,如:holiday-request-new.bpmn20.xml、holiday-request-new.bpmn20.png
DEPLOYMENT_ID_ 部署ID  
BYTES_ 字节(二进制数据)  
GENERATED_ 是否系统生成 0为用户上传,
1为系统自动生成, 比如系统会 自动根据xml生 成png

部署ID表:act_re_deployment

字段 名称 备注
ID_ 主键  
NAME_ 名称  
CATEGORY_ 分类  
TENANT_ID_ 租户ID  
DEPLOY_TIME_ 部署时间  
DERIVED_FROM_ 来源于  
DERIVED_FROM_ROOT_ 来源于  
ENGINE_VERSION_ 流程引擎的版本  

流程表:act_re_procdef

字段 名称 备注
ID_ 主键  
REV_ 版本号  
CATEGORY_ 分类 流程定义的Namespace就是类别
NAME_ 名称  
KEY_ 标识  
VERSION_ 版本  
DEPLOYMENT_ID_ 部署ID  
RESOURCE_NAME_ 资源名称 流程bpmn文件名称
DGRM_RESOURCE_NAME_ 图片资源名称  
DESCRIPTION_ 描述  
HAS_START_FORM_KEY_ 拥有开始表单标识 start节点是否存在formKey 0否 1是
HAS_GRAPHICAL_NOTATION_ 拥有图形信息  
SUSPENSION_STATE_ 挂起状态 暂停状态 1激活 2暂停
TENANT_ID_ 租户ID  
     

注意:

业务流程定义数据表。此表和ACT_RE_DEPLOYMENT是多对一的关系,即,一个部署的bar包里可能包含多个流程定义文件,每个流程定义文件都会有一条记录在ACT_REPROCDEF表内,每个流程定义的数据,都会对于ACT_GE_BYTEARRAY表内的一个资源文件和PNG图片文件。和ACT_GE_BYTEARRAY的关联是通过程序用ACT_GE_BYTEARRAY.NAME与ACT_RE_PROCDEF.NAME_完成的

5.3 挂起和激活

  部署的流程默认的状态为激活,如果我们暂时不想使用该定义的流程,那么可以挂起该流程。当然该流程定义下边所有的流程实例全部暂停。

流程定义为挂起状态,该流程定义将不允许启动新的流程实例,同时该流程定义下的所有的流程实例都将全部挂起暂停执行。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
/**
     * 挂起流程
     */
    @Test
    public void test05(){
        // 获取流程引擎对象
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        RepositoryService repositoryService = processEngine.getRepositoryService();
        ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery()
                .processDefinitionId("holiday:1:4")
                .singleResult();
        // 获取流程定义的状态
        boolean suspended = processDefinition.isSuspended();
        System.out.println("suspended = " + suspended);
        if(suspended){
            // 表示被挂起
            System.out.println("激活流程定义");
            repositoryService.activateProcessDefinitionById("holiday:1:4",true,null);
        }else{
            // 表示激活状态
            System.out.println("挂起流程");
            repositoryService.suspendProcessDefinitionById("holiday:1:4",true,null);
        }
    }

具体的实现其实就是更新了流程定义表中的字段

image-20220321210010518

而且通过REV_字段来控制数据安全,也是一种乐观锁的体现了,如果要启动一个已经挂起的流程就会出现如下的错误

image-20220321211858122

6.启动流程实例

  然后我们来看看启动流程实例的过程。实现代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/**
     * 启动流程实例
     */
    @Test
    public void testRunProcess(){
        // 获取流程引擎对象
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        // 启动流程实例通过 RuntimeService 对象
        RuntimeService runtimeService = processEngine.getRuntimeService();
        // 构建流程变量
        Map<String,Object> variables = new HashMap<>();
        variables.put("employee","张三") ;// 谁申请请假
        variables.put("nrOfHolidays",3); // 请几天假
        variables.put("description","工作累了,想出去玩玩"); // 请假的原因
        // 启动流程实例,第一个参数是流程定义的id
        ProcessInstance processInstance = runtimeService
                .startProcessInstanceById("holiday:1:4", variables);// 启动流程实例
        // 输出相关的流程实例信息
        System.out.println("流程定义的ID:" + processInstance.getProcessDefinitionId());
        System.out.println("流程实例的ID:" + processInstance.getId());
        System.out.println("当前活动的ID:" + processInstance.getActivityId());
    }

  当我们启动了一个流程实例后,会在ACT_RU_*对应的表结构中操作,运行时实例涉及的表结构共10张:

  • ACT_RU_DEADLETTER_JOB 正在运行的任务表
  • ACT_RU_EVENT_SUBSCR 运行时事件
  • ACT_RU_EXECUTION 运行时流程执行实例
  • ACT_RU_HISTORY_JOB 历史作业表
  • ACT_RU_IDENTITYLINK 运行时用户关系信息
  • ACT_RU_JOB 运行时作业表
  • ACT_RU_SUSPENDED_JOB 暂停作业表
  • ACT_RU_TASK 运行时任务表
  • ACT_RU_TIMER_JOB 定时作业表
  • ACT_RU_VARIABLE 运行时变量表

  启动一个流程实例的时候涉及到的表有

  • ACT_RU_EXECUTION 运行时流程执行实例
  • ACT_RU_IDENTITYLINK 运行时用户关系信息
  • ACT_RU_TASK 运行时任务表
  • ACT_RU_VARIABLE 运行时变量表

ACT_RU_EXECUTION表结构

字段 名称 备注
ID_ 主键  
REV_ 版本号  
PROC_INST_ID_ 流程实例ID  
BUSINESS_KEY_ 业务主键ID  
PARENT_ID_ 父执行流的ID  
PROC_DEF_ID_ 流程定义的数据ID  
SUPER_EXEC_    
ROOT_PROC_INST_ID_ 流程实例的root流程id  
ACT_ID_ 节点实例ID  
IS_ACTIVE_ 是否存活  
IS_CONCURRENT_ 执行流是否正在并行  
IS_SCOPE_    
IS_EVENT_SCOPE_    
IS_MI_ROOT_    
SUSPENSION_STATE_ 流程终端状态  
CACHED_ENT_STATE_    
TENANT_ID_ 租户编号  
NAME_    
START_TIME_ 开始时间  
START_USER_ID_ 开始的用户编号  
LOCK_TIME_ 锁定时间  
IS_COUNT_ENABLED_    
EVT_SUBSCR_COUNT_    
TASK_COUNT_    
JOB_COUNT_    
TIMER_JOB_COUNT_    
SUSP_JOB_COUNT_    
DEADLETTER_JOB_COUNT_    
VAR_COUNT_    
ID_LINK_COUNT_    

创建流程实例后对应的表结构的数据

image-20220322133108405

image-20220322133219534

ACT_RU_TASK 运行时任务表

字段 名称 备注
ID_ 主键  
REV_ 版本号  
EXECUTION_ID_ 任务所在的执行流ID  
PROC_INST_ID_ 流程实例ID  
PROC_DEF_ID_ 流程定义数据ID  
NAME_ 任务名称  
PARENT_TASK_ID_ 父任务ID  
DESCRIPTION_ 说明  
TASK_DEF_KEY_ 任务定义的ID值  
OWNER_ 任务拥有人  
ASSIGNEE_ 被指派执行该任务的人  
DELEGATION_ 委托人  
PRIORITY_ 优先级  
CREATE_TIME_ 创建时间  
DUE_DATE_ 耗时  
CATEGORY_ 类别  
SUSPENSION_STATE_ 是否挂起 1代表激活 2代表挂起
TENANT_ID_ 租户编号  
FORM_KEY_    
CLAIM_TIME_ 拾取时间  

创建流程实例后对应的表结构的数据

image-20220322133307195

image-20220322133335326

ACT_RU_VARIABLE 运行时变量表

字段 名称 备注
ID_ 主键  
REV_ 版本号  
TYPE_ 参数类型 可以是基本的类型,也可以用户自行扩展
NAME_ 参数名称  
EXECUTION_ID_ 参数执行ID  
PROC_INST_ID_ 流程实例ID  
TASK_ID_ 任务ID  
BYTEARRAY_ID_ 资源ID  
DOUBLE_ 参数为double,则保存在该字段中  
LONG_ 参数为long,则保存在该字段中  
TEXT_ 用户保存文本类型的参数值  
TEXT2_ 用户保存文本类型的参数值  

创建流程实例后对应的表结构的数据

image-20220322133406398

image-20220322133439827

ACT_RU_IDENTITYLINK 运行时用户关系信息

字段 名称 备注
ID_ 主键  
REV_ 版本号  
GROUP_ID_ 用户组ID  
TYPE_ 关系数据类型 assignee支配人(组)、candidate候选人(组)、owner拥有人,participant参与者
USER_ID_ 用户ID  
TASK_ID_ 任务ID  
PROC_INST_ID_ 流程定义ID  
PROC_DEF_ID_ 属性ID  

创建流程实例后对应的表结构的数据:

image-20220322133501720

7.处理流程

  上面的流程已经流转到了zhangsan这个用户这里,然后可以开始审批了

1
2
3
4
5
6
7
8
9
10
11
12
// 获取流程引擎对象
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        TaskService taskService = processEngine.getTaskService();
        Task task = taskService.createTaskQuery()
                .processDefinitionId("holiday:1:4")
                .taskAssignee("zhangsan")
                .singleResult();
        // 添加流程变量
        Map<String,Object> variables = new HashMap<>();
        variables.put("approved",false); // 拒绝请假
        // 完成任务
        taskService.complete(task.getId(),variables);

  在正常处理流程中涉及到的表结构

  • ACT_RU_EXECUTION 运行时流程执行实例
  • ACT_RU_IDENTITYLINK 运行时用户关系信息
  • ACT_RU_TASK 运行时任务表
  • ACT_RU_VARIABLE 运行时变量表

ACT_RU_TASK 运行时任务表 :会新生成一条记录

image-20220322135040119

image-20220322135125703

ACT_RU_VARIABLE 运行时变量表:会记录新的流程变量

image-20220322135204021

当然流程实例也可以挂起

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// 1.获取ProcessEngine对象
ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
// 2.获取RuntimeService
RuntimeService runtimeService = engine.getRuntimeService();
// 3.获取流程实例对象
ProcessInstance processInstance = runtimeService.createProcessInstanceQuery()
    .processInstanceId("25001")
    .singleResult();
// 4.获取相关的状态操作
boolean suspended = processInstance.isSuspended();
String id = processInstance.getId();
if(suspended){
    // 挂起--》激活
    runtimeService.activateProcessInstanceById(id);
    System.out.println("流程定义:" + id + ",已激活");
}else{
    // 激活--》挂起
    runtimeService.suspendProcessInstanceById(id);
    System.out.println("流程定义:" + id + ",已挂起");
}

启动第二个流程实例后再查看相关的表结构时,对他们的关系理解会更加的清楚一些

启动一个新的流程实例对应的就会产生两条记录

image-20220322135605252

IDENTITYLINK中会记录每次流程操作的信息

image-20220322135636841

image-20220322135659671

流程变量数据,及时key 相同,但是属于不同的流程实例相互间也是隔离的

image-20220322135719104

8.完成一个流程

  然后我们把第一个流程处理完成

1
2
3
4
5
6
7
8
9
10
11
ProcessEngine processEngine = cfg.buildProcessEngine();
TaskService taskService = processEngine.getTaskService();
Task task = taskService.createTaskQuery()
    .processDefinitionId("holiday:1:4")
    .taskAssignee("lisi")
    .singleResult();
// 添加流程变量
Map<String,Object> variables = new HashMap<>();
variables.put("approved",false); // 拒绝请假
// 完成任务
taskService.complete(task.getId(),variables);

处理完了一个工作流程后,我们来看看相关的表结构信息

首先我们会发现

  • ACT_RU_EXECUTION 运行时流程执行实例
  • ACT_RU_IDENTITYLINK 运行时用户关系信息
  • ACT_RU_TASK 运行时任务表
  • ACT_RU_VARIABLE 运行时变量表

这四张表中对应的数据都没有了,也就是这个流程已经不是运行中的流程了。然后在对应的历史表中我们可以看到相关的信息

  • 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_HI_ACTINST 历史的流程实例

字段 名称 备注
ID_ 主键  
PROC_DEF_ID_ 流程定义ID  
PROC_INST_ID_ 流程实例ID  
EXECUTION_ID_ 执行ID  
ACT_ID_ 节点实例ID  
TASK_ID_ 任务ID  
CALL_PROC_INST_ID_ 调用外部的流程实例ID  
ACT_NAME_ 节点名称  
ACT_TYPE_ 节点类型  
ASSIGNEE_ 处理人  
START_TIME_ 开始时间  
END_TIME_ 结束时间  
DURATION_ 耗时  
DELETE_REASON_ 删除原因  
TENANT_ID_ 租户编号  

image-20220322141800554

image-20220322141825065

ACT_HI_IDENTITYLINK 历史的流程运行过程中用户关系

字段 名称 备注
ID_ 主键  
GROUP_ID_ 组编号  
TYPE_ 类型  
USER_ID_ 用户编号  
TASK_ID_ 任务编号  
CREATE_TIME_ 创建时间  
PROC_INST_ID_ 流程实例编号  
SCOPE_ID_    
SCOPE_TYPE_    
SCOPE_DEFINITION_ID_    
     

image-20220322141717826

ACT_HI_PROCINST 历史的流程实例

字段 名称 备注
ID_ 主键  
PROC_INST_ID_ 流程实例ID  
BUSINESS_KEY_ 业务主键  
PROC_DEF_ID_ 属性ID  
START_TIME_ 开始时间  
END_TIME_ 结束时间  
DURATION_ 耗时  
START_USER_ID_ 起始人  
START_ACT_ID_ 起始节点  
END_ACT_ID_ 结束节点  
SUPER_PROCESS_INSTANCE_ID_ 父流程实例ID  
DELETE_REASON_ 删除原因  
TENANT_ID_ 租户编号  
NAME_ 名称  

image-20220322141855401

image-20220322141912602

ACT_HI_TASKINST 历史的任务实例

字段 名称 备注
ID_ 主键  
PROC_DEF_ID_ 流程定义ID  
TASK_DEF_KEY_ 任务定义的ID值  
PROC_INST_ID_ 流程实例ID  
EXECUTION_ID_ 执行ID  
PARENT_TASK_ID_ 父任务ID  
NAME_ 名称  
DESCRIPTION_ 说明  
OWNER_ 实际签收人 任务的拥有者 签收人(默认为空,只有在委托时才有值)
ASSIGNEE_ 被指派执行该任务的人  
START_TIME_ 开始时间  
CLAIM_TIME_ 任务拾取时间  
END_TIME_ 结束时间  
DURATION_ 耗时  
DELETE_REASON_ 删除原因  
PRIORITY_ 优先级别  
DUE_DATE_ 过期时间  
FORM_KEY_ 节点定义的formkey  
CATEGORY_ 类别  
TENANT_ID_ 租户  

image-20220322142609163

image-20220322142650699

ACT_HI_VARINST 历史的流程运行中的变量信息:流程变量虽然在任务完成后在流程实例表中会删除,但是在历史表中还是会记录的

字段 名称 备注
ID_ 主键  
PROC_INST_ID_ 流程实例ID  
EXECUTION_ID_ 指定ID  
TASK_ID_ 任务ID  
NAME_ 名称  
VAR_TYPE_ 参数类型  
REV_ 数据版本  
BYTEARRAY_ID_ 字节表ID  
DOUBLE_ 存储double类型数据  
LONG_ 存储long类型数据  
…..    

image-20220322142756867

好了一个相对简单的流程处理涉及到的相关表结构内容就介绍完了