跳到主要内容

使用钉钉审批

本文档将介绍如何将 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（多行输入框）
      • 回滚 SQL（多行输入框）
      • 预计受影响行数（数字输入框）

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

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

使用钉钉审批​

使用钉钉 SQL 审批工单​

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

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

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

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

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

使用钉钉权限审批工单​

  1. 点击编辑要使用的表单，进入 基础设置 ，复制最下方的表单编号。 img.png
  2. 回到 CloudDM Team，进入 配置 > 系统偏好，将 authApprovalType 设置为 DingTalk，设置 authApprovalTemplateCode 为 刚才创建的表单的编号。
  3. 申请权限

付费 API 消耗次数说明​

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

FAQ​

Webhook 和 Stream 用量 调用量过高且出错率高​

出现这种情况请检查是否进行了订阅设置 img.png img.png 订阅地址：

  • 审批实例开始/结束/终止 /v1.0/event/bpms_instance_change/processCode/{processCode}/type/*
  • 审批任务开始/结束/取消 /v1.0/event/bpms_task_change/processCode/{processCode}/type/*

将 {processCode} 修改为需要监听的表单模版码
如何获取模版码： 参考钉钉审批权限工单 模版码