1. 为什么需要外置表单?
在Flowable流程引擎的实际应用中,表单是用户与流程交互的重要界面。传统的内置表单虽然简单,但存在明显的局限性:每次流程调整都需要重新设计表单,表单样式固化难以满足企业个性化需求,表单与业务代码高度耦合导致维护成本上升。
我经历过一个典型的案例:某企业HR系统需要支持15种不同类型的请假流程,每种流程的表单字段和校验规则都不相同。如果使用内置表单,开发团队需要维护15套流程定义和表单,任何字段变更都需要重新部署整个流程。而采用外置表单方案后,他们只需要维护统一的流程定义,通过动态加载不同JSON表单模板就解决了问题。
外置表单的核心优势在于:
- 前后端分离:前端可以使用Vue/React等现代框架开发,后端只负责提供表单定义和数据绑定
- 动态加载:同一流程可以根据运行时的不同条件加载不同表单
- 灵活扩展:新增字段只需修改表单模板,无需调整流程定义
- 历史追溯:表单数据版本与流程实例绑定,方便审计
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. JSON表单实战配置
2.1 基础环境搭建
首先确保你的Spring Boot项目已经集成Flowable引擎。在application.yml中添加表单配置:
yaml复制flowable:
form:
resource-suffixes: "**.form" # 表单文件后缀
resource-location: "classpath*:/forms" # 表单存放目录
创建resources/forms目录存放JSON表单模板。建议按业务模块划分子目录,例如:
code复制resources/
forms/
leave/
application.form # 请假申请表单
approval.form # 审批表单
expense/
claim.form # 报销申请表单
2.2 表单模板设计
一个完整的请假申请表单模板示例(leave_application.form):
json复制{
"key": "leave_application",
"name": "请假申请单",
"fields": [
{
"id": "applicant",
"name": "申请人",
"type": "string",
"readOnly": true,
"defaultValue": "${currentUser}"
},
{
"id": "leaveType",
"name": "请假类型",
"type": "dropdown",
"required": true,
"values": [
{"id": "annual", "name": "年假"},
{"id": "sick", "name": "病假"},
{"id": "personal", "name": "事假"}
]
},
{
"id": "duration",
"name": "请假时长(天)",
"type": "number",
"required": true,
"minValue": 0.5,
"maxValue": 15,
"step": 0.5
},
{
"id": "startDate",
"name": "开始日期",
"type": "date",
"required": true,
"datePattern": "yyyy-MM-dd"
}
]
}
关键设计要点:
- 使用
defaultValue实现自动填充当前用户等系统信息 - 复杂字段类型支持(下拉框、日期、数字等)
- 通过
readOnly控制字段编辑权限 - 内置校验规则(必填项、数值范围等)
2.3 流程与表单关联
在BPMN流程定义中通过formKey引用表单模板:
xml复制<startEvent id="start" formKey="leave_application" />
<userTask id="manager_approval" name="主管审批" formKey="leave_approval" />
部署时需要同时部署流程定义和表单资源:
java复制@Test
void deployP
