跳到主要内容

使用飞书审批

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

创建飞书应用​

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

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

配置飞书应用​

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

    • 访问审批应用
    • 查看、创建、更新、删除原生审批实例相关信息
    • 获取通讯录基本信息
    • 获取用户基本信息
    • 获取用户 user ID
    • 通过手机号或邮箱获取用户 ID

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

创建审批模版​

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

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

  3. 创建表单

    • 创建 SQL 审批表单，在 表单设计 的步骤，添加如下控件且均不要开启必填选项：
      • 标题（单行文本）
      • 目标数据源（单行文本）
      • 需求描述（多行文本）
      • 执行 SQL（多行文本）
      • 回滚 SQL（多行文本）
      • 预计受影响行数（数字文本）

    • 创建权限审批表单，在 表单设计 的步骤，添加如下控件且均不要开启必填选项：
      • 标题（单行文本）
      • 目标数据源（单行文本）
      • 申请的权限（明细/表格）
        • 数据源描述（单行文本）
        • 资源路径（单行文本）
        • 生效时间（单行文本）
        • 权限列表（多行文本）

    img_1.png

  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. 填写版本基础信息，应用可用范围选择 所有员工，并点击 保存。

使用飞书审批工单​

使用飞书 SQL 审批工单​

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

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

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

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

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

使用飞书权限审批工单​

  1. 点击编辑要使用飞书审批表单。
  2. 复制表单编号 img_2.png
  3. 回到 CloudDM Team，进入 配置 > 系统偏好，将 authApprovalType 设置为 Feishu，设置 authApprovalTemplateCode 为 刚才创建的表单的编号。
  4. 申请权限

付费 API 消耗次数说明​

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