跳到主要内容
版本：7.0.0

表单录入-审批设置

1. 概述​

观远BI的表单录入功能支持一级审批，可用于严控手工数据录入行为。在数据录入环节，若用户希望先让数据经过其他人员进行确认审核，再将数据进行落库甚至用于生产，可通过表单录入的“审批”功能来实现。本功能提供基于外部审批系统集成以及简单审批方案，能够增强表单录入在审批需求场景下的应对能力，降低类似场景需求在前/中/后台的沟通成本。

1.png

2. 使用指导​

2.1. 配置观远一级审批​

在表单设计中，切换到审批设置，勾选“开启审批记录”，保存当前表单。开启审批后，用户对于当前表单中的数据进行新增、修改、删除（含批量操作），都会触发审批流程，要求表单所有者审批通过后，数据才会入库。

2.png

当用户提交数据时，提交者会收到消息，可点击前往审批中心，查看当前提交的数据审批进度。

3.png

当前表单所有者会收到审批消息，提示当前有一条数据待审批，可前往审批中心进行处理。

4.png

2.2. 配置三方审批​

三方审批交互流程如下：

image.png

在表单设计中，切换到审批设置，勾选“开启审批记录”，并切换为“三方审批”模式。

image.png根据客户配置的Webhook地址，观远BI进行审批id的推送。

注意：客户需要自行定义开发接口，接收webhook推送信息，进行审批工单的创建。如果客户的审批系统为钉钉/企微/飞书等其他审批系统，则需要定开中转接口进行格式转换，在中间层按照审批系统要求进行格式转换，推送至三方创建审批工单。

  • 三方提交审批接口

请求方式：POST

请求地址：客户自定义（例如：http://192.168.1.102/submitApproval）

请求与响应示例：

{
  "approvalId": "o23b47f64df4e46f98acda3e" // 审批ID
}
{
  "thridApprovalId": "id" //审批提交成功，返回一个唯一ID，方便后续问题跟踪
}
  • 审批内容详情接口

请求方式：GET

请求地址：/api/approval/detail

请求与响应示例：

{
  "approvalId": ""  //审批ID
}
{
    "code": 0,
    "msg": "success",
    "data": {
        "approvalId": 0, //审批Id
        "approvalStatus": 0, //审批状态
        "commitApprovalUserId":  "aaaaa", //提交用户
        "changeType": "UPDATE", // 变更类型
        "cTime":  "2023-01-01 22:22:22", // 创建时间
        "resourceId": "ddd", // 资源ID
        "resourceName": "资源名称",  //资源名称
        "resourceType": "GUAN_FORM", //资源类型
        "content": ""  //审批内容
    }
}

待客户侧审批完成后，回传观远BI审批结果，由BI完成数据实际落库。

  • 审批结果回调接口

请求方式：POST

请求地址：/public-api/approval

{
  "approvalId": "aaaa", //审批Id
  "approvalStatus: "1",
  "approvalUser": "审批人"
}
{
    "code": 0,
    "msg": "success",
    "data": true
}

注意：三方审批不会在BI展示审批消息，要求用户在三方系统中查看审批进度。

2.3. 查看待审批信息​

表单填报者在填写数据后，可以在 九宫格 > 审批中心 中，查看已提交审批数据的审批状态。

6.png

在 我提交的 > 待审批 列表中，可以查看当前用户所有的审批内容及当前处理人，点击“详情”可查看当前提交的数据。

7.png

注意：子表格、矩阵表格中的数据提交后无法在审批中心查看。

8.png

2.4. 查看审批结果​

表单所有者在表单填报者提交数据后，可在九宫格>审批中心>我处理的>待处理查看未审批的所有条目。审批人可以进行以下操作：

  • 通过：点击后，本条数据写入/修改/删除立即生效。

  • 驳回：点击后，用户需要填写驳回理由，提交之后本条数据不会进入表单数据。提交者可在我提交的>已处理中查看驳回理由。

  • 详情/下载：点击后，用户查看/下载当前需要审批的数据。注意，下载功能仅支持批量导入的数据。

9.png

10.png

当审批者处理完审批后，提交者会收到一条消息通知，告知其审批结果。

11.png