Activiti工作流对象关系与表结构

1、Activiti 数据表结构和核心对象关系西安创富电子科技有限公司二一三年九月版本历史日期版本说明（文档修改描述）作者审核人2013.9文档初稿焦剑波目录1 ACTIVITI 数据库表结构 41.1 数据库表名说明 41.2 数据库表结构 42 ACTIVITI 中主要对象的关系 51 Activiti 数据库表结构1.1 数据库表名说明Activiti 工作流总共包含 23 张数据表，所有的表名默认以“ ACT_”开头。 并且表名的第二部分用两个字母表明表的用例， 而这个用例也基本上跟 Service API 匹配。ACT_GE_ *: “GE”代表“ General ”（通用），用在各种情

2、况下； ACT_HI_* : “HI”代表“ History ”（历史），这些表中保存的都是历史数 据，比如执行过的流程实例、变量、任务，等等。当系统中配置 history 的 信息记录级别为“ none”时，这一类表也可以不用；ACT_ID_* : “ID”代表“ Identity ”（身份），这些表中保存的都身份信 息，如用户和组以及两者之间的关系。如果 Activiti 被集成在某一系统当 中的话，这些表可以不用，可以直接使用现有系统中的用户或组信息； ACT_RE_*: “RE”代表“ Repository ”（仓库），这些表中保存一些 静 态信息，如流程定义和流程资源（如图片、规则等

3、）；ACT_RU_*: “RU”代表“ Runtime”（运行时），这些表中保存一些流程实 例、用户任务、 变量等的运行时数据。 Activiti 只保存流程实例在执行过程 中的运行时数据，并且当流程结束后会立即移除这些数据，这是为了保证运 行时表尽量的小并运行的足够快；1.2 数据库表结构Activiti 数据表清单 :表名解释ACT GE BYTEARRAY通用的流程定义和流程资源ACT GE PROPERTY系统相关属性ACT HI ACTINST历史的流程实例ACT HI ATTACHMENT历史的流程附件ACT HI COMMENT历史的说明性信息ACT HI DETAIL历史的流程

4、运行中的细节信息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_

5、RU_EXECUTION运行时流程执行实例ACT_RU_IDENTITYLINK运行时用户关系信息ACT_RU_JOB运行时作业ACT_RU_TASK运行时任务ACT_RU_VARIABLE运行时变量表2 Activiti 中主要对象的关系本节主要介绍在工作流中出现的几个对象及其之间的关系，以及在Activiti 中各个对象是如何关联的。在开始之前先看看下图， 对整个对象结构有个了解， 再结合实例详细介绍理图 1. Activiti 中几个对象之间的关系我们模拟一个请假的流程进行分析介绍，该流程主要包含以下几个步骤： 员工申请请假 部门领导审批人事审批员工销假ProcessInstance 对

6、象员工开始申请请假流程， 通过 runtimeService.startProcessInstance() 方 法启动，引擎会创建一个流程实例( ProcessInstance )。简单来说流程实例就是根据一次 (一条) 业务数据用 流程驱动的入口 ，两者 之间是 一对一的关系。流程引擎会创建一条数据到 ACT_RU_EXECUTIO表N，同时 也会根据 history 的级别决定是否查询相同的历史数据到 ACT_HI_PROCINS表T 。启动完流程之后业务和流程已经建立了关联关系，第一步结束。 启动流程和业务关联区别：对于 自定义表单 来说启动的时候会传入 businessKey 作为业务

7、和流程的 关联属性对于动态表单 来说不需要使用 businessKey 关联，因为所有的数据都保存 在引擎的表中对于外部表单来说businessKey 是可选的，但是一般不会为空， 和自定义 表单类似Execution 对象对于初学者来说， 最难理解的地方就是 ProcessInstance 与 Execution 之间 的关系，要分两种情况说明。 Execution 的含义就是一个流程实例 （ ProcessInstance ）具体要执行的过程对象。不过在说明之前先声明两者的对象映射关系：ProcessInstance （1） Execution（ N） ，（其中 N = 1 ）。1） 值相

8、等的情况：除了在流程中启动的子流程之外，流程启动之后在表 ACT_RU_EXECUTIO中N 的字段 ID_和 PROC_INST_I_D字段值是相同的。图 2. ID_ 和 PROC_INST_ID_相等2） 值不相等的情况： 不相等的情况目前只会出现在子流程中（包含：嵌套、引入），例如一个购 物流程中除了下单、 出库节点之外可能还有一个付款子流程， 在实际企业应用中 付款流程通常是作为公用的， 所以使用子流程作为主流程 （购物流程）的一部分。 当任务到达子流程时引擎会自动创建一个付款流程， 但是这个流程有一个特殊的 地方，在数据库可以直观体现，如下图。图 3. ID_ 和 PROC_INS

9、T_ID不_ 相等上图中有两条数据，第二条数据（嵌入的子流程）的 PARENT_ID等_ 于第一条数 据的 ID_和 PROC_INST_ID，_并且两条数据的 PROC_INST_ID相_ 同。上图中还有一点特殊的地方， 字段 IS_ACTIVE_的值分别是 0和 1，说明正在 执行子流程主流程挂起。Task 对象前面说了 ProcessInstance 和业务是一对一关联的， 和业务数据最亲密； 而 Task 则和用户最亲密的( UserTask)，用户每天的待办事项就是一个个的 Task 对象。从图 1 中看得出 Execution 和 Task 是一对一关系， Task 可以是任何类型

10、的 Task实现，可以是用户任务( UserTask)、Java服务( Java ServiceTask )等， 在实际流程运行中只不过面向对象不同， 用户任务 (UserTask) 需要有人为参与完 成( complete )， Java 服务需要由系统自动执行( execution )。图 4. 表 ACT_RU_TASKTask是在流程定义中看到的最大单位， 每当一个 Task 完成的时候会引擎会 把当前的任务移动到历史中， 然后插入下一个任务插入到表 ACT_RU_TAS中K 。结 合请假流程来说就是让用户点击“完成”按钮提交当前任务是的动作， 引擎自动 根据任务的顺序流或者排他分支判断走向。HistoryActivity (历史活动)图 5. 表 ACT_HI_ACTINSTActivity 包含了流程中所有的活动数据，例如开始事件(图 5 表中的第 1 条数据)、各种分支(排他分支、并行分支等，图 5 表中的第 2条数据)、以及 刚刚提到的 Task 执行记录(如图 5 表中的第 3、4 条数据)。有些人认为 Activity 和 Task 是多对一关系， 其实不是， 从上图中可以看出 来根本没有 Tas