审批改人

@youchaoyun/plugin-workflow-approval-editable（审批改人）为已启用的审批事件工作流提供专用配置入口。管理员可以在不调整工作流节点结构的情况下，维护审批节点的审批人和部分审批参数。

本文只介绍插件当前开放的“设置中心 → 审批改人”入口。页面设计器中的审批改人区块暂不在本文范围内。

使用效果

审批流程发布后，审批人可能因为岗位变动、组织调整或临时代理而需要更换。使用审批改人后，管理员可以直接打开当前启用的审批工作流，定位到对应审批节点并完成调整。

使用前的情况	使用审批改人后的效果
需要修改审批人时，容易误触工作流的触发器、分支或其他节点配置	以只读画布展示完整流程，只开放审批节点编辑
维护人员需要在工作流设计器中查找目标流程	在设置中心集中列出已启用的审批事件工作流，可按分类和名称快速定位
修改多个审批节点时容易遗漏保存	节点抽屉先暂存，页面统一点击“保存修改”后提交全部变更
审批配置被误改后难以及时发现	服务端只接受审批人、协商模式、多人处理顺序和任务名称，并复用原审批节点校验规则

功能特性

仅展示可维护的审批工作流

• 列表只读取已启用且类型为“审批”的工作流。
• 支持“全部”和工作流分类标签页。
• 每条工作流只提供“修改”操作。

按原流程展示节点

打开工作流后，页面会读取当前启用版本的节点、连线和分支，并以画布方式展示。

• 审批节点（包括分支中的审批节点）可以点击并打开编辑抽屉。
• 其他节点以灰度样式显示，只读且不能打开原节点配置或修改名称。
• 不提供节点新增、删除、拖动和连线调整操作。
• 画布提供缩放滑块，便于查看较长或包含分支的流程。

审批节点可调整字段

点击审批节点后，右侧抽屉仅显示以下字段：

字段	说明
任务名称	修改该审批任务在节点上的显示名称。
审批人	沿用审批插件的选择用户、查询用户、添加、删除和拖动排序能力。
协商模式	沿用原审批节点的协商模式配置。可选项和校验规则以当前审批插件界面为准。
多人处理顺序	调整多人审批时的处理顺序配置。可选项和具体行为以当前审批插件界面为准。

审批节点中的触发条件、分支条件、审批动作、表单配置等其他内容不会通过本插件修改。

暂存后统一保存

1. 在节点抽屉中点击“提交”时，只会暂存当前节点的修改，不会立即写入工作流。
2. 可继续打开其他审批节点并暂存修改。
3. 点击页面右上角“保存修改”后，插件才会提交所有已暂存的节点。
4. 保存成功的节点会立即更新画布；保存失败的节点会保留待提交状态，便于修正后再次保存。

服务端校验与更新保护

• 只允许更新审批节点，不能通过该接口更新其他类型的工作流节点。
• 只允许更新当前启用的审批工作流，已停用或非当前版本的工作流不会被修改。
• 服务端会校验客户端提交的完整审批节点配置，校验失败时不会保存。
• 服务端会检查未开放字段是否被改写，避免覆盖审批节点的其他配置。
• 节点更新和工作流更新时间维护在同一个事务中完成。

如何使用

使用前提

开始使用前，请确认：

• 当前 NocoBase 版本为插件支持的 2.x 版本。
• 已安装并启用“工作流”插件。
• 已安装并启用“工作流：审批”插件。
• 至少存在一个类型为“审批”且已启用的审批事件工作流。
• 目标工作流中至少包含一个审批节点。
• 当前账号已登录，并具备进入插件设置的权限。

如果没有符合条件的工作流，列表会显示“没有已启用的审批事件工作流”。

第一步：安装并启用插件

在 NocoBase 的插件管理中安装并启用“审批改人”。启用后，插件会在插件设置中注册“审批改人”入口。

第二步：准备审批事件工作流

如果系统中还没有可维护的工作流，请先在工作流插件中创建审批事件工作流：

1. 新建一个类型为“审批”的工作流。
2. 按业务需要配置触发器、分支和审批节点。
3. 至少配置一个审批人，并完成审批节点的其他必填项。
4. 保存并启用工作流。

插件只读取已启用的审批事件工作流；草稿、停用或非审批类型的工作流不会出现在列表中。

第三步：打开审批改人设置

1. 进入系统设置。
2. 在插件设置列表中点击“审批改人”。
3. 在工作流列表中确认目标审批流程的名称和分类。

第四步：查找目标工作流

工作流列表提供两种定位方式：

• 点击“全部”查看所有已启用的审批事件工作流。
• 点击分类标签页，仅查看该分类下的工作流。
• 使用筛选按钮，选择“名称 → 包含”，输入关键字后提交筛选。

找到目标工作流后，点击所在行的“修改”。

第五步：修改审批节点

1. 在工作流画布中找到要调整的审批节点。
2. 点击审批节点卡片，打开右侧编辑抽屉。
3. 根据业务安排维护任务名称、审批人、协商模式和多人处理顺序。
4. 点击抽屉底部的“提交”，暂存当前节点。
5. 如需修改其他审批节点，重复以上步骤。

非审批节点为只读状态，无法通过本页面修改。需要调整流程结构、触发器、分支或其他节点时，请返回工作流设计器处理。

第六步：保存全部修改

1. 确认所有需要修改的节点都已点击“提交”暂存。
2. 点击页面右上角的“保存修改”。
3. 等待页面提示“审批节点修改已提交”。
4. 检查画布中的节点信息是否已更新。

如果部分节点保存失败，失败节点会继续保留待提交状态。根据抽屉中的错误提示修正配置后，再次点击“保存修改”；已经保存成功的节点不会重复提交。

限制与异常处理

情况	处理方式
列表为空	确认“工作流：审批”已启用，并确认至少有一个已启用的审批事件工作流。
找不到目标工作流	检查工作流类型、启用状态和当前版本状态；停用或历史版本不会显示。
当前工作流没有可编辑节点	该流程不包含审批节点，或节点数据尚未正确配置。请在工作流设计器中检查。
点击非审批节点没有反应	这是只读保护，非审批节点不能通过审批改人修改。
提交时提示配置校验失败	按错误提示补全审批人或其他必填配置，并重新提交。
保存后提示部分失败	检查失败节点的配置和网络状态，修正后再次点击“保存修改”。
工作流在编辑期间被停用或切换版本	服务端会拒绝更新，请返回列表后重新打开当前可用的工作流。

最佳实践

• 将结构调整和人员维护分开：触发器、分支、节点增删和连线调整在工作流设计器完成；审批改人只用于维护审批节点的四项开放配置。
• 先按分类整理工作流：为不同业务线建立清晰的工作流分类，管理员可以在分类标签页中更快定位流程。
• 审批人变更前先确认业务规则：多人审批时，同时核对审批人名单、协商模式和处理顺序，避免只替换人员而遗漏处理规则。
• 集中修改后一次保存：可以连续暂存多个审批节点，确认无误后统一点击“保存修改”，减少重复提交。
• 优先在测试流程验证：涉及关键业务审批时，建议先复制或准备测试工作流，使用测试账号验证审批任务展示和流转结果，再维护正式流程。

📝 更新日志

v2.1.15（2026-08-24）

• 提供“审批改人”设置入口，集中查看和维护已启用的审批事件工作流。
• 支持按工作流分类和名称筛选，快速定位需要维护的审批流程。
• 支持调整审批节点的任务名称、审批人、协商模式和多人处理顺序，并统一保存修改。