文章目录
前言
Flowable是一个开源的工作流引擎,它基于Activiti引擎进行发展,Flowable主要用于为业务流程管理(BPM)和工作流的设计、操作、监控提供支持。
1. Flowable的主要表结构
1.1 通用数据表(通用表)
这类表在Flowable中主要提供存储通用类型数据的功能,如流程名称,创建时间等。如下是通用表的主要成员:
- act_ge_bytearray:存储二进制数据,如流程定义文件,流程图等。
- act_ge_property:存储系统全局属性,如数据库版本信息等。
1.2运行时数据表(runtime表)
这类表主要用于在流程运行过程中,存储实时的流程数据。如下是运行时数据表的主要成员:
- act_ru_event_subscr:存储运行时事件订阅数据,如boundary事件等。
- act_ru_execution:存储运行时流程实例,包括当前状态,子流程引用等。
- act_ru_identitylink:存储运行时任务的参与者(用户与组)的关联关系。
- act_ru_job:存储工作任务的相关数据,如执行时间,重试次数等。
- act_ru_task:存储运行时任务数据,如所属流程实例,任务名称等。
- act_ru_variable:存储运行时的流程变量数据。
1.3.历史数据表(history表)
这类表主要用于在流程完成后,存储历史的流程数据,如流程实例,任务,变量等。如下是历史数据表的主要成员:
- act_hi_attachment:存储附件相关历史数据。
- act_hi_comment:存储评论相关历史数据。
- act_hi_detail:存储流程变量修改相关历史数据。
- act_hi_identitylink:存储任务参与者相关历史数据。
- act_hi_procinst:存储流程实例相关历史数据。
- act_hi_actinst:存储活动节点相关历史数据。
- act_hi_taskinst:存储任务实例相关历史数据。
- act_hi_varinst:存储流程变量相关历史数据。
1.4. 身份数据表(identity表)
这类表主要用于存储组织机构和用户权限相关的数据。如下是身份数据表的主要成员:
- act_id_group:存储用户组相关数据。
- act_id_membership:存储用户与用户组的关联关系。
- act_id_user:存储用户相关数据。
1.5. 流程定义数据表(repository表)
这类表主要用于存储流程定义相关的数据。如下是流程定义数据表的主要成员:
- act_re_deployment:存储流程部署相关数据。
- act_re_model:存储流程设计模型相关数据。
- act_re_procdef:存储流程定义相关数据。
2.springboot整合flowable
2.1 流程定义
-
. 流程定义(Process Definition):流程定义是包含所有流程与审批步骤(任务节点、网关等)的XML文件,通常使用BPMN(Business Process Model and Notation) 2.0语言编写。这些文件在部署到Flowable引擎时会存储到数据库中,以便在运行时创建实例。
-
数据库表:Flowable使用关系型数据库来存储审批流相关的信息。其中的相关表格如下:
- ACT_RE_PROCDEF: 存储流程定义信息
- ACT_RE_DEPLOYMENT: 存储部署信息
- ACT_RU_TASK: 存储运行时任务信息
- ACT_RU_EXECUTION: 存储运行时流程实例
- ACT_HI_PROCINST: 存储历史流程实例
- ACT_HI_ACTINST: 存储历史活动实例
- ACT_HI_TASKINST: 存储历史任务实例
- ACT_HI_DETAIL: 存储历史明细数据
- ACT_HI_COMMENT: 存储审批评论数据
2.2 引入依赖
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<flowable.version>6.7.2</flowable.version>
</properties>
<dependency>
<groupId>org.flowable</groupId>
<artifactId>flowable-spring-boot-starter</artifactId>
<version>${flowable.version}</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--flowable引擎自动配置-->
<dependency>
<groupId>org.flowable</groupId>
<artifactId>flowable-spring-boot-starter</artifactId>
<version>${flowable.version}</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
2.3 启动类
/**
* 启动类
*
*/
@SpringBootApplication
public class FlowableApplication
{
public static void main( String[] args )
{
System.out.println("流程系统启动.................");
SpringApplication.run(FlowableApplication.class,args);
System.out.println("流程系统启动成功.................");
}
}
2.4 启动服务
启动服务会在数据库自动创建flowable的表,可能会出现下边的错误。
2.4.1 启动错误,数据库驱动版本问题
nested exception is org.flowable.common.engine.api.FlowableException: Could not update Flowable database schema: unknown version from database: ‘6.8.0.0’
解决方法:
修改mysql驱动的版本为8.0.22
2.4.2 启动报错
Caused by: java.sql.SQLSyntaxErrorException: Specified key was too long; max key length is 767 bytes atcom.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:120) ~[mysql-connector-java-8.0.22.jar:8.0.22] at com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:97) ~[mysql-connector-java-8.0.22.jar:8.0.22]
项目mysql的版本5.6.51
导致上面报错的原因是由于InnoDB表的索引长度限制,在MySQL5.6版本后引入了参数innodb_large_prefix可以解决这个问题。该参数控制是否允许单列的索引长度超过767字节,有ON和OFF两个取值:
ON :Innodb表的行记录格式是Dynamic或Compressed的前提下,单列索引长度上限扩展到3072个字节
OFF:Innodb表的单例索引长度最多为767个字节,索引长度超出后,主键索引会创建失败,辅助索引会被截断成为前缀索引。
进行如下设置,重启mysql:
set global innodb_large_prefix = ON;
SET GLOBAL innodb_file_format=Barracuda;
SET GLOBAL innodb_file_per_table=ON;
2.4 下载BPMN插件
新建流程
文件的后缀名字 demo.bpmn20.xml
demo.bpmn20.xml
<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:flowable="http://flowable.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.flowable.org/processdef">
<process id="DemoProcess" name="DemoProcess">
<startEvent id="start"/>
<sequenceFlow id="flow1" sourceRef="start" targetRef="userTask"/>
<userTask id="userTask" name="User Task" flowable:assignee="${creator}"/>
<sequenceFlow id="flow2" sourceRef="userTask" targetRef="end"/>
<endEvent id="end"/>
</process>
</definitions>
2.5 部署流程
/**
* 流程部署
*/
@Component
public class ProcessDeployer {
@Autowired
private RepositoryService repositoryService;
@PostConstruct
public void init() {
repositoryService.createDeployment()
.addClasspathResource("demo.bpmn20.xml")
.deploy();
}
}
启动完成之后数据库表存储流程定义:=>ACT_RE_PROCDEF
存储部署表
2.6 启动流程
//查询指定流程所有启动的实例列表
@Autowired
private RuntimeService runtimeService;
/**
* 启动
* @param creator
*/
public void startProcess(String creator) {
Map<String, Object> variables = new HashMap<>();
variables.put("creator", creator);
runtimeService.startProcessInstanceByKey("demoProcess", variables);
}
2.7 完成流程
根据用户获取用户任务以及审批流
@Autowired
TaskService taskService;
//获取用户ID获取的任务列表
public List<Task> getTasksAssignedToUser(String userId) {
TaskQuery taskQuery = taskService.createTaskQuery().taskAssignee(userId);
return taskQuery.list();
}
//用户处理流程列表
public void completeTask(String taskId, boolean approved) {
Task task = taskService.createTaskQuery().taskId(taskId).singleResult();
if (task != null) {
Map<String, Object> variables = new HashMap<>();
variables.put("approved", approved);
taskService.complete(taskId, variables);
}
}