审批是一种专用于人工发起且由人工处理以决定相关数据状态的流程形式。通常用于办公自动化或其他人工决策事务的流程管理,例如可以创建并管理“请假申请”、“费用报销审批”和“原料采购审批”等场景的人工流程。
审批插件提供了专用的工作流类型(触发器)“审批(事件)”和专用于该流程的“审批”节点,结合 NocoBase 特有的自定义数据表和自定义区块,可以快速且灵活地创建与管理各类审批场景。
创建工作流时选择“审批”类型,即可创建审批流程:

之后在工作流配置界面中点击触发器打开弹窗进行更多的配置。
NocoBase 的审批插件基于灵活性的设计,可以与任意自定义数据表配合使用,即审批配置无需重复配置数据模型,而是直接复用已创建的数据表。所以在进入触发器配置后,首先需要选择数据表,以决定该流程由哪个数据表的数据创建或更新时触发:

然后在对应数据表的创建(或编辑)数据的表单中将该工作流绑定到提交按钮上:

之后用户对该表单的提交即可触发对应的审批工作流,提交的数据除了保存在对应的数据表中,也会被快照至审批流中,供后续审批人员查阅使用。
如果一个审批流程允许发起人撤回,需要在发起人界面配置中,启用“撤回”按钮:

启用后该流程发起的审批在任何审批人处理之前均可被发起人撤回,但在任何后续审批节点配置的审批人处理过后,将不再可被撤回。
启用或删除撤回按钮后,在触发器配置的弹窗中,需要点击保存提交后才能生效。
最后需要配置发起人的表单界面,该界面将用于从审批中心区块发起时和用户撤回后重新发起时的提交操作。点击配置按钮打开弹窗:

可以为发起人的界面添加基于绑定的数据表的填写表单,或用以提示和引导的说明文案(Markdown)。其中表单是必须添加的,否则发起人进入到该界面后将无法操作。
添加表单区块后,和普通表单配置界面一样,可以添加对应数据表的字段组件,并且可以任意排列,以组织表单需要填写的内容:

区别于直接提交的按钮,还可以增加“保存草稿”的操作按钮,用于支持暂存的处理流程:

在审批工作流中,需要使用专用的“审批”节点为审批人配置用于处理(通过、拒绝或退回)发起的审批的操作逻辑,“审批”节点也仅可在审批流程中使用。参考审批节点 了解详情。
在配置好一个审批工作流并启用后,可以将该工作流绑定在对应的数据表的表单提交按钮上,以供用户在提交的时候发起审批:

绑定工作流后,用户在提交当前表单时,即发起审批。
发起审批的按钮目前仅支持使用新增或更新表单中的“提交”(或“保存”)按钮,不支持使用“提交至工作流”按钮(该按钮仅可绑定“操作后事件”)。
待办中心提供了一个统一的入口,方便用户查看和处理待办任务,当前用户发起的审批和待办的任务都可以通过顶部工具栏的待办中心进入,并通过左侧的分类导航查看不同类型的待办任务。





从数据区块发起,都可以这样调用(以 posts 表创建按钮举例):
其中 URL 参数 triggerWorkflows 为工作流的 key,多个工作流用逗号分隔。该 key 可在工作流画布顶部工作流名称处鼠标悬浮后获得:

调用成功后,将触发对应 posts 表的审批工作流。
因为外部调用也需要基于用户身份,所以通过 HTTP API 调用时,和普通界面发送的请求一致,都需要提供认证信息,包括 Authorization 请求头或 token 参数(登录获得的 token),以及 X-Role 请求头(用户当前角色名)。
如果需要触发该操作中对一关系数据(对多暂不支持)的事件,可以在参数中使用 ! 来指定关系字段的触发数据:
以上调用成功后,将触发对应 categories 表的审批事件。
通过 HTTP API 调用触发操作后事件时,也需要注意工作流的启用状态,以及数据表配置是否匹配,否则可能不会调用成功,或出现错误。
参数
collectionName:发起审批的目标数据表名称,必填。workflowId:发起审批使用的工作流 ID,必填。data:发起审批时创建的数据表记录字段,必填。status:发起审批时创建的记录状态,必填。可选值包括:
0:草稿,表示保存但不提交审批。1:提交审批,表示发起人提交审批申请,进入审批。当发起(或撤回)的审批处于草稿状态时,可以通过以下接口再次保存或提交:
发起人可以通过以下接口撤回当前处于审批中的记录:
参数
<approval id>:待撤回的审批记录 ID,必填。审批流程进入审批节点后,会为当前审批人创建待办任务。审批人可以通过界面操作完成审批任务,也可以通过 HTTP API 调用完成。
待办任务即审批处理记录,可以通过以下接口获取当前用户的所有审批处理记录:
其中 approvalRecords 作为数据表资源,也可以使用通用的查询条件,如 filter、sort、pageSize 和 page 等。
参数
<record id>:待审批处理的记录 ID,必填。status:字段为审批处理的状态,2 表示“通过”,-1 表示“拒绝”,必填。comment:审批处理的备注信息,可选。data:表示审批通过后对当前审批节点所在数据表记录进行的修改,可选(仅通过时有效)。在 v1.9.0 版本之前,退回与“通过”、“拒绝”使用相同的接口,使用 "status": 1 代表退回。
v1.9.0 版本开始,退回有了单独的接口:
参数
<record id>:待审批处理的记录 ID,必填。returnToNodeKey:退回的目标节点 key,可选。当节点中配置了可退回的节点范围时,可以使用该参数指定退回到哪个节点。未配置的情况下,该参数无需传值,默认将退回到起点,由发起人重新提交。参数
<record id>:待审批处理的记录 ID,必填。assignee:转签的用户 ID,必填。参数
<record id>:待审批处理的记录 ID,必填。assignees:加签的用户 ID 列表,必填。order:加签的顺序,-1 标识在“我”之前,1 标识在“我”之后。