Skip to main content

对接飞书审批流程

NineData 平台与飞书审批系统深度集成，支持通过飞书发起、审批、撤销数据管理类任务流程，确保审计合规性与流程自动化。

前提条件​

  • 已创建或加入组织，并且该组织已开通，同时请确保您的包年包月订阅未过期。
  • 当前账号已切换到目标组织。更多信息，请参见切换到组织。
  • 已通过企业管理员权限的账号登录飞书开放平台。
  • 已通过系统管理员权限的账号登录 NineData 平台。

注意事项​

  • 字段兼容性：标准模板中的系统保留字段无法修改。

  • 身份映射：需确保飞书账号对应的手机号或邮箱与 NineData 账号中保存的一致。

步骤一：创建并发布飞书应用​

  1. 访问飞书开放平台。

  2. 单击创建企业自建应用，输入应用名称和应用描述，选择合适的应用图标，单击创建。

    image-20250304143544747

  3. 在左侧导航栏，单击基础信息下方的凭证与基础信息，记录应用凭证区域中的 App ID 和 App Secret。

    image-20250304143737803

  4. 在左侧导航栏，单击开发配置下方的权限管理，然后单击页面中的批量导入/导出权限。在导入页签中的 JSON 框中，粘贴如下 JSON 串，然后单击下一步，确认新增权限，并单击申请开通。

    {
      "scopes": {
        "tenant": [
          "approval:approval",
          "approval:approval:readonly",
          "approval:definition",
          "contact:user.id:readonly"
        ],
        "user": [
          "approval:approval",
          "approval:definition",
          "contact:user.id:readonly"
        ]
      }
    }

  5. 页面跳转至“应用身份权限”可访问的数据范围，在通讯录 > 权限可访问的数据范围右侧，单击配置。

    image-20250304144730692

  6. 单击全部成员，单后单击保存。

    image-20250304144856898

  7. 在左侧导航栏，单击应用发布下方的版本管理与发布，然后单击页面右侧的创建版本。

    image-20250304145304925

  8. 输入应用版本号和更新说明，单击保存。在确认窗口中，单击确认发布即可。

    image-20250304163238078

步骤二：在 NineData 中绑定飞书应用​

  1. 登录 NineData 控制台。

  2. 在左侧导航栏，单击>。

  3. 单击页签，然后单击页面 右侧的。

  4. 单击下方的。

  5. 在窗口中，输入【步骤一】的第 3 步中记录的 AppID和AppSecret，选中，然后单击即可。

    tip

    选中的情况下，NineData 会自动在飞书审批管理后台创建审批流程。

  6. 绑定完成后，单击渠道中右侧的 ID。

    image-20250304175421482

  7. 在窗口中，记录。

步骤三：配置回调事件监听​

  1. 访问飞书开放平台。

  2. 单击步骤一中创建的应用，在左侧导航栏，单击开发配置下方的事件与回调。

  3. 在事件配置页签，单击订阅方式右侧的edit图标，选择将事件发送至开发者服务器。在请求地址下方的文本框中，输入步骤二的第 7 步记录的，然后单击保存。

  4. 在页面下方已添加事件区域，单击右侧的添加事件。在添加事件页面，输入关键字【审批实例】，查找到审批实例状态变更项，选中该项然后单击确认添加即可。

    image-20250304182431212

步骤四：调整默认审批流程​

对于 NineData 自动创建的默认审批流程，您可以对流程设计进行调整，添加条件分支、审批人、抄送人、办理人等信息。

  1. 访问飞书审批管理后台。

  2. 在审批管理页面，往下滚动页面至其他服务商提供区域，找到 NineData 自动创建的默认审批流程，单击其右侧的铅笔图标。

    image-20250313155147424

  3. 单击流程设计页签，按需配置审批流程的分支、审批人等信息。例如，下图创建四种不同情况下的审批流程，分别分配给不同的审批人。

    image-20250313175124689

    更多信息，请参见管理员设计审批流程。

  4. 配置完成后，单击右上角的发布即可。

步骤五（可选）：创建自定义审批流程​

如果 NineData 创建的默认审批流程无法满足业务需求，可以在飞书创建自定义审批流程，然后在 NineData 控制台进行绑定和字段映射等操作。

  1. 访问飞书审批管理后台。

  2. 在审批管理页面，单击页面右侧的创建审批，然后在模板库中单击创建自定义审批。

    image-20250325144612434

  3. 根据业务需求分别配置基础信息、表单设计、流程设计、更多设置，并记录浏览器地址栏中 URL 末尾的 definitionCode，然后单击右上角的发布。更多表单设计相关信息，请参见管理员设计审批表单。

    image-20250325145523038

    注意

    当前支持添加的控件如下：

    • 选项：单选、多选
    • 文本：单行文本、多行文本

  4. 登录 NineData 控制台，在左侧导航栏，单击>。

  5. 单击页签，然后单击页面右侧的。

  6. 单击页签，然后单击。

  7. 在页面，选择，输入名称，然后在中粘贴第 3 步中记录的 definitionCode，系统将自动拉取所有的飞书。

    image-20250325151103801

  8. 为每个映射 NineData 对应的，对于单选项，还需要配置。配置完成后，单击。

步骤六：配置审批流程​

  1. 登录 NineData 控制台。

  2. 在左侧导航栏，单击>。

  3. 单击页签，找到目标需要启用飞书审批的审批流程，单击流程名称，进入页面。

  4. 单击需配置的任务类型页签，然后单击目标流程右侧的。勾选页面下方的，在下方左侧选框中选择飞书审批，然后在右侧选择对应的飞书流程 ID，单击即可。

    image-20250305171546264

附录​

支持的字段
支持的任务类型
支持的子类型
Last updated on