流程表单接入
流程表单是 RuoYi Office 内置的在线审批表单能力。它通过表单设计器维护字段和校验规则，通过流程模型绑定审批节点，适合轻量审批、临时流程和快速验证场景。
如果业务需要独立台账、复杂统计、主子表或移动端专属页面，建议使用 业务表单接入。
适用场景
- 申请字段较少，主要用于审批流转。
- 不需要复杂业务表、明细表、附件生命周期或统计报表。
- 希望先快速验证流程，再决定是否沉淀为业务模块。
- 审批数据可以作为流程变量保存和查看。
操作流程
1. 新建流程表单
进入「流程中心 → 流程表单」，新建表单并配置字段。常见字段包括文本、数字、日期、下拉、单选、多选、上传、富文本等。
流程表单配置会保存到 BPM 表单配置中，运行时由前端渲染，并将提交值作为流程变量传给后端。
2. 新建流程模型
进入「流程中心 → 流程模型」，点击“新建模型”：
常用字段说明：
| 字段 | 说明 |
|---|---|
| 流程标识 | 全局唯一，例如 leave、expense |
| 流程名称 | 用户看到的名称 |
| 流程分类 | 便于流程中心分组管理 |
| 流程图标 | 发起流程列表中的展示图标 |
| 表单类型 | 选择“流程表单” |
3. 绑定流程表单
在模型的“表单设计”步骤中选择“流程表单”，再选择已经创建好的流程表单。发布后，用户发起流程时会看到该在线表单。
4. 设计审批节点
在 BPMN 或简易流程设计器中配置审批节点：
- 审批人规则：角色、部门负责人、岗位、用户组、发起人自选等。
- 多人审批：会签、或签、依次审批。
- 节点按钮：通过、拒绝、驳回、转办、委派、加签等。
- 字段权限：按节点控制字段只读、可编辑或隐藏。
5. 发布并发起流程
发布模型后，用户可以在「流程中心 → 发起流程」选择该流程，填写表单并提交。
审批人进入「待办任务」完成处理。
节点字段权限
流程表单不需要额外绑定业务数据模型。只要流程模型选择了流程表单，进入流程设计步骤后，就可以在发起人、审批人、抄送人等节点里配置字段权限。
常用配置：
| 节点 | 字段权限建议 |
|---|---|
| 发起人 | 申请字段可编辑，审批回填字段隐藏 |
| 部门负责人 | 申请字段只读，负责人意见可编辑或必填 |
| 财务审批 | 金额、付款信息等按职责开放编辑 |
| 抄送人 | 默认只读，敏感字段可隐藏 |
数据与实现
| 内容 | 说明 |
|---|---|
| 表单定义 | 存储在 BPM 表单配置中 |
| 表单值 | 作为 Flowable 流程变量保存 |
| 前端渲染 | ruoyi-office-vben/apps/web-antd/src/views/bpm 下的流程表单运行能力 |
| 后端处理 | yudao-module-bpm 负责模型、实例、任务和变量管理 |
流程表单的数据更贴近“审批过程数据”，不是业务主数据。后续需要跨模块统计或业务闭环时，应迁移为业务表单。
验收清单
- 流程表单已保存并启用。
- 流程模型已绑定该表单并发布。
- 发起流程页能看到该流程。
- 表单字段必填、默认值、选项正常。
- 审批人能在待办中看到表单值。
- 节点字段权限符合预期。
- 流程结束后，发起人能在“我的流程”查看记录。
常见问题
表单字段显示异常
检查表单设计器配置是否保存成功，字段 key 是否重复，字段组件是否被当前前端版本支持。
流程发布后发起列表没有显示
确认模型已发布、流程分类启用、当前用户有发起权限，并刷新前端缓存。
后续如何转业务表单
保留流程标识和审批模型思路，新增独立业务表、后端 Service、PC 表单页和移动端表单页，再把模型表单类型切换为业务表单并配置提交/查看路由。
流程表单和业务表单怎么选
建议先阅读 流程表单和业务表单差异。简单审批优先流程表单，正式业务闭环优先业务表单。
