activiti6-all

介绍

activiti6使用教程

activiti的数据库表结构主要分为五类：

使用教程

案例中流程数据的存储分为h2嵌入式数据库和mysql数据库，推荐使用mysql数据库的方式，方便每个节点查看生成的数据，从而理解流程的运行

案例都在test目录下。可以自行运行看看

mysql数据库

• resources\dbentity\activiti-mysql.cfg.xml 数据库配置文件，
• activiti6-all\src\test\java\com\bushro\activiti\dbentity\DbConfigTest.java 里面有生成表的方法和删除表的方法

    //指定配置文件
    @Rule
    public ActivitiRule activitiRule = new ActivitiRule("dbentity/activiti-mysql.cfg.xml");

h2嵌入式数据库

没有指定默认使用的就是h2嵌入式数据库

    @Rule
    public ActivitiRule activitiRule = new ActivitiRule();

一、通用数据表

1、资源表，act_ge_bytearray

用于保存和流程引擎相关的资源，只要调用了Activiti存储服务的API，涉及的资源均会被转换为byte数组保存到这个表中。 一般情况下，Activiti使用这个表来保存字符串、流程文件的内容、流程图片内容。

主要包含如下字段：

2、属性表，act_ge_property

Activiti将全部的属性抽象为key-value对，每个属性都有名称和值，使用act_ge_property来保存这些属性，该表有以下三个字段。

二、流程存储数据表

1、部署数据表，act_re_deployment。

部署信息会被保存在部署表中

主要包含字段：

2、流程定义表，act_re_procdef。

Activiti在部署添加资源时，如果发布部署的文件是流程文件（.bpmn或者.BPMN20.xml)，则除了会解析这些流程文件，将内容保存到资源表外，还会解析流程文件的内容，形成特定的流程定义数据，写入流程定义表中。

主要包含字段：

三、身份数据表#

1、用户表，act_id_user。

流程引擎的用户信息被保存在act_id_user表中

主要包含字段：

2、用户账号信息表，act_id_info。

Activiti将用户、用户账号和用户信息分为三种数据，其中用户表保存用户的数据，而用户账号和用户信息，则被保存到act_id_info表中。

主要包含字段：

3、用户组表，act_id_group。

保存用户组的数据

主要包含字段：

4、关系表，act_id_membership。

一个用户组下有多个用户，一个用户可以属于不同的用户组，那么这种多对多的关系，就使用关系表来进行描述，关系表为act_id_membership。

PS：act_id_membership的两个字段均做了外键约束，写入该表的数据，必须要有用户和用户组数据与之关联。

主要包含字段：

四、运行时数据表

1、流程实例表，act_ru_execution。

流程启动后，会产生一个流程实例，同时会产生相应的执行流，流程实例和执行流数据均被保存在act_ru_execution表中，如果一个流程实例只有一条执行流，那么该表中只产生一条数据，该数据既表示执行流，也表示流程实例。

主要包含字段：

2、流程任务表，act_ru_task。

流程在运行过程中所产生的任务数据保存在act_ru_task表中

主要包含字段：

3、流程参数表，act_ru_variable。

存放流程中的参数，这类参数包括流程实例参数、执行流参数和任务参数，参数有可能会有多种类型，因此该表使用多个字段来存放参数值。

主要包含字段：

4、流程与身份关系表，act_ru_identitylink。

用户或者用户组与流程数据之间的关系，使用act_ru_identitylink来保存。

主要包含字段：

5、工作数据表，一共4个。

• act_ru_job：一般工作表
• act_ru_deadletter_job：无法执行工作表，用于存放无法执行的工作。
• act_ru_suspended_job：中断工作表，中断工作产生后，会将工作保存到该表中。
• act_ru_timer_job：定时器工作表，用于存放定时器工作。

6、事件描述表，act_ru_event_subscr。

如果流程到达某类事件节点，Activiti会往act_ru_event_subscr表中加入事件描述数据，这些事件描述数据将会决定流程事件的触发。

主要包含字段：

五、历史数据表

1、流程实例表，act_hi_procinst。

流程实例的历史数据会保存在act_hi_procinst表中，只要流程被启动，就会将流程实例的数据写入act_hi_procinst表中。除了基本的流程字段外，与运行时数据表不同的是，历史流程实例表还会记录流程的开始活动ID、结束活动ID等信息。

PS：该表的其他字段含义与运行时的流程视力表字段类似，在此不再赘述。

主要包含字段：

2、流程明细表，act_hi_detail。

记录流程执行过程中的参数或者表单数据，由于在流程执行过程中，会产生大量这类数据，因此默认情况下，Activiti不会保存流程明细数据，除非将流程引擎的历史数据配置为null。

3、历史任务表，act_hi_taskinst。

当流程到达某个任务节点时，就会向历史任务表中写入历史任务数据，该表与运行时的任务表类似。

4、历史行为表，act_hi_actinst。

记录没一个流程活动的实例，一个流程活动将会被记录为一条数据，根据该表可以追踪最完整的流程信息。

5、附件表，act_hi_attachment。

使用任务服务(TaskService)的API，可以添加附件，这些附件的数据将会被保存到act_hi_attachment表中。

主要包含字段：

6、评论表，act_hi_comment。

不只保存评论数据，还会保存某些事件数据，但它的表名为COMMENT，因此更倾向把它叫做评论表。

主要包含字段：

六、DMN规则引擎数据表

1、决策部署表，act_dmn_deployment。

保存决策数据，类似于流程定义部署，每一次部署，可以添加多份决策文件，向部署表中写入一条部署数据。

PS：只启动流程引擎，并不会创建规则引擎表。

主要包含字段：

2、决策表，act_dmn_decision_table。

可以先将决策看做流程定义，决策文件中保存着决策表，部署时会解析决策文件中的决策模型并将其保存到act_dmn_decision_table中。

主要包含字段：

3、部署资源表，act_dmn_deployment_resource。

规则引擎相关的资源，例如决策文件、图片等，被保存在act_dmn_deployment_resource表中，该表类似于流程引擎的资源表。

主要包含字段：

软件架构

软件架构说明

使用说明

核心API

• RepositoryService: 负责对流程定义文件的管理，操作一些静态文件（流程xml、流程图片），获取部署对象和资源对象
• RunTimeService: 对流程进行控制，可用于启动流程、暂停、挂起等，有方便的api来查询正在运行的流程实例和流程对象。可对流程中上下文数据进行设置和获取
• TaskService： 人工任务，对人工任务进行增删改查，可对任务进行指定到用户或用户组。也可以对用户任务上下文数据进行设置和获取 IdentityService: 对用户及用户组的管理，创建用户用户组、维护用户、用户组的关系
• FormService： 流程的表单，对表单的输入类型、格式进行数据渲染
• HistoryService： 已经结束的流程查询、删除，流程上下文的一些快照数据获取
• ManagementService： 对流程引擎基础的管理、用的较少。并对定时任务job管理，可获取数据库表名的方法
• DyanmicBpmService： 动态对流程定义修改，不建议使用

RepositoryService流程存储服务

• 管理流程定义文件xml以及静态资源的服务
• 对特定流程的暂停和激活
• 流程定义启动权限管理

Api

• 部署文件构造器DeploymentBuilder
• 部署文件查询器DeploymentQuery
• 流程定义文件查询对象ProcessDefinitionQuery
• 流程部署文件对象Deployment
• 流程定义文件对象ProcessDefinition
• 流程定义的Java格式BpmnModel

参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request