审批状态

1. 插件简介

@youchaoyun/plugin-approval-status 是一个审批状态预置字段插件。
启用后，系统会提供一个可直接添加到数据表中的“审批状态”字段，用于记录每条业务数据当前所处的审批阶段。

这个插件适合以下场景：

• 请假、报销、采购、合同、用印等审批类业务
• 需要在列表中快速查看单据审批状态
• 需要按审批状态筛选数据
• 需要通过工作流或人工操作更新状态

2. 使用前提

使用本插件前，请先确认：

• 必须先启用数据字典插件，才能启用和使用本插件
• 当前账号具备数据表配置权限

重要说明：本插件依赖数据字典插件提供审批状态字典。
如果没有先开启数据字典插件，本插件将无法正常使用。

3. 启用后会得到什么

启用插件后，系统会自动提供两项能力：

• 内置审批状态字典：ApprovalStatus
• 预置字段：Approval status

其中，预置字段默认值为“草稿”。

也就是说，你在配置数据表时，可以直接把“审批状态”作为一个标准字段加入业务表，无需手工再定义一套状态枚举。

4. 如何给数据表添加审批状态字段

4.1 新建数据表时添加

操作步骤：

1. 进入“创建数据表”页面
2. 在 Preset fields / 预置字段 区域中找到 Approval status
3. 勾选该预置字段
4. 完成数据表创建

创建完成后，数据表会自动带上审批状态字段，默认值为“草稿”。

4.2 已有数据表补加该字段

如果数据表已经创建好，但当时没有勾选这个预置字段，也可以后续补加：

1. 进入已有数据表的字段配置页面
2. 新增字段
3. 在字段类型列表中选择 Approval status
4. 保存字段配置

5. 如何在页面中使用该字段

审批状态字段添加到数据表后，可以像普通业务字段一样用于页面展示。

常见用法包括：

• 在表单中显示审批状态
• 在详情页中查看当前状态
• 在列表页中显示每条记录的审批状态
• 在页面中允许人工修改状态

这样用户可以快速识别每条数据当前处于“草稿、已提交、处理中、已通过”等哪个阶段。

6. 如何按审批状态筛选数据

审批状态字段支持作为筛选条件使用。

常见筛选方式包括：

• is
• is not
• is any of
• is none of

7. 系统内置审批状态

插件默认提供以下审批状态：

其中，默认初始值为：

• 0 / 草稿

8. 使用建议

• 建议将审批状态字段加入所有审批类业务表
• 建议把审批状态展示在列表页，方便业务人员快速判断进度
• 如果项目中已经使用工作流，建议由工作流自动更新审批状态，减少人工修改

9. 常见问题

9.1 为什么看不到 Approval status 字段？

请优先检查：

• 插件是否已经启用
• 数据字典插件是否已经先启用
• 确认数据源中是否有 Approval status 字段

9.2 为什么新记录默认是“草稿”？

因为该插件预置字段的默认值就是“草稿”，用于表示审批流程尚未开始或尚未提交。

9.3 这个插件会自动创建审批流程吗？

不会。
这个插件提供的是“审批状态字段能力”，用于记录状态本身。
具体的审批流程流转，可以结合你们现有的工作流配置来实现。

9.4 审批状态可以人工修改吗？

可以，前提是你在页面中给该字段提供了可编辑权限。
如果希望状态严格按照流程变化，建议通过工作流自动更新，而不是由用户手工修改。