流程表单接入

流程表单是由 RuoYi Office 表单设计器维护的在线审批表单。它不需要为每个表单单独开发页面，适合轻量审批、临时流程、试运行流程和字段较少的内部申请。

适用场景

• 申请字段较少，主要用于审批流转。
• 不需要复杂业务表、明细表、附件生命周期或统计报表。
• 希望先快速验证流程，再决定是否沉淀为业务模块。
• 审批数据可以作为流程变量保存和查看。

如果业务需要客户、合同、员工、资产等主数据关联，建议直接使用 业务表单接入。

操作流程

1. 新建表单

进入 基础能力 → 表单开发 → 表单设计器，新建表单并配置字段。常见字段包括文本、数字、日期、下拉、单选、多选、上传、富文本等。

表单设计器配置会保存到 BPM 表单配置中，运行时由前端渲染，并将提交值作为流程变量传给后端。

2. 新建流程模型

进入“流程中心 / 流程模型”，新建模型：

字段	说明
流程标识	全局唯一，例如 leave、expense
流程名称	用户看到的名称
流程分类	便于流程中心分组管理
流程图标	发起流程列表中的展示图标
表单类型	选择“流程表单”

3. 绑定表单

在模型的表单配置步骤中，选择已创建的流程表单。发布后，用户发起流程时会看到该在线表单。

4. 设计审批节点

在 BPMN 或简易流程设计器中配置审批节点：

• 审批人规则：角色、部门负责人、岗位、用户组、发起人自选等。
• 多人审批：会签、或签、依次审批。
• 节点按钮：通过、拒绝、驳回、转办、委派、加签等。
• 字段权限：按节点控制字段只读、可编辑或隐藏。

5. 发布并发起流程

发布模型后，用户可以在“发起流程”选择该流程，填写表单并提交。审批人进入“待办任务”完成处理。

节点字段权限

流程表单不需要额外绑定业务数据模型。只要流程模型选择了流程表单，进入流程设计步骤后，就可以在发起人、审批人、抄送人等节点里配置字段权限。

常用配置：

节点	字段权限建议
发起人	申请字段可编辑，审批回填字段隐藏
部门负责人	申请字段只读，负责人意见可编辑或必填
财务审批	金额、付款信息等按职责开放编辑
抄送人	默认只读，敏感字段可隐藏

完整说明见 表单字段权限控制。

数据与实现

内容	说明
表单定义	存储表单设计配置和字段信息
表单值	作为 Flowable 流程变量保存
前端渲染	web-antd/src/views/bpm 下的流程表单运行能力
后端处理	yudao-module-bpm 负责模型、实例、任务和变量管理

流程表单的数据更贴近“审批过程数据”，不是业务主数据。后续需要跨模块统计或业务闭环时，应迁移为业务表单。

验收清单

• 流程模型已发布。
• 发起流程页能看到该流程。
• 表单字段必填、默认值、选项正常。
• 审批人能在待办中看到表单值。
• 节点字段权限符合预期。
• 流程结束后，发起人能在“我的流程”查看记录。

常见问题

表单字段显示异常

检查表单设计器配置是否保存成功，字段 key 是否重复，字段组件是否被当前前端版本支持。

流程发布后发起列表没有显示

确认模型已发布、流程分类启用、当前用户有发起权限，并刷新前端缓存。

后续如何转业务表单

保留流程标识和审批模型思路，新增独立业务表、后端 Service、PC 表单页和移动端表单页，再把模型表单类型切换为业务表单并配置提交/查看路由。

动态属性和字段权限怎么选？

节点级显隐、只读、必填优先使用字段权限。需要读取流程状态、任务信息或做多字段联动时，再使用 流程表单上下文变量 配合动态属性或事件脚本。