接入钉钉审批

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

创建钉钉应用

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

2. 获取开发者权限，如已有权限则略过。

3. 点击 应用开发 > 钉钉应用 > 创建应用。

4. 填写应用的基础信息，并点击 保存。

配置应用

1. 点击 权限管理，批量申请以下权限：

   • 邮箱等个人信息
   • 成员信息读权限
   • 根据手机号获取成员基本信息权限
   • 通讯录部门成员读权限
   • 审批流数据管理权限
   • 工作流实例写权限
   • 工作流模板读权限
   • 工作流实例读权限

   

2. 点击 凭证与基础信息信息，复制 AgentId, Client ID, Client Secret。

3. 回到 CloudDM Team 平台，点击 系统设置 > 系统偏好。填写参数 dingApprovalConfigAk, dingApprovalConfigSk, dingAgentId，并修改 dingEnableApprovalService 参数值为 true。

4. 回到钉钉开放平台，点击 事件订阅 > 已完成接入，验证连接通道。

   通过 订阅设置 只订阅对应模版的事件。

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

6. 填写版本基础信息，应用可见范围选择 全部员工，并点击 保存。

创建钉钉表单

1. 进入钉钉 OA 审批管理后台，点击 创建新表单。

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

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

   

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

创建钉钉审批工单

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

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

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

   

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

5. 返回钉钉，可查看相应的审批流程。

付费 API 消耗次数说明

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