要调用钉钉OA审批的数据,您需要完成以下步骤和配置。以下是详细的说明和操作指南:
1. 前提条件
在调用钉钉OA审批数据之前,请确保满足以下前提条件: - 已开通并正确配置了Quick BI的钉钉微应用,并将其关联到Quick BI组织。 - 您的钉钉企业管理员权限已开启,并且团队中至少有一名成员。 - 钉钉的OA审批权限已启用,包括以下权限: - 工作流实例写权限 - 工作流模板写权限 - 工作流模板读权限 - 工作流实例读权限。
2. 配置钉钉OA审批对接
步骤一:登录Quick BI控制台
- 使用管理员账号登录Quick BI控制台。
- 导航至“审批设置”页面。
步骤二:启用钉钉渠道审批
- 在“审批设置”页面,勾选钉钉渠道审批选项。
- 在弹出的“关联审批模板”窗口中,选择官方模板,并点击“一键生成”。
- 此操作将在您的钉钉企业OA审批应用中创建一个Quick BI审批模板。
- 点击“确认保存”,完成模板的创建。
步骤三:测试与校验
- 点击“测试”按钮,尝试发起一个OA审批实例。
- 如果能够成功发起,则表明OA审批流程已创建成功。
3. 调用钉钉OA审批数据的关键点
为了确保钉钉OA审批数据能够被正确调用,需注意以下关键点:
(1) 配置事件订阅
- 检查配置一致性:确保Quick BI内的钉钉事件订阅配置与钉钉企业内部应用的事件订阅配置一致,特别是加密
aes_key
和签名 token
的值。
- 保存验证:在钉钉的应用管理页面中,单击“保存”以验证配置是否成功。
(2) 确保网络可达性
- 公网域名要求:Quick BI的域名必须为公网域名,以确保钉钉能够正常回调数据。
(3) API权限与调用限制
- API权限:确保钉钉企业管理员已开启相关API权限(如工作流实例读/写权限)。
- 调用限制:标准版钉钉每月接口调用限制为5000次,超出限制需升级至专业版或专属版。
4. 常见问题及解决方案
问题一:创建钉钉OA审批模板时提示权限错误
- 问题描述:创建过程中提示“钉钉 API 调用失败 [createOaApprovalTemplate],[Forbidden.AccessDenied.AccessTokenPermissionDenied - code: 403, 没有调用该接口的权限]”。
- 解决方案:检查并开启钉钉的OA审批权限,包括工作流实例写、模板写、模板读和实例读权限。
问题二:钉钉审批结果未同步到Quick BI
- 问题描述:钉钉应用内的审批结果(如同意、拒绝等)未能同步到Quick BI。
- 解决方案:
- 检查Quick BI与钉钉的事件订阅配置是否一致。
- 确认Quick BI域名为公网域名。
5. 数据调用的实际应用场景
通过上述配置,您可以实现以下场景: - 自动化权限申请:用户在Quick BI中发起权限申请后,系统会自动触发钉钉OA审批流程。 - 审批结果同步:钉钉审批完成后,结果将同步回Quick BI,更新相关状态。 - 消息通知:审批状态变更时,可通过钉钉消息通知相关人员。
6. 注意事项
- 审批流切换影响:如果从Dataphin或其他系统切换审批流,需注意在途审批单的处理规则。例如,若从外部审批流切换到内部审批流,原审批结果可能无法同步。
- 接口调用量监控:定期检查钉钉开发者后台的API调用量,避免因超出限制导致功能异常。
通过以上步骤和注意事项,您可以顺利调用钉钉OA审批的数据,并实现与Quick BI或其他系统的无缝对接。