Flowable基本使用介绍和Flowable数据库表解释

简介: lowable是一个使用Java编写的轻量级业务流程引擎。Flowable流程引擎可用于部署BPMN 2.0流程定义(用于定义流程的行业XML标准), 创建这些流程定义的流程实例,进行查询,访问运行中或历史的流程实例与相关数据,等等。

1、Flowable是什么?

Flowable是一个使用Java编写的轻量级业务流程引擎。Flowable流程引擎可用于部署BPMN 2.0流程定义(用于定义流程的行业XML标准), 创建这些流程定义的流程实例,进行查询,访问运行中或历史的流程实例与相关数据,等等。

简单来说:Flowable将审批节点抽象出来,那么作为使用者而言只需要通过流程设计器定义流程模板,定义动态表单,挂载表单数据,通过流程定义和流程变量启动流程实例即可。使用者不需要知道整个流程具体如何执行,只需要记住审批人是谁,审批通过没有即可。

因此:flowable流程引擎非常适用存在审批的项目上,当然审批是需要提交表单的,因此常常配合表单设计器一起使用。

2、BPMN2.0 是什么?

BPMN(Business Process Model and Notation)是一个业务流程模型标记规范,以精准的执行语义来描述元素的操作,以XML为载体,以符号为可视化业务。

在这里插入图片描述

在这里插入图片描述

目前端是通过Bpmn.js 实现 BPMN2.0规范,设计出来的流程设计器。

3、Flowable数据库表命名规则

Flowable的所有数据库表都以ACT_开头。第二部分是说明表用途的两字符标示符。服务API的命名也大略符合这个规则。

3.1 flowable提供的表

1、ACT_RE_*: 'RE’代表repository。带有这个前缀的表包含“静态”信息,例如流程定义与流程资源(图片、规则等)。
2、ACT_RU_*: 'RU’代表runtime。这些表存储运行时信息,例如流程实例(process instance)、用户任务(user task)、变量(variable)、作业(job)等。Flowable只在流程实例运行中保存运行时数据,并在流程实例结束时删除记录。这样保证运行时表小和快。
3、ACT_HI_*: 'HI’代表history。这些表存储历史数据,例如已完成的流程实例、变量、任务等。
4、ACT_GE_*: 通用数据。在多处使用。
5、ACT_ID_*: 表示组织信息,如用户,用户组,等等。(很少使用)

3.2、ACT_GE_*

ACT_GE_BYTEARRAY:保存流程的bpmn的xml以及流程的Image缩略图等信息

ACT_GE_PROPERTY:Flowable相关的基本信息。比如各个module使用的版本信息。

3.3、ACT_RE_*

’RE’表示repository(存储)。RepositoryService接口操做的表。带此前缀的表包含的是静态信息,如,流程定义,流程的资源(图片,规则等)

ACT_RE_DEPLOYMENT: 部署对象,存储流程名称

ACT_RE_MODEL:基于流程的模型信息,流程设计器设计流程模型保存的数据,包含:建立时间,最后更新时间,元数据(META_INFO_:以json格式保存流程定义的信息),部署ID(DEPLOYMENT_ID_)

ACT_RE_PROCDEF:流程定义表

此表和ACT_RE_DEPLOYMENT是多对一的关系,即,一个部署的bar包里可能包含多个流程定义文件,每一个流程定义文件都会有一条记录在ACT_REPROCDEF表内,每一个流程定义的数据,都会对于ACT_GE_BYTEARRAY表内的一个资源文件和PNG图片文件。

ACT_GE_BYTEARRAY的关联:是经过程序用ACT_GE_BYTEARRAY.NAME与ACT_RE_PROCDEF.NAME_完成的,在数据库表结构中没有体现

分类(CATEGORY_:流程定义的Namespace就是类别),部署ID(DEPLOYMENT_ID_),资源名称(RESOURCE_NAME_:流程bpmn文件名称),拥有开始表单标识(HAS_START_FORM_KEY_:start节点是否存在 formKey 0否 1是),挂起状态(SUSPENSION_STATE_:暂停状态 1激活 2暂停)

3.4、ACT_RU_*

**RU’表示runtime。这是运行时的表存储着流程变量,用户任务,变量,职责(job)等运行时的数据。
flowable只存储实例执行期间的运行时数据,当流程实例结束时,将删除这些记录。这就保证了这些运行时的表小且快。**

ACT_RU_ACTINST:运行中实例的活动表,一般是流程图中正在活动的节点,包含箭头哦

ACT_RU_DEADLETTER_JOB:当JOB执行很多次都无法执行,就会被记录在此表

ACT_RU_ENTITYLINK:还没使用到

ACT_RU_EVENT_SUBSCR:运行时的事件,包含:流程定义ID,流程实例ID,执行实例ID,节点ID,建立时间等

ACT_RU_EXECUTION:运行的实例表,包含:流程实例ID,流程定义ID,父级ID,父级的执行实例ID,节点ID,挂起状态(SUSPENSION_STATE_:1激活 2暂停),缓存状态(CACHED_ENT_STATE_:缓存的状态, 1 事件监听 2 人工任务 3 异步做业)

ACT_RU_HISTORY_JOB; 运行中的定时任务历史表

ACT_RU_IDENTITYLINK: 当前任务执行人的信息,主要存储当前节点参与者的信息,包含:用户组ID,用户ID,任务ID,流程实例ID,流程定义ID

ACT_RU_JOB:运行中的异步任务

  • 锁定过时时间(LOCK_EXP_TIME_),挂起者(LOCK_OWNER_),是否惟一(EXCLUSIVE_),执行实例ID,流程实例ID,流程定义ID,重试次数(RETRIES_),截至时间(DUEDATE_)
  • 须要启用JOB组件JobExecutor 是管理一组线程的组件,这些线程用于触发定时器(包括后续的异步消息)。在单元测试场景下,使用多线程会很笨重。
  • ManagementService.createJobQuery 用于查询,
  • ManagementService.executeJob 用于执行做业。
  • 这样做业的执行就能够在单元测试内部控制。为了不做业执行器的干扰,能够将它关闭。默认状况下, JobExecutor 在流程引擎启动时激活。

当你不但愿 JobExecutor 随流程引擎启动时,设置:

  • 启用异步执行器 Async executor activation

AsyncExecutor 是管理线程池的组件,这个线程池用于触发定时器与异步任务。
默认状况下,因为历史缘由,当使用 JobExecutor 时, AsyncExecutor 不生效。然而咱们建议使用新的 AsyncExecutor 代替JobExecutor ,经过定义两个参数实现

参数 asyncExecutorEnabled 用于启用异步执行器,代替老的做业执行器。
参数 asyncExecutorActivate 命令Activiti引擎在启动时启动异步执行器线程池。

ACT_RU_SUSPENDED_JOB:暂停的任务表。如果一个异步任务在运行中,被暂停。就会记录在词表

ACT_RU_TASK:运行中的正常节点任务,
包含:
主键(任务ID),执行实例ID,流程实例ID,流程定义ID,父任务ID,被代理人(OWNER_:通常状况下为空,只有在委托时才有值),经办人(GNEE_:签收人或者委托人),委托状态(DELEGATION_:委托状态 PENDING委托中,RESOLVED已处理),优先级(PRIORITY_),建立时间,截至时间,挂起状态(SUSPENSION_STATE_:暂停状态 1激活 2暂停)

ACT_RU_TIMER_JOB:定时作业表

ACT_RU_VARIABLE:运行中的流程实例变量,流程变量

3.5、ACT_ID_*

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:登录相关日志

ACT_ID_USER:用户

3.6、ACT_HI_*

’HI’表示history。就是这些表包含着历史的相关数据,如结束的流程实例,变量,任务,等等。

ACT_HI_ACTINST: 流程实例历史,记录流程流转过的全部节点,包括流程定义ID,流程实例ID,执行节点的ID/名称,执行的指向箭头,办理人ID,开始时间,结束时间,删除缘由等

ACT_HI_ATTACHMENT:实例的历史附件,几乎不会使用,会加大数据库很大的一个loading

ACT_HI_COMMENT:实例的历史备注,存放历史流程的审批意见

ACT_HI_DETAIL:实例流程详细信息

ACT_HI_IDENTITYLINK: 实例节点中,如果指定了目标人,产生的历史。主要存储当前节点参与者的信息,好比参与者ID,参与的流程实例ID,任务ID,参与者扮演的角色类型{assignee(办理者)、candidate(候补者)、owner(委托的办理者)、starter(发起者) 、participant(参与者)}

ACT_HI_PROCINST:流程实例历史

ACT_HI_TASKINST:流程实例的任务历史

ACT_HI_VARINST:流程实例的变量历史

3.7、FLW_*

FLW_CHANNEL_DEFINITION: 泳池管道定义表

FLW_EVENT_DEFINITION:事件定义

FLW_EVENT_DEPLOYMENT:事件必输

FLW_EVENT_RESOURCE:事件所需资源

FLW_EV_DATABASECHANGELOG:Liquibase执行的记录

FLW_EV_DATABASECHANGELOGLOCK:Liquibase执行锁

FLW_RU_BATCH:暂时未知

FLW_RU_BATCH_PART:暂时未知

4、Flowable核心类

4.1、RepositoryService 持久化部署

1.提供了带条件的查询模型流程定义的api
repositoryService.createXXXQuery()
例如:
repositoryService.createModelQuery().list() 模型查询 
repositoryService.createProcessDefinitionQuery().list() 流程定义查询

repositoryService.createXXXXQuery().XXXKey(XXX) (查询该key是否存在)

2.提供一大波模型与流程定义的通用方法
模型相关
repositoryService.getModel()  (获取模型)
repositoryService.saveModel()  (保存模型)
repositoryService.deleteModel() (删除模型)
repositoryService.createDeployment().deploy(); (部署模型)
repositoryService.getModelEditorSource()  (获得模型JSON数据的UTF8字符串)
repositoryService.getModelEditorSourceExtra()  (获取PNG格式图像)

3.流程定义相关
repositoryService.getProcessDefinition(ProcessDefinitionId);  获取流程定义具体信息
repositoryService.activateProcessDefinitionById() 激活流程定义
repositoryService.suspendProcessDefinitionById()  挂起流程定义
repositoryService.deleteDeployment()  删除流程定义
repositoryService.getProcessDiagram()获取流程定义图片流
repositoryService.getResourceAsStream()获取流程定义xml流
repositoryService.getBpmnModel(pde.getId()) 获取bpmn对象(当前进行到的那个节点的流程图使用)

4.流程定义授权相关
repositoryService.getIdentityLinksForProcessDefinition() 流程定义授权列表
repositoryService.addCandidateStarterGroup()新增组流程授权
repositoryService.addCandidateStarterUser()新增用户流程授权
repositoryService.deleteCandidateStarterGroup() 删除组流程授权
repositoryService.deleteCandidateStarterUser()  删除用户流程授权

4.2、RuntimeService 流程运行

runtimeService.createProcessInstanceBuilder().start() 发起流程
runtimeService.deleteProcessInstance() 删除正在运行的流程
runtimeService.suspendProcessInstanceById() 挂起流程定义
runtimeService.activateProcessInstanceById() 激活流程实例
runtimeService.getVariables(processInstanceId); 获取表单中填写的值
runtimeService.getActiveActivityIds(processInstanceId)获取以进行的流程图节点 (当前进行到的那个节点的流程图使用)

runtimeService.createChangeActivityStateBuilder().moveExecutionsToSingleActivityId(executionIds, endId).changeState(); 终止流程

4.3、HistoryService 流程历史服务

注意:包含已完成和为完成的流程实例

historyService.createHistoricProcessInstanceQuery().list() 查询流程实例列表(历史流程,包括未完成的)
historyService.createHistoricProcessInstanceQuery().list().foreach().getValue() 可以获取历史中表单的信息
historyService.createHistoricProcessInstanceQuery().processInstanceId(processInstanceId).singleResult(); 根绝id查询流程实例
historyService.deleteHistoricProcessInstance() 删除历史流程
historyService.deleteHistoricTaskInstance(taskid); 删除任务实例
historyService.createHistoricActivityInstanceQuery().processInstanceId(processInstanceId).list()  流程实例节点列表 (当前进行到的那个节点的流程图使用)

4.4、TaskService 任务服务

流转的节点审批
taskService.createTaskQuery().list() 待办任务列表
taskService.createTaskQuery().taskId(taskId).singleResult();  待办任务详情
taskService.saveTask(task); 修改任务
taskService.setAssignee() 设置审批人
taskService.addComment() 设置审批备注
taskService.complete() 完成当前审批
taskService.getProcessInstanceComments(processInstanceId); 查看任务详情(也就是都经过哪些人的审批,意见是什么)
taskService.delegateTask(taskId, delegater); 委派任务
taskService.claim(taskId, userId);认领任务
taskService.unclaim(taskId); 取消认领
taskService.complete(taskId, completeVariables); 完成任务

任务授权
taskService.addGroupIdentityLink()新增组任务授权
taskService.addUserIdentityLink() 新增人员任务授权
taskService.deleteGroupIdentityLink() 删除组任务授权
taskService.deleteUserIdentityLink() 删除人员任务授权

4.5、ManagementService

1、主要是执行自定义命令。

managementService.executeCommand(new classA())  执行classA的内部方法

2、在自定义的方法中可以使用以下方法获取repositoryService。

ProcessEngineConfiguration processEngineConfiguration =
            CommandContextUtil.getProcessEngineConfiguration(commandContext);
RepositoryService repositoryService = processEngineConfiguration.getRepositoryService();

4.6、IdentityService

操作用户服务的

注意:

 // 设置流程发起者  设置前者可以在历史流程实例中查询到
identityService.setAuthenticatedUserId(sysUser.getUserId());

5、flowable中文文档

flowable中文文档

相关文章
|
7月前
|
存储 数据库
工作流Flowable 数据库表结构说明、Flowable 数据字典说明
工作流Flowable 数据库表结构说明、Flowable 数据字典说明
470 0
|
4天前
|
存储 Oracle 关系型数据库
数据库传奇:MySQL创世之父的两千金My、Maria
《数据库传奇:MySQL创世之父的两千金My、Maria》介绍了MySQL的发展历程及其分支MariaDB。MySQL由Michael Widenius等人于1994年创建,现归Oracle所有,广泛应用于阿里巴巴、腾讯等企业。2009年,Widenius因担心Oracle收购影响MySQL的开源性,创建了MariaDB,提供额外功能和改进。维基百科、Google等已逐步替换为MariaDB,以确保更好的性能和社区支持。掌握MariaDB作为备用方案,对未来发展至关重要。
18 3
|
4天前
|
安全 关系型数据库 MySQL
MySQL崩溃保险箱:探秘Redo/Undo日志确保数据库安全无忧!
《MySQL崩溃保险箱:探秘Redo/Undo日志确保数据库安全无忧!》介绍了MySQL中的三种关键日志:二进制日志(Binary Log)、重做日志(Redo Log)和撤销日志(Undo Log)。这些日志确保了数据库的ACID特性,即原子性、一致性、隔离性和持久性。Redo Log记录数据页的物理修改,保证事务持久性;Undo Log记录事务的逆操作,支持回滚和多版本并发控制(MVCC)。文章还详细对比了InnoDB和MyISAM存储引擎在事务支持、锁定机制、并发性等方面的差异,强调了InnoDB在高并发和事务处理中的优势。通过这些机制,MySQL能够在事务执行、崩溃和恢复过程中保持
22 3
|
4天前
|
SQL 关系型数据库 MySQL
数据库灾难应对:MySQL误删除数据的救赎之道,技巧get起来!之binlog
《数据库灾难应对:MySQL误删除数据的救赎之道,技巧get起来!之binlog》介绍了如何利用MySQL的二进制日志(Binlog)恢复误删除的数据。主要内容包括: 1. **启用二进制日志**:在`my.cnf`中配置`log-bin`并重启MySQL服务。 2. **查看二进制日志文件**:使用`SHOW VARIABLES LIKE 'log_%';`和`SHOW MASTER STATUS;`命令获取当前日志文件及位置。 3. **创建数据备份**:确保在恢复前已有备份,以防意外。 4. **导出二进制日志为SQL语句**:使用`mysqlbinlog`
27 2
|
17天前
|
关系型数据库 MySQL 数据库
Python处理数据库:MySQL与SQLite详解 | python小知识
本文详细介绍了如何使用Python操作MySQL和SQLite数据库,包括安装必要的库、连接数据库、执行增删改查等基本操作,适合初学者快速上手。
129 15
|
11天前
|
SQL 关系型数据库 MySQL
数据库数据恢复—Mysql数据库表记录丢失的数据恢复方案
Mysql数据库故障: Mysql数据库表记录丢失。 Mysql数据库故障表现: 1、Mysql数据库表中无任何数据或只有部分数据。 2、客户端无法查询到完整的信息。
|
18天前
|
关系型数据库 MySQL 数据库
数据库数据恢复—MYSQL数据库文件损坏的数据恢复案例
mysql数据库文件ibdata1、MYI、MYD损坏。 故障表现:1、数据库无法进行查询等操作;2、使用mysqlcheck和myisamchk无法修复数据库。
|
22天前
|
SQL 关系型数据库 MySQL
MySQL导入.sql文件后数据库乱码问题
本文分析了导入.sql文件后数据库备注出现乱码的原因,包括字符集不匹配、备注内容编码问题及MySQL版本或配置问题,并提供了详细的解决步骤,如检查和统一字符集设置、修改客户端连接方式、检查MySQL配置等,确保导入过程顺利。
|
1月前
|
关系型数据库 MySQL 数据库
GBase 数据库如何像MYSQL一样存放多行数据
GBase 数据库如何像MYSQL一样存放多行数据
|
1月前
|
SQL 关系型数据库 MySQL
12 PHP配置数据库MySQL
路老师分享了PHP操作MySQL数据库的方法,包括安装并连接MySQL服务器、选择数据库、执行SQL语句(如插入、更新、删除和查询),以及将结果集返回到数组。通过具体示例代码,详细介绍了每一步的操作流程,帮助读者快速入门PHP与MySQL的交互。
40 1