如何接入钉钉OA审批？

接入钉钉OA审批的步骤如下，具体操作分为前提条件、配置流程和常见问题解决三部分：

一、前提条件

在接入钉钉OA审批之前，需确保以下条件已满足： 1. 已开通Quick BI的钉钉微应用，并将其关联到Quick BI组织。 2. 您需要具备钉钉企业管理员权限，且团队中至少包含一名企业员工。 3. 确保钉钉账号已绑定Quick BI网页版。

二、配置流程

1. 开通钉钉微应用服务

• 扫描二维码：使用钉钉移动端扫描指定二维码，完成应用安装。
• 选择团队：在“选择所属团队”页面完成应用安装，确保您为该团队的管理员。
• 绑定CorpId：登录钉钉开发平台，获取CorpId参数，并在Quick BI控制台中填入CorpId完成接口授权绑定。

2. 配置钉钉OA审批

1. 登录Quick BI控制台

   • 进入Quick BI控制台，点击顶部菜单栏的“审批设置”页面。

2. 启用钉钉渠道审批

   • 在“审批设置”页面，勾选“钉钉渠道审批”。
   • 在弹出的“关联审批模板”窗口中，选择官方模板并单击“一键生成”。此操作将在您的钉钉企业OA审批应用中创建一个Quick BI审批模板。
   • 单击“确认”保存设置。

3. 测试审批流程

   • 保存设置后，单击“测试”按钮，发起一个OA审批实例。若成功发起，则表明OA审批流程已正确创建。

三、常见问题及解决方案

问题一：创建钉钉OA官方审批模板时提示权限不足

• 问题描述：提示“钉钉 API 调用失败[createOaApprovalTemplate]， [Forbidden.AccessDenied.AccessTokenPermissionDenied - code: 403, 没有调用该接口的权限。”
• 原因：钉钉权限管理未开启相关OA审批权限。
• 解决方案：
  在钉钉权限管理中开启以下权限：
  • 工作流实例写权限
  • 工作流模板写权限
  • 工作流模板读权限
  • 工作流实例读权限。

问题二：钉钉应用内的审批结果无法同步到Quick BI

• 问题描述：钉钉应用内的审批结果（如同意、拒绝等）无法同步到Quick BI。
• 解决方案：
  1. 检查配置一致性：
     • 确保Quick BI内钉钉的事件订阅配置与钉钉企业内部应用的事件订阅配置中的加密 aes_key 和签名 token 保持一致。
     • 在钉钉的应用内单击保存，检查是否能够保存成功。
  2. 检查网络问题：
     • 确认Quick BI的域名是否为公网域名，确保网络连通性。

四、注意事项

• 审批流切换的影响：
  • 若从Dataphin内部审批流切换为外部审批流，已发起但未完成的审批单可在Dataphin继续处理。
  • 若从一个外部审批流切换到另一个外部审批流或更改审批流设置参数，已发起的审批单将按照新流程处理。若回调URL变更，可能导致回调失败，需重新发起审批。
  • 若从外部审批流变更为内部审批流，外部审批的结果无法同步至Dataphin，原审批单需通过撤回或强制撤回关闭。
• 角色权限限制：仅超级管理员与系统管理员角色的账号有权进行审批设置。

通过上述步骤，您可以顺利完成钉钉OA审批的接入配置，并解决常见的配置问题。