本教程将实现审批人提交审批表单时，通过相关的校验连接器，对审批人提交的商品出库数量进行校验，根据数据校验结果向用户展示相应的结果。

前提条件

在开始本教程前，确保你已经完成了以下准备工作：

• 已经完成了钉钉开发者的注册与激活并拥有了子管理员和开发者权限。若尚未完成，请参考成为钉钉开发者。

• 已经了解并熟悉什么是连接平台和基本概念。

• 已经成为钉钉专业版用户（OA审批中使用连接器必备）。若未完成，请参考钉钉专业版。

文档同学注意：步骤一的编辑格式参考该链接中的步骤一

步骤一：创建执行动作

说明

OA审批人提交时校验数据基于连接器的基础上实现：

• 如果无连接器，详情参见创建连接器。

• 如果已有连接器，可直接使用已有连接器。

提交时校验数据

1. 创建执行动作

2. 配置基础信息

• 名称：文件信息上传到OSS。

• API类型：FAAS。

• 选择脚本语言：

• 语言类型：Python。

• 设置脚本代码：

stock = 10
amount = input["amount"]
if amount > stock:
    output.update({"result": False})
    output.update({"errorMsg": "库存不足"})
else:
    output.update({"result": True})
    output.update({"errorMsg": "出库成功"})

3. 配置入参

• 脚本入参：

配置方法参见编码模式使用

{
  "properties": {
    "amount": {
      "properties": {},
      "required": [],
      "title": "数量",
      "type": "number",
      "version": 0,
      "x-dd-position": "BODY"
    },
    "name": {
      "properties": {},
      "required": [],
      "title": "商品名称",
      "type": "string",
      "version": 0,
      "x-dd-position": "BODY"
    }
  },
  "required": [
    "name",
    "amount"
  ],
  "title": "入参",
  "type": "object",
  "version": 0
}

4. 配置出参

脚本出参：

{
  "properties": {
    "result": {
      "description": "校验结果",
      "properties": {},
      "required": [],
      "title": "result",
      "type": "boolean",
      "version": 0
    },
    "errorMsg": {
      "description": "校验提示信息",
      "properties": {},
      "required": [],
      "title": "errorMsg",
      "type": "string",
      "version": 0
    }
  },
  "required": [
    "result",
    "errorMsg"
  ],
  "type": "object",
  "version": 0,
  "title": "出参"
}

5. 调试

输入执行动作入参：

{
  "amount": 4,
  "name": "吹风机"
}

点击立即调试，可根据调试结果判断执行动作参数配置是否正确。

6. 保存草稿并发布

步骤二：新建审批单

在表单设计界面，设计并添加OA审批表单控件

• 商品名称：单行输入框，用于输入商品名称

• 出库数量：数字输入框，用于输入商品出库数量

步骤三：流程设计

1. 点击“流程设计”，进入流程设计页面，并点击选择审批人

2. 在弹出的选窗中设置审批类型为“人工审批”，并设定审批人。这里设定审批人为指定成员，并在下方添加指定成员。

3. 点击“高级设置”并点击“新增连接器校验条件”，以添加连接器校验审批数据功能。

4. 在弹窗中选择用于数据校验的连接器和对应的执行动作（该执行动作会对审批人提交的数据进行校验），并点击下一步配置执行动作

5. 填写控件值以获取待校验数据。在审批执行动作中，有校验结果和校验错误信息两个参数，将连接器执行动作出参的result字段填充到校验结果，将errorMsg字段填充到校验错误信息。

6. 点击保存并发布审批流程

步骤四：功能体验

1. 进入钉钉工作台，然后进入OA审批，找到步骤三配置的审批表单，填写表单中相应字段信息（出库数量设为14），并点击提交。

2. 指定的审批人收到表单，点击该审批单进入审批详情页。

点击详情页中的同意并填写意见。由于商品库存为10，出库数量大于库存，因此审批人会收到连接器对出库数量的校验结果为未通过，错误信息为库存不足。

同样的，在表单中设置出库数量为5时，审批人点击同意，即可收到审批完成信息，表单审批通过。