Flowable-UI 入门指南：从零开始的 BPM 之旅

March 14, 2025

什么是Flowable-UI?

Flowable-UI 是 Flowable BPM 平台的用户界面组件，作为一个轻量级的开源工具，它提供了直观的图形化界面，让用户能够便捷地进行业务流程管理。无需编写代码，用户就能快速验证和实现业务流程逻辑，这使其成为流程原型开发的理想选择。

核心模块

Flowable-UI 整合了四个核心模块，每个模块都专注于特定的功能领域： Flowable-UI 模块架构

Flowable Modeler（流程建模器）
- 基于 BPMN 2.0 标准的流程设计工具
- 支持拖拽式的流程图设计
- 可视化的流程定义和编辑功能

Flowable Modeler 界面

Flowable Task（任务管理）
- 流程实例的启动和管理
- 用户任务的处理和分配
- 实时流程状态跟踪

Task 模块界面

Flowable Admin（管理控制台）
- 流程引擎的监控和管理
- 提供数据查询功能
- 流程调试工具

Admin 控制台

Flowable IDM（身份管理）
- 用户和角色管理
- 权限控制
- 支持单点登录
- 多应用协同管理

IDM 管理界面

主要功能

通过 Flowable-UI，用户可以实现以下核心功能：

直观地创建和编辑业务流程
支持多种建模标准：
- BPMN（业务流程建模与符号）
- CMMN（案例管理模型与符号）
- DMN（决策模型与符号）
覆盖从流程设计到执行的完整生命周期管理

快速部署

Flowable-UI 提供了 Docker 镜像，可以通过以下简单步骤快速部署。

1. 使用默认 H2 数据库部署

最简单的部署方式是使用默认的 H2 内存数据库：

docker run -p 8080:8080 flowable/flowable-ui

2. 使用 MySQL 数据库部署

在生产环境中，建议使用 MySQL 等关系型数据库来持久化数据。以下是使用 MySQL 的部署步骤，完整的部署配置代码可以在 GitHub 仓库中找到。

创建配置文件 flowable-default.properties，并修改下面的配置：

# 数据库配置
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://mysql:3306/flowable?characterEncoding=UTF-8&useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=123456

下载 MySQL 驱动：
- 从 Maven 中央仓库下载 MySQL 驱动：mysql-connector-java-8.0.27.jar
创建 docker-compose.yml 文件：

version: '3'

services:
  flowable-ui:
    image: flowable/flowable-ui
    container_name: flowable-ui
    restart: always
    ports:
      - 8080:8080
    volumes:
      - ./flowable-default.properties:/app/WEB-INF/classes/flowable-default.properties
      - ./mysql-connector-java-8.0.27.jar:/app/WEB-INF/lib/mysql-connector-java-8.0.27.jar
  mysql:
    image: mysql:5.7
    environment:
      TZ: Asia/Shanghai
      MYSQL_ROOT_PASSWORD: 123456
      MYSQL_DATABASE: flowable
    restart: always
    volumes:
      - ./data/mysql/data:/var/lib/mysql

启动服务：

docker-compose up -d

访问应用部署完成后，访问以下地址：

打开浏览器访问 http://localhost:8080/flowable-ui
默认登录凭据：
- 用户名：admin
- 密码：test

适用场景

Flowable-UI 特别适合以下场景：

需要快速验证业务流程逻辑的项目
希望通过可视化方式设计流程的团队
追求低代码/无代码流程开发的组织
需要统一的流程管理平台的企业

通过 Flowable-UI，企业可以显著提升业务流程的设计和管理效率，实现流程自动化的快速落地。

重要提示

自 Flowable 7.0.0 版本起，Flowable-UI 应用程序（包括 Flowable Modeler、Task、Admin 和 IDM）已从开源项目中移除。本文内容适用于 Flowable 6.x 及更早版本的历史参考。

Flowable 数据库表结构详解

March 13, 2025

在Flowable工作流引擎中，数据库表结构是整个系统的基础。本文将详细介绍Flowable中最重要的几类表结构，帮助大家更好地理解Flowable的内部工作机制。

Flowable表结构概览

1. 通用命名规则

Flowable的表名都遵循特定的命名规则，主要包括以下前缀：

ACT_RE_*：'RE'表示repository，这些表包含流程定义和流程静态资源
ACT_RU_*：'RU'表示runtime，这些表存储流程运行时的数据
ACT_HI_*：'HI'表示history，这些表存储历史数据
ACT_ID_*：'ID'表示identity，这些表存储身份信息
ACT_GE_*：'GE'表示general，这些表存储通用数据
ACT_APP_*：'APP'表示application，这些表存储应用级别的信息
ACT_CMMN_*：'CMMN'表示Case Management，这些表存储案例管理相关数据
ACT_DMN_*：'DMN'表示Decision Management，这些表存储决策管理相关数据
FLW_*：'FLW'表示Flowable特定的扩展表

2. 核心功能模块表结构

2.1 流程定义相关表（Repository）

ACT_RE_DEPLOYMENT：流程部署表
- 主要字段：
  - ID_：部署ID，主键
  - NAME_：部署名称
  - CATEGORY_：部署类别
  - DEPLOY_TIME_：部署时间
  - TENANT_ID_：租户ID，用于多租户
- 使用场景：每次部署流程定义文件时会产生记录
ACT_RE_PROCDEF：流程定义表
- 主要字段：
  - ID_：主键
  - KEY_：流程定义的标识
  - VERSION_：版本号
  - NAME_：流程定义名称
  - RESOURCE_NAME_：资源文件名称
  - DGRM_RESOURCE_NAME_：流程图资源名称
  - SUSPENSION_STATE_：暂停状态
- 使用场景：存储流程定义的元数据，支持流程定义的版本控制

2.2 运行时数据表（Runtime）

ACT_RU_EXECUTION：运行时流程执行实例表
- 主要字段：
  - ID_：执行实例ID
  - PROC_INST_ID_：流程实例ID
  - BUSINESS_KEY_：业务标识
  - PARENT_ID_：父执行流ID
  - PROC_DEF_ID_：流程定义ID
  - SUPER_EXEC_：父流程实例ID（用于子流程）
- 常用查询示例：
```
-- 查询某个业务关联的流程实例
SELECT * FROM ACT_RU_EXECUTION 
WHERE BUSINESS_KEY_ = '业务ID';

-- 查询所有活动的子流程
SELECT * FROM ACT_RU_EXECUTION 
WHERE SUPER_EXEC_ IS NOT NULL;
```
ACT_RU_TASK：运行时任务表
- 主要字段：
  - ID_：任务ID
  - NAME_：任务名称
  - ASSIGNEE_：受理人
  - CREATE_TIME_：创建时间
  - DUE_DATE_：到期时间
  - PRIORITY_：优先级
  - CATEGORY_：任务类别
- 性能优化建议：
  - 建议为ASSIGNEE_字段创建索引
  - 对于到期时间的查询，建议增加DUE_DATE_的索引
ACT_RU_VARIABLE：运行时变量表
- 主要字段：
  - ID_：变量ID
  - TYPE_：变量类型
  - NAME_：变量名称
  - EXECUTION_ID_：所属执行实例ID
  - PROC_INST_ID_：所属流程实例ID
  - TASK_ID_：所属任务ID
  - BYTEARRAY_ID_：字节数组ID（用于存储序列化的变量）
- 变量类型说明：
  - string：字符串类型
  - integer：整数类型
  - boolean：布尔类型
  - date：日期类型
  - serializable：序列化对象

2.3 历史数据表（History）

ACT_HI_PROCINST：历史流程实例表
- 主要字段：
  - ID_：流程实例ID
  - START_TIME_：开始时间
  - END_TIME_：结束时间
  - DURATION_：持续时间
  - START_USER_ID_：启动用户
  - SUPER_PROCESS_INSTANCE_ID_：父流程实例ID
- 数据清理建议：
```
-- 删除30天前的已完成流程
DELETE FROM ACT_HI_PROCINST 
WHERE END_TIME_ < DATE_SUB(NOW(), INTERVAL 30 DAY);
```
ACT_HI_TASKINST：历史任务实例表
- 主要字段：
  - ID_：任务实例ID
  - PROC_DEF_ID_：流程定义ID
  - TASK_DEF_KEY_：任务定义的ID
  - START_TIME_：开始时间
  - END_TIME_：结束时间
  - ASSIGNEE_：受理人
- 常用统计查询：
```
-- 统计用户任务处理时长
SELECT 
  ASSIGNEE_,
  AVG(TIMESTAMPDIFF(MINUTE, START_TIME_, END_TIME_)) as avg_duration
FROM ACT_HI_TASKINST
WHERE END_TIME_ IS NOT NULL
GROUP BY ASSIGNEE_;
```

2.4 身份数据表（Identity）

ACT_ID_USER：用户表
- 主要字段：
  - ID_：用户ID
  - FIRST_：名
  - LAST_：姓
  - EMAIL_：邮箱
  - PWD_：密码
- 安全建议：
  - 密码字段建议使用加密存储
  - 建议使用外部认证系统集成
ACT_ID_GROUP：用户组表
- 主要字段：
  - ID_：组ID
  - NAME_：组名称
  - TYPE_：组类型
- 应用场景：
  - 部门管理
  - 角色管理
  - 权限分组

2.5 作业和事件相关表

ACT_RU_JOB：运行时作业表
- 主要字段：
  - ID_：作业ID
  - TYPE_：作业类型
  - DUEDATE_：到期时间
  - REPEAT_：重复规则
- 相关作业表：
  - ACT_RU_TIMER_JOB：定时作业表
  - ACT_RU_SUSPENDED_JOB：暂停的作业表
  - ACT_RU_DEADLETTER_JOB：无法执行的作业表
  - ACT_RU_EXTERNAL_JOB：外部作业表
  - ACT_RU_HISTORY_JOB：历史作业表
事件相关表：
- ACT_RU_EVENT_SUBSCR：事件订阅表
- ACT_EVT_LOG：事件日志表
- FLW_EVENT_DEFINITION：事件定义表
- FLW_CHANNEL_DEFINITION：通道定义表

2.6 通用支持表

ACT_GE_BYTEARRAY：二进制数据存储表
- 存储流程定义文件、表单文件等
- 主要字段：
  - ID_：主键
  - NAME_：文件名
  - BYTES_：二进制内容
  - DEPLOYMENT_ID_：部署ID
ACT_GE_PROPERTY：属性表
- 存储系统级别的属性信息
- 主要字段：
  - NAME_：属性名
  - VALUE_：属性值
  - REV_：版本号

3. 扩展功能模块表结构

3.1 CMMN（案例管理）相关表

部署相关表：
- ACT_CMMN_DEPLOYMENT：CMMN部署表
- ACT_CMMN_CASEDEF：案例定义表
运行时表：
- ACT_CMMN_RU_CASE_INST：运行时案例实例表
- ACT_CMMN_RU_PLAN_ITEM_INST：计划项实例表
历史表：
- ACT_CMMN_HI_CASE_INST：历史案例实例表

3.2 DMN（决策管理）相关表

部署相关表：
- ACT_DMN_DEPLOYMENT：DMN部署表
- ACT_DMN_DECISION：决策表定义表
历史表：
- ACT_DMN_HI_DECISION_EXECUTION：决策执行历史表

4. 表关系与性能优化

4.1 核心表关系

流程引擎核心表关系：
ACT_RE_DEPLOYMENT ←──┐
      ↓              │
ACT_RE_PROCDEF ←─┐   │
      ↓          │   │
ACT_RU_EXECUTION │   │
      ↓          │   │
ACT_RU_TASK      │   │
      ↓          │   │
ACT_HI_PROCINST ─┘   │
      ↓              │
ACT_HI_TASKINST ────┘

4.2 性能优化建议

索引优化：

CREATE INDEX idx_task_assignee ON ACT_RU_TASK(ASSIGNEE_);
CREATE INDEX idx_hi_proc_inst_end ON ACT_HI_PROCINST(END_TIME_);
CREATE INDEX idx_ru_execution_proc ON ACT_RU_EXECUTION(PROC_DEF_ID_);

数据清理策略：
- 按年月分表存储历史数据
- 定期归档历史数据
- 及时清理过期数据
查询优化：
- 优先使用API而非直接SQL查询
- 合理使用分页查询
- 避免全表扫描

5. 最佳实践与应用场景

5.1 常见应用场景

5.1.1 请假审批流程示例

让我们通过一个具体的请假审批流程来看数据是如何在各个表中流转的：

请假流程数据流转示意图

流程定义部署阶段

-- ACT_RE_DEPLOYMENT 新增一条部署记录
INSERT INTO ACT_RE_DEPLOYMENT(ID_, NAME_, DEPLOY_TIME_) 
VALUES ('1', '请假流程-V1', '2025-03-13 10:00:00');

-- ACT_RE_PROCDEF 新增一条流程定义记录
INSERT INTO ACT_RE_PROCDEF(ID_, NAME_, KEY_, VERSION_, DEPLOYMENT_ID_)
VALUES ('leave:1:1', '请假申请', 'leave', 1, '1');

发起请假申请

-- ACT_RU_EXECUTION 新增流程实例
INSERT INTO ACT_RU_EXECUTION(ID_, PROC_INST_ID_, BUSINESS_KEY_, PROC_DEF_ID_)
VALUES ('2001', '2001', 'LEAVE-2025-001', 'leave:1:1');

-- ACT_RU_TASK 新增员工填写任务
INSERT INTO ACT_RU_TASK(ID_, EXECUTION_ID_, PROC_INST_ID_, TASK_DEF_KEY_, NAME_)
VALUES ('2002', '2001', '2001', 'fillForm', '填写请假申请');

-- ACT_RU_VARIABLE 保存表单数据
INSERT INTO ACT_RU_VARIABLE(ID_, EXECUTION_ID_, NAME_, TYPE_, TEXT_)
VALUES 
('2003', '2001', 'days', 'integer', '3'),
('2004', '2001', 'reason', 'string', '年假');

直接主管审批

-- ACT_RU_TASK 更新前一个任务状态，新增审批任务
UPDATE ACT_RU_TASK SET END_TIME_ = NOW() WHERE ID_ = '2002';
INSERT INTO ACT_RU_TASK(ID_, EXECUTION_ID_, PROC_INST_ID_, TASK_DEF_KEY_, NAME_, ASSIGNEE_)
VALUES ('2005', '2001', '2001', 'leaderApprove', '直接主管审批', 'leader1');

-- ACT_HI_TASKINST 记录任务历史
INSERT INTO ACT_HI_TASKINST(ID_, PROC_INST_ID_, TASK_DEF_KEY_, NAME_, START_TIME_, END_TIME_)
VALUES ('2002', '2001', 'fillForm', '填写请假申请', '2025-03-13 10:05:00', '2025-03-13 10:10:00');

人事审批

-- ACT_RU_TASK 更新主管审批任务，新增人事审批任务
UPDATE ACT_RU_TASK SET END_TIME_ = NOW() WHERE ID_ = '2005';
INSERT INTO ACT_RU_TASK(ID_, EXECUTION_ID_, PROC_INST_ID_, TASK_DEF_KEY_, NAME_, ASSIGNEE_)
VALUES ('2006', '2001', '2001', 'hrApprove', '人事审批', 'hr1');

-- ACT_HI_TASKINST 记录主管审批历史
INSERT INTO ACT_HI_TASKINST(ID_, PROC_INST_ID_, TASK_DEF_KEY_, NAME_, START_TIME_, END_TIME_)
VALUES ('2005', '2001', 'leaderApprove', '直接主管审批', '2025-03-13 10:10:00', '2025-03-13 11:00:00');

流程结束

-- ACT_RU_TASK 删除最后一个任务
DELETE FROM ACT_RU_TASK WHERE ID_ = '2006';

-- ACT_RU_EXECUTION 删除执行实例
DELETE FROM ACT_RU_EXECUTION WHERE PROC_INST_ID_ = '2001';

-- ACT_HI_PROCINST 更新流程实例历史
UPDATE ACT_HI_PROCINST 
SET END_TIME_ = NOW(), 
    DURATION_ = TIMESTAMPDIFF(SECOND, START_TIME_, NOW())
WHERE PROC_INST_ID_ = '2001';

-- ACT_HI_TASKINST 记录最后一个任务历史
INSERT INTO ACT_HI_TASKINST(ID_, PROC_INST_ID_, TASK_DEF_KEY_, NAME_, START_TIME_, END_TIME_)
VALUES ('2006', '2001', 'hrApprove', '人事审批', '2025-03-13 11:00:00', '2025-03-13 11:30:00');

数据流转说明：

部署阶段：
- 流程定义文件存储在 ACT_GE_BYTEARRAY
- 部署信息记录在 ACT_RE_DEPLOYMENT
- 流程定义信息记录在 ACT_RE_PROCDEF
运行时阶段：
- 流程实例数据在 ACT_RU_EXECUTION
- 当前任务数据在 ACT_RU_TASK
- 流程变量在 ACT_RU_VARIABLE
历史记录：
- 流程实例历史在 ACT_HI_PROCINST
- 任务历史在 ACT_HI_TASKINST
- 变量历史在 ACT_HI_VARINST

5.2 多引擎集成建议

流程引擎与CMMN集成：
- 使用统一的事务管理
- 共享用户数据
- 统一历史数据管理
DMN决策表使用：
- 在流程中调用决策表
- 在案例中使用决策节点

5.3 最佳实践清单

数据管理：
- 定期清理历史数据
- 实施合理的归档策略
- 监控表数据量增长
性能优化：
- 合理使用索引
- 优化查询方式
- 定期维护数据库
安全建议：
- 注意多租户数据隔离
- 加密敏感信息
- 控制数据访问权限

总结

了解Flowable的表结构设计对于以下方面很有帮助：

理解Flowable的工作原理
进行流程调试和问题排查
优化系统性能
实现复杂业务场景
多引擎协同工作

希望本文能帮助大家更好地理解Flowable的数据库设计，为后续的开发和维护工作提供参考。

Spring Boot + Flowable 工作流开发教程：整合 BPMN 和 CMMN 实战

March 12, 2025

Flowable 作为一个强大的开源工作流引擎，不仅支持传统的 BPMN 工作流，还提供了 CMMN 案例管理的能力，能够同时应对结构化和非结构化的业务场景。

本文将通过一个实际的服务台(Helpdesk)系统示例，详细介绍如何使用 Spring Boot 集成 Flowable，实现 BPMN 工作流与 CMMN 案例管理的完美结合。通过这个示例，你将学习到：

如何在 Spring Boot 项目中集成 Flowable
BPMN 和 CMMN 的最佳实践及应用场景
工作流引擎的核心 API 使用方法
服务台系统的完整实现流程

让我们开始这段整合之旅吧！

1. BPMN vs CMMN

在开始之前，让我们先了解 BPMN 和 CMMN 的区别：

1.1 BPMN（Business Process Model and Notation）

适用于结构化的业务流程
强调顺序流和控制流
流程是预定义的，步骤相对固定
典型应用：请假审批、报销流程等

1.2 CMMN（Case Management Model and Notation）

适用于非结构化的业务场景
强调灵活性和适应性
任务可以动态启动和完成
典型应用：客服工单、医疗诊断等

2. 项目环境

JDK 8+
Spring Boot 2.7.x
Flowable 6.8.0（包含 BPMN 和 CMMN 引擎）
Maven

3. 项目初始化

3.1 添加依赖

首先创建一个 Spring Boot 项目，在 pom.xml 中添加以下依赖：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.flowable</groupId>
    <artifactId>flowable-springboot-starter</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.18</version>
    </parent>

    <properties>
        <java.version>8</java.version>
        <flowable.version>6.8.0</flowable.version>
    </properties>

    <dependencies>
        <!-- Spring Boot -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- Flowable -->
        <dependency>
            <groupId>org.flowable</groupId>
            <artifactId>flowable-spring-boot-starter-rest</artifactId>
            <version>${flowable.version}</version>
        </dependency>
        <dependency>
            <groupId>org.flowable</groupId>
            <artifactId>flowable-spring-boot-starter-basic</artifactId>
            <version>${flowable.version}</version>
        </dependency>

        <!-- Database -->
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <scope>runtime</scope>
        </dependency>

        <!-- Lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

3.2 配置文件

在 src/main/resources/application.yml 中添加以下配置：

server:
  port: 8080

spring:
  datasource:
    url: jdbc:h2:mem:flowable;DB_CLOSE_DELAY=-1
    username: sa
    password:
    driver-class-name: org.h2.Driver
  h2:
    console:
      enabled: true
      path: /h2-console

flowable:
  database-schema-update: true
  async-executor-activate: false
  bpmn:
    enabled: true
  cmmn:
    enabled: true

4. 流程与案例模型

4.1 BPMN 流程模型

Helpdesk BPMN 流程模型

在 src/main/resources/processes 目录下创建 helpdesk.bpmn20.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"
             xmlns:flowable="http://flowable.org/bpmn"
             targetNamespace="http://flowable.org/examples">

    <process id="leaveProcess" name="Leave Process">
        <startEvent id="startEvent" name="Start"/>
        <sequenceFlow id="flow1" sourceRef="startEvent" targetRef="submitTask"/>

        <userTask id="submitTask" name="Submit Leave Request"
                  flowable:assignee="${applicant}"/>
        <sequenceFlow id="flow2" sourceRef="submitTask" targetRef="approveTask"/>

        <userTask id="approveTask" name="Approve Leave Request"
                  flowable:candidateGroups="managers"/>
        <sequenceFlow id="flow3" sourceRef="approveTask" targetRef="endEvent"/>

        <endEvent id="endEvent" name="End"/>
    </process>

</definitions>

4.2 CMMN 案例模型

Helpdesk CMMN 案例模型

在 src/main/resources/cases 目录下创建 helpdesk-case.cmmn.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:flowable="http://flowable.org/cmmn"
             xmlns:cmmndi="http://www.omg.org/spec/CMMN/20151109/CMMNDI"
             xmlns:dc="http://www.omg.org/spec/CMMN/20151109/DC"
             xmlns:di="http://www.omg.org/spec/CMMN/20151109/DI"
             targetNamespace="http://www.flowable.org/casedef"
             exporter="Flowable Open Source Modeler"
             exporterVersion="6.8.0">

    <case id="helpDeskCase" name="Help Desk Case" flowable:initiatorVariableName="initiator">
        <documentation>Help Desk Case for handling support requests</documentation>
        <casePlanModel id="casePlanModel" flowable:formFieldValidation="true">
            <planItem id="planItem1" name="Register Request" definitionRef="sid-D23F3A7F-E35E-491B-A801-CAE2A8DF141D"></planItem>
            <planItem id="planItem2" name="Handle Request" definitionRef="sid-43B74981-CB5A-441E-ABDD-D0509AD0A4F8">
                <entryCriterion id="sid-C006CACE-99AC-47CD-AF5D-6102F52D856A" sentryRef="sentry1"></entryCriterion>
            </planItem>

            <sentry id="sentry1">
                <planItemOnPart id="sentryOnPart1" sourceRef="planItem1">
                    <standardEvent>complete</standardEvent>
                </planItemOnPart>
            </sentry>

            <humanTask id="sid-D23F3A7F-E35E-491B-A801-CAE2A8DF141D" name="Register Request" flowable:formFieldValidation="true"></humanTask>
            <humanTask id="sid-43B74981-CB5A-441E-ABDD-D0509AD0A4F8" name="Handle Request" flowable:formFieldValidation="true"></humanTask>
        </casePlanModel>
    </case>

    <cmmndi:CMMNDI>
        <cmmndi:CMMNDiagram id="CMMNDiagram_helpdeskCase">
            <cmmndi:CMMNShape id="CMMNShape_casePlanModel" cmmnElementRef="casePlanModel">
                <dc:Bounds height="714.0" width="718.0" x="40.0" y="40.0"></dc:Bounds>
                <cmmndi:CMMNLabel></cmmndi:CMMNLabel>
            </cmmndi:CMMNShape>
            <cmmndi:CMMNShape id="CMMNShape_planItem1" cmmnElementRef="planItem1">
                <dc:Bounds height="80.0" width="100.0" x="167.0" y="189.57881699604252"></dc:Bounds>
                <cmmndi:CMMNLabel></cmmndi:CMMNLabel>
            </cmmndi:CMMNShape>
            <cmmndi:CMMNShape id="CMMNShape_planItem2" cmmnElementRef="planItem2">
                <dc:Bounds height="80.0" width="100.0" x="555.0" y="185.0"></dc:Bounds>
                <cmmndi:CMMNLabel></cmmndi:CMMNLabel>
            </cmmndi:CMMNShape>
            <cmmndi:CMMNShape id="CMMNShape_sid-C006CACE-99AC-47CD-AF5D-6102F52D856A" cmmnElementRef="sid-C006CACE-99AC-47CD-AF5D-6102F52D856A">
                <dc:Bounds height="22.0" width="14.0" x="547.6330130435323" y="218.57881699604252"></dc:Bounds>
                <cmmndi:CMMNLabel></cmmndi:CMMNLabel>
            </cmmndi:CMMNShape>
            <cmmndi:CMMNEdge id="CMMNEdge_sid-E0987438-F457-41CD-9AD9-61A0E53EC4D0" cmmnElementRef="planItem1" targetCMMNElementRef="sid-C006CACE-99AC-47CD-AF5D-6102F52D856A">
                <di:extension>
                    <flowable:docker type="source" x="50.0" y="40.0"></flowable:docker>
                    <flowable:docker type="target" x="7.0" y="11.0"></flowable:docker>
                </di:extension>
                <di:waypoint x="266.95000000000005" y="229.57881699604252"></di:waypoint>
                <di:waypoint x="547.6330130435323" y="229.57881699604252"></di:waypoint>
                <cmmndi:CMMNLabel></cmmndi:CMMNLabel>
            </cmmndi:CMMNEdge>
        </cmmndi:CMMNDiagram>
    </cmmndi:CMMNDI>
</definitions>

5. 控制器实现

5.1 BPMN 流程控制器

@RestController
@RequestMapping("/bpmn")
@RequiredArgsConstructor
public class BpmnController {
    private final RuntimeService runtimeService;
    private final TaskService taskService;
    private final HistoryService historyService;
    private final RepositoryService repositoryService;
    
    @PostMapping("/process/start")
    public Map<String, Object> startProcess(@RequestBody Map<String, Object> variables) {
        variables.put("initiator", variables.getOrDefault("userId", "unknown"));
        
        ProcessInstance processInstance = runtimeService.createProcessInstanceBuilder()
                .processDefinitionKey("helpDeskProcess")
                .variables(variables)
                .start();
                
        Map<String, Object> result = new HashMap<>();
        result.put("processInstanceId", processInstance.getId());
        result.put("processDefinitionId", processInstance.getProcessDefinitionId());
        result.put("variables", variables);
        return result;
    }
    
    // ... 其他 BPMN 相关接口
}

5.2 CMMN 案例控制器

@RestController
@RequestMapping("/cmmn")
@RequiredArgsConstructor
public class CmmnController {
    private final CmmnRuntimeService cmmnRuntimeService;
    private final CmmnTaskService cmmnTaskService;
    private final CmmnHistoryService cmmnHistoryService;
    private final CmmnRepositoryService cmmnRepositoryService;
    
    // ... 其他代码见GitHub仓库
}

6. API 测试

6.1 BPMN 流程接口测试

# 启动流程
curl -X POST "http://localhost:8080/bpmn/process/start" \
     -H "Content-Type: application/json" \
     -d '{"userId": "john"}'

# 查询任务
curl "http://localhost:8080/bpmn/tasks?assignee=john"

# 完成任务
curl -X POST "http://localhost:8080/bpmn/tasks/{taskId}/complete" \
     -H "Content-Type: application/json" \
     -d '{"approved": true}'

6.2 CMMN 案例接口测试

# 启动案例
curl -X POST "http://localhost:8080/cmmn/helpdesk/start" \
     -H "Content-Type: application/json" \
     -d '{"userId": "john"}'

# 查询任务
curl "http://localhost:8080/cmmn/tasks?assignee=john"

# 完成任务
curl -X POST "http://localhost:8080/cmmn/tasks/69e07941-d34a-11ee-9b85-0242ac110002/complete" \
     -H "Content-Type: application/json" \
     -d '{"analysis": "网络连接问题"}'

# 查询支持组任务
curl "http://localhost:8080/cmmn/tasks?candidateGroup=support"

# 认领任务
curl -X POST "http://localhost:8080/cmmn/tasks/7a1b8c52-d34a-11ee-9b85-0242ac110002/claim?userId=mary"

7. Flowable API 说明

7.1 BPMN 相关 API

RuntimeService

主要用于管理运行中的流程实例

// 启动流程实例
ProcessInstance processInstance = runtimeService.createProcessInstanceBuilder()
    .processDefinitionKey("helpDeskProcess")
    .variables(variables)
    .start();

// 触发信号事件
runtimeService.signalEventReceived("signalName");

// 设置流程变量
runtimeService.setVariable(processInstanceId, "varName", value);

// 删除流程实例
runtimeService.deleteProcessInstance(processInstanceId, "reason");

TaskService

负责管理和操作用户任务

// 查询任务
List<Task> tasks = taskService.createTaskQuery()
    .taskAssignee("john")
    .active()
    .list();

// 完成任务
taskService.complete(taskId);

// 认领任务
taskService.claim(taskId, userId);

// 设置任务变量
taskService.setVariable(taskId, "varName", value);

RepositoryService

管理流程定义和部署

// 部署流程定义
Deployment deployment = repositoryService.createDeployment()
    .addClasspathResource("processes/helpdesk.bpmn20.xml")
    .deploy();

// 查询流程定义
ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery()
    .processDefinitionKey("helpDeskProcess")
    .latestVersion()
    .singleResult();

HistoryService

访问历史数据

// 查询历史流程实例
List<HistoricProcessInstance> historicProcessInstances = historyService
    .createHistoricProcessInstanceQuery()
    .finished()
    .list();

// 查询历史任务
List<HistoricTaskInstance> historicTasks = historyService
    .createHistoricTaskInstanceQuery()
    .taskAssignee("john")
    .finished()
    .list();

7.2 CMMN 相关 API

CmmnRuntimeService

管理运行中的案例实例

// 启动案例实例
CaseInstance caseInstance = cmmnRuntimeService.createCaseInstanceBuilder()
    .caseDefinitionKey("helpDeskCase")
    .variables(variables)
    .start();

// 终止案例实例
cmmnRuntimeService.terminateCaseInstance(caseInstanceId);

// 查询案例实例
CaseInstance caseInstance = cmmnRuntimeService.createCaseInstanceQuery()
    .caseInstanceId(caseInstanceId)
    .singleResult();

CmmnTaskService

管理案例中的人工任务

// 查询任务
List<Task> tasks = cmmnTaskService.createTaskQuery()
    .taskAssignee("john")
    .list();

// 完成任务
cmmnTaskService.complete(taskId, variables);

// 认领任务
cmmnTaskService.claim(taskId, userId);

// 委派任务
cmmnTaskService.delegateTask(taskId, userId);

CmmnRepositoryService

管理案例定义和部署

// 部署案例定义
CmmnDeployment deployment = cmmnRepositoryService.createDeployment()
    .addClasspathResource("cases/helpdesk.cmmn")
    .deploy();

// 查询案例定义
CaseDefinition caseDefinition = cmmnRepositoryService.createCaseDefinitionQuery()
    .caseDefinitionKey("helpDeskCase")
    .latestVersion()
    .singleResult();

CmmnHistoryService

访问案例历史数据

// 查询历史案例实例
List<HistoricCaseInstance> historicCases = cmmnHistoryService
    .createHistoricCaseInstanceQuery()
    .finished()
    .list();

// 查询历史任务
List<HistoricTaskInstance> historicTasks = cmmnHistoryService
    .createHistoricTaskInstanceQuery()
    .taskAssignee("john")
    .finished()
    .list();

// 查询历史变量
List<HistoricVariableInstance> historicVariables = cmmnHistoryService
    .createHistoricVariableInstanceQuery()
    .caseInstanceId(caseInstanceId)
    .list();

7.3 查询 API 的通用方法

Flowable 的查询 API 提供了丰富的链式调用方法：

// 通用的查询方法
.asc()/.desc()           // 排序
.listPage(start, size)   // 分页查询
.count()                 // 计数
.singleResult()          // 获取单个结果
.list()                  // 获取列表结果

// 时间相关查询
.before(date)            // 在指定时间之前
.after(date)             // 在指定时间之后

// 排序方法
.orderByTaskCreateTime()
.orderByProcessInstanceId()
.orderByCaseInstanceId()

7.4 变量处理

Flowable 支持多种类型的变量：

// 设置变量
Map<String, Object> variables = new HashMap<>();
variables.put("stringVar", "value");
variables.put("numberVar", 123);
variables.put("dateVar", new Date());
variables.put("booleanVar", true);

// 在流程/案例中使用变量
runtimeService.setVariables(processInstanceId, variables);
cmmnRuntimeService.setVariables(caseInstanceId, variables);

// 获取变量
Map<String, Object> processVariables = runtimeService.getVariables(processInstanceId);
Map<String, Object> caseVariables = cmmnRuntimeService.getVariables(caseInstanceId);

8. BPMN 和 CMMN 的应用场景

8.1 BPMN 适用场景

标准化的审批流程
固定步骤的业务流程
需要严格控制流程顺序的场景

8.2 CMMN 适用场景

动态变化的服务请求
需要灵活处理的客户案例
基于知识工作者判断的任务

9. 最佳实践

选择合适的模型
- 对于结构化、固定流程，使用 BPMN
- 对于非结构化、动态场景，使用 CMMN
- 可以在同一系统中结合使用两种模型
流程与案例的集成
- BPMN 流程可以调用 CMMN 案例
- CMMN 案例可以触发 BPMN 流程
- 根据业务需求灵活组合
数据共享
- 流程和案例可以共享变量
- 使用统一的数据存储
- 保持数据一致性

10. 注意事项

本项目使用 H2 内存数据库，重启后数据会丢失
实际生产环境建议使用 MySQL 等持久化数据库
需要根据实际业务需求调整模型
建议添加适当的权限控制机制

11. 源码地址

完整源码请访问：GitHub - flowable-springboot-starter

12. 参考文档

BPMN、CMMN和DMN：工作流引擎三剑客的深度对比

March 12, 2025

在现代企业数字化转型的浪潮中，工作流引擎扮演着越来越重要的角色。Flowable作为领先的开源工作流引擎，支持三种核心建模标准：BPMN（业务流程模型和标记法）、CMMN（案例管理模型和标记法）以及DMN（决策模型和标记法）。今天，让我们深入了解这三种标准的异同，以及它们各自最适合的应用场景。

Flowable三大标准概览

BPMN：结构化流程的标准语言

BPMN（Business Process Model and Notation）是最广为人知的流程建模标准。它主要用于描述具有明确开始和结束点的结构化业务流程。

BPMN的核心特点：

清晰的流程控制：通过顺序流、网关等元素定义明确的执行路径
丰富的事件处理：支持开始、结束、中间事件等多种事件类型
活动任务管理：包含用户任务、服务任务、脚本任务等多种任务类型
池和泳道：清晰展示不同参与者和组织单位的职责

BPMN的核心元素：

BPMN核心元素

流对象（Flow Objects）
- 事件（Events）：开始事件、结束事件、中间事件
- 活动（Activities）：任务、子流程、调用活动
- 网关（Gateways）：排他网关、并行网关、包容网关、事件网关
连接对象（Connecting Objects）
- 顺序流（Sequence Flow）：定义活动执行顺序
- 消息流（Message Flow）：表示跨组织通信
- 关联（Association）：连接附加信息和制品
泳道（Swimlanes）
- 池（Pool）：代表参与者或系统
- 道（Lane）：组织和分类活动
制品（Artifacts）
- 数据对象（Data Objects）：表示数据信息
- 组（Group）：文档分组用途
- 注释（Annotation）：添加文本说明

BPMN的应用场景举例：

采购审批流程
- 固定的采购申请、部门审批、财务审核、总经理审批等步骤
- 基于金额的条件分支（小额直接主管审批，大额需要更高层级审批）
- 并行的询价和供应商资质审查环节
- 定时提醒和超时升级处理
新员工入职流程
- 顺序执行的入职手续办理
- 并行的工位准备和账号开通任务
- 多部门协作（HR、IT、行政等）
- 文档管理和数据收集
产品发布流程
- 产品设计、开发、测试、发布的固定步骤
- 多环节的评审和审批
- 条件判断（是否需要回退修改）
- 里程碑节点和时间控制

CMMN：灵活应对动态场景

CMMN（Case Management Model and Notation）专注于处理非结构化、动态性强的业务场景。它采用声明式而非命令式的方法来定义流程。

CMMN的主要优势：

动态任务激活：根据上下文条件动态确定任务的执行
里程碑管理：通过里程碑跟踪案例进展
人工决策：允许知识工作者根据具体情况做出决策
计划项目：支持任务、阶段等多种计划项的灵活组合

CMMN的核心元素：

CMMN核心元素

计划项（Plan Items）
- 任务（Tasks）：人工任务、流程任务、案例任务
- 阶段（Stages）：组织和封装其他计划项
- 里程碑（Milestones）：标记重要成就点
判定准则（Sentries）
- 进入准则（Entry Criteria）：激活条件
- 退出准则（Exit Criteria）：终止条件
案例文件（Case File）
- 案例文件项（Case File Items）：业务数据
- 案例文件项引用：数据访问和操作
计划片段（Plan Fragments）
- 离散（Discretionary）项：可选任务
- 规划表（Planning Tables）：动态规划选项

CMMN的应用场景举例：

医疗诊疗方案
- 根据患者症状动态调整治疗计划
- 医生可以灵活添加检查项目
- 基于检查结果激活不同的治疗方案
- 随访计划的动态调整
保险理赔处理
- 根据案件复杂度动态确定处理步骤
- 理赔员可以根据实际情况添加调查任务
- 多个可选的专家会诊环节
- 基于文件收集情况触发不同处理流程
项目管理
- 敏捷开发中的迭代规划
- 根据项目进展动态调整任务
- 团队成员自主选择和认领任务
- 基于风险评估启动相应的应对措施

DMN：业务决策的智能引擎

DMN（Decision Model and Notation）专门用于建模业务决策逻辑。它可以独立使用，也可以与BPMN和CMMN无缝集成。

DMN的关键特性：

决策表：直观展示输入条件和输出结果的映射关系
决策需求图：展示决策之间的依赖关系
表达式语言：支持复杂的业务规则表达
可重用性：决策逻辑可在不同流程中重复使用

DMN的核心元素：

DMN核心元素

决策需求图（DRD）组件
- 决策（Decision）：核心决策节点
- 输入数据（Input Data）：外部数据源
- 知识源（Knowledge Source）：决策依据
- 业务知识模型（Business Knowledge Model）：可重用决策逻辑
决策表（Decision Table）元素
- 输入（Input）：条件列
- 输出（Output）：结果列
- 规则（Rules）：条件和结果的映射行
- 命中策略（Hit Policy）：规则匹配策略
表达式语言
- FEEL表达式：标准决策表达式语言
- 简单表达式：基础运算和比较
- 复杂表达式：函数和条件逻辑
数据类型
- 基本类型：数字、字符串、布尔等
- 复合类型：列表、上下文等
- 自定义类型：业务特定数据类型

DMN的应用场景举例：

信贷审批决策
- 基于收入、信用记录等多个指标的评分
- 不同产品的利率定价规则
- 贷款额度的自动计算
- 风险等级的综合评定
保险产品定价
- 多维度的保费计算规则
- 各种优惠政策的叠加计算
- 风险因素的权重评估
- 自动化的核保决策
营销活动规则
- 客户分群策略
- 促销方案的匹配规则
- 优惠券发放条件
- 会员等级升降规则

详细对比

下表详细对比了BPMN、CMMN和DMN在不同维度上的特点：

对比维度	BPMN	CMMN	DMN
核心目标	结构化业务流程建模	非结构化案例管理	业务决策规则建模
建模方法	命令式（规定具体执行步骤）	声明式（定义目标和约束）	声明式（定义决策规则）
执行特点	固定的执行路径	动态的执行路径	基于规则的推导
灵活性	低（流程一旦定义较难变更）	高（可动态调整任务）	中（规则可动态更新）
可预测性	高（流程路径明确）	低（执行路径不确定）	高（规则结果确定）
使用场景	标准化业务流程	知识密集型工作	复杂业务决策
主要元素	事件、活动、网关	计划项、判定准则、里程碑	决策表、决策需求图
建模难度	中等	较高	较低
维护成本	较高（需要修改流程图）	中等（规则可动态调整）	较低（易于更新规则）
业务适用性	固定流程业务	动态响应业务	规则驱动业务

三者的协同应用

在实际应用中，这三种标准常常协同工作：

BPMN处理主流程框架
CMMN处理需要灵活应对的子流程或特殊场景
DMN处理流程中的决策点

选择建议

当流程具有明确的步骤和路径时，选择BPMN
当业务场景需要更多灵活性和动态响应时，使用CMMN
当需要标准化决策逻辑时，采用DMN
在复杂项目中，可以组合使用这三种标准，发挥各自优势

用对工具，事半功倍

BPMN、CMMN和DMN各自针对不同的业务场景，共同构成了完整的工作流解决方案。理解它们的差异和适用场景，对于选择合适的工具实现业务目标至关重要。在Flowable中，这三种标准的无缝集成为企业提供了强大而灵活的工作流管理能力。

工作流引擎介绍与选型指南

March 11, 2025

Flowable中文文档

在企业数字化转型的浪潮中，工作流引擎扮演着越来越重要的角色。本文将为您深入解析工作流引擎的概念、发展历程，并提供详细的选型建议。

一、什么是工作流引擎？

工作流引擎（Workflow Engine）是一种用于自动化、管理和执行业务流程的软件系统。它的核心功能是协调多个任务、角色和系统之间的交互，确保流程按照预定义的规则和逻辑运行。简单来说，它就像是一个"交通指挥中心"，将复杂的业务流程拆解为可执行的步骤，并通过规则驱动流程的流转。

核心功能架构

核心功能：

流程设计：通过图形化工具或代码定义业务流程（如审批流程、订单处理流程）
状态管理：跟踪流程的当前状态（例如"待审批""已完成"）
任务调度：根据规则自动分配任务给相关人员或系统
监控与优化：实时监控流程执行效率，提供数据分析支持
集成能力：与企业现有系统（如ERP、CRM）无缝对接
异常处理：支持流程中断、跳转、回退等操作，灵活应对业务变化

二、为什么需要工作流引擎？

在复杂的业务场景中，手动处理流程可能导致效率低下、错误频发、难以追踪等问题。工作流引擎的价值体现在以下几个方面：

提升效率：自动化处理重复性任务（如审批、通知），减少人工干预，缩短流程周期。
规范流程：通过标准化流程设计，避免人为操作差异导致的错误或合规风险。
增强灵活性：支持动态调整流程逻辑（例如紧急审批的加签规则），适应业务变化。
提高可见性：实时监控流程进度，快速定位瓶颈（例如某个环节耗时过长）。
支持复杂业务逻辑：处理分支条件、并行任务、超时处理等复杂场景（例如电商订单的退款流程）。

典型应用场景：

企业OA（如请假、报销审批）
金融行业的贷款审批
制造业的供应链管理
医疗行业的患者就诊流程

工作流程示例

三、主流工作流引擎对比

以下是市场上主流的开源和商业工作流引擎及其特点：

工作流引擎	核心特点	适用场景	优势	局限性
Activiti	轻量级、基于BPMN 2.0标准，支持Spring集成	中小企业、Java技术栈	社区活跃，扩展性强	复杂流程支持较弱
Camunda	企业级流程引擎，支持BPMN、DMN、CMMN，提供可视化监控工具	大型企业、复杂业务流程	高可用性、强大的分析工具	学习曲线较陡峭
Apache Airflow	基于Python，专注于数据处理和ETL流程	数据工程、机器学习流水线	任务依赖管理优秀，支持分布式执行	非BPMN标准，业务场景局限
jBPM	历史悠久的Java引擎，支持BPMN 2.0，与Red Hat产品深度集成	企业级BPM解决方案	与KIE生态系统无缝协作	配置复杂，资源消耗较高
Flowable	Activiti分支，优化了性能，支持BPMN、DMN、CMMN	高并发、云原生环境	轻量、响应快，适合微服务架构	社区规模较小
Zeebe	云原生设计，高吞吐量，由Camunda团队开发	大规模分布式系统、事件驱动架构	水平扩展能力强，支持SLA保障	相对较新，生态尚未成熟

技术选型建议：

企业级复杂流程：Camunda、jBPM
数据处理流水线：Airflow
微服务与云原生：Flowable、Zeebe
快速开发与低成本：Activiti

四、工作流引擎的发展历史

发展历程

早期阶段（1990年代）
- 概念起源：工作流引擎的雏形来自业务流程管理（BPM）理论，早期以文档驱动的手动流程为主。
- 代表性技术：Lotus Notes（支持简单审批流程）。
标准化与开源崛起（2000-2010）
- 2004年：jBPM诞生，成为首个基于Java的开源工作流引擎，支持BPEL标准。
- 2010年：Activiti从jBPM分支出来，专注于更轻量化的BPMN 2.0实现，迅速获得开发者青睐。
企业级解决方案时代（2010-2018）
- 2013年：Camunda从Activiti社区分离，专注于企业级功能（如流程监控、决策引擎）。
- 2015年：Apache Airflow发布，填补了数据工程领域流程管理的空白。
云原生与分布式架构（2018至今）
- 2018年：Flowable作为Activiti的优化版本发布，支持微服务架构。
- 2020年：Camunda推出Zeebe，专为高并发、事件驱动的云原生场景设计。
- 2022年：低代码平台（如Microsoft Power Automate）集成工作流引擎，降低使用门槛。

五、未来趋势

低代码/无代码化：通过可视化拖拽工具降低开发门槛（如Camunda Modeler、Appian）。
云原生与Serverless：支持Kubernetes、函数计算（如AWS Step Functions）。
AI集成：利用机器学习优化流程路径（例如自动识别流程瓶颈）。
事件驱动架构：结合消息队列（如Kafka）实现实时响应。

欢迎来到 Flowable 中文博客

March 11, 2025

Flowable中文文档

欢迎来到 Flowable 中文博客！

在这里，你将收获：

Flowable 最新动态和版本更新
最佳实践和使用技巧
社区新闻和活动
技术教程和深度文章

敬请关注博客更新！

Flowable Hacker