接入飞书审批

本文档将介绍如何将 CloudDM Team 的工单接入飞书审批流。

创建飞书应用

1. 登录 飞书开发者后台，选择相应的组织，进入后台页面。

2. 点击 创建企业自建应用，填写应用基础信息，并点击 创建。

配置飞书应用

1. 点击 权限管理，批量开通：

   • 审批所有权限
   • 通讯录所有权限

   

2. 点击 凭证与基础信息，复制 App ID、App Secret，为 CloudDM Team 配置作准备。

创建审批模版

1. 进入 飞书审批管理后台，点击 审批管理 > 创建审批。

2. 点击 创建自定义审批。

3. 在 表单设计 的步骤，添加如下控件且均不要开启必填选项：

   • 标题（单行文本）
   • 目标数据源（单行文本）
   • 需求描述（多行文本）
   • 执行 SQL（多行文本）
   • 回滚 SQL（多行文本）
   • 预计受影响行数（数字文本）

   

4. 在 流程设计 的步骤，设置各节点的审批人及审批方式。只支持指定审批人或系统自动选择，不支持发起人自选。

5. 配置完成后，右上角点击 发布。

6. 创建完成后，回到审批管理页面，点击修改图标。

7. 在页面上方的地址栏中，复制 definitionCode。

8. 进入 开发文档，点击 尝试一下。

9. 填入刚才复制的 definitionCode，点击 开始调试。

10. 出现以下结果则说明订阅事件成功。

配置 CloudDM Team

1. 回到 CloudDM Team 平台，点击 系统设置 > 系统偏好。

2. 将 App ID 复制到 feishuApprovalAppID、App Secret 复制到 feishuApprovalAppSecret、definitionCode 复制到 feishuApprovalTemplateList（如有多个审批模版码，使用,分隔），并修改 feishuEnableApprovalService 参数值为 true。

3. 回到飞书开放平台，在左侧导航栏点击 事件与回调。

   1. 订阅方式选择 使用长连接接收事件，点击 保存。
   2. 点击 添加事件。添加 审批实例状态变更 和 审批任务状态变更 事件。

4. 点击 版本管理与发布 > 创建版本。

5. 填写版本基础信息，应用可用范围选择 所有员工，并点击 保存。

创建飞书审批工单

1. 在 CloudDM Team 平台上方导航栏，点击 查询设置。

2. 在 环境 页签下，为对应的环境开启工单功能。

3. 在弹出的对话框中选择引擎为 飞书流程，模板为刚才在飞书创建的模版。

4. 在上方导航栏点击 工单，并 提交工单。

5. 等待大约 10 秒便可在飞书上看见对应的审批工单（发起的工单详情页面中也可以看到状态变化）。

危险

如果关闭或修改飞书工单配置 需要重启 CloudDM Team Console 服务。

付费 API 消耗次数说明

• 1 次完整审批消耗次数= 4 次固定开销 + 审批次数 +（审批耗时/设置定时获取最新状态时间间隔）+ 工单详情页面点击刷新次数
• 4 次固定开销 = 获取审批节点 + 创建审批流 + 审批开始时获取状态信息 + 审批结束获取最新状态