目录:
1. 概述编辑
本文总结了 FineReport 与钉钉集成的常见问题及解决方案。
2. 定时调度钉钉发送的pdf文件打开方式编辑
问题描述：
安卓需要下载后第三方应用打开但是苹果的可以直接打开
原因分析：
安卓不支持的附件类 url 比如 office文档、pdf、压缩包之类的，都需要通过第三方 App 下载和打开。
3. PC 端钉钉集成环境，新前端样式下的工具栏不支持导出编辑
问题描述：
在PC端的集成环境，从钉钉侧打开报表，新前端样式下，点击报表工具栏导出，会新打开浏览器页面，页面报错：非常抱歉，您无法查看页面。Request method 'GET' not supported。在浏览器去访问平台，打开报表，可以正常导出。
原因分析：
11.0的新前端样式下,工具栏的导出，不支持在集成的环境（微信、钉钉）下进行导出。
解决方案：
更换工具栏样式为经典。
4. 定时调度推送消息到钉钉群消息异常编辑
问题描述：
1）定时调度推送消息到钉钉群，提示：获取不到钉钉应用，请检查网络配置。钉钉调试工具检查网络请求正常
2）钉钉群推送只有第一个群能收到消息。
原因分析：
1）推送到钉钉群需要调用群消息接口，需要钉钉后台未开启获取群会话信息权限。
2）钉钉后台群会话消息权限未全部开启，下边两个都要开放权限“chat相关接口的管理权限”、“chat相关接口的读取权限”。
解决方案：
钉钉后台开启权限即可。
5. 定时调度部分用户无法接收编辑
问题描述：
钉钉部分用户定时调度消息收不到消息。
排查步骤：
1）用户是否匹配了平台用户
2）用户匹配的平台用户是否在推送的范围内
3）检查在触发消息推送的时间点，是否有同步通讯录的操作，导致匹配关系更新或更新不及时出现匹配失败
6. 钉钉集成新建应用空白编辑
问题描述：
新添加了钉钉应用，显示添加成功了，但是下面并没有显示出来（没有数据），日志没有报错。
排查步骤：
在报表服务器物理机上访问钉钉的接口：https://oapi.dingtalk.com/microapp/list?access_token=，如果能访问到，说明网络正常。让客户自己更改了网络的配置。可以正常的提示错误。 新报错“访问IP不在白名单中”，但是客户的钉钉配置中，白名单就是明确的 IP，尝试将IP的最后一个字段修改为 * ，进行测试。
7. 钉钉推送失败，日志报错人员匹配失败编辑
原因分析：
匹配关系表没有更新导致人员匹配失败。
排查步骤：
1）确定定时调度勾选的人员信息，未使用自定义数据集，人员信息正确。
2）确认匹配关系表更新过了，手动操作同步更新钉钉通讯录，再次操作定时调度。
解决方案：
手动同步钉钉通讯录（最好设置自动更新）。
8. 钉钉扫码插件-跳转失败编辑
问题描述：
配置完相关配置，扫码登陆跳转页面提示：如需访问请联系管理员。
原因分析：
钉钉后台对时间有限制，不能相差超过一分钟，要不然传递过去的参数就不合法。
9. 同步的钉钉用户，调用添加部门接口报错编辑
问题描述：
平台用户是同步的钉钉数据集，然后调用添加部门的接口报错Manual source data can not be added under synchronous sources。
原因分析：
这个报错中文翻译就是“无法在同步源下添加手动源数据”，也就是说明无法往同步用户的部门下手动添加部门，调用接口添加也不能。
解决方案：
使用导入用户重新配置用户数据。
10. 移动端文本控件、文件控件点击均无反应编辑
问题描述：
钉钉集成后配置应用的首页链接是钉钉管理页面生成的单张模板链接，设置了之后钉钉打开页面正常展示，但是文本控件的扫码上传和文件控件点击都没有反应
原因分析：
钉钉管理生成 url 时参数解析的问题
解决方案：
删除其他的默认参数，只保留 op=write 这个参数就可以成功扫码、拍照。
11. 钉钉重复消息收不到编辑
问题描述：
用户给钉钉推送消息，刚新建任务时能收到。但再编辑后，收不到消息。或设置了重复推送消息，但是只能收到一条消息。
原因分析：
由于钉钉 APP 本身的限流政策，有如下规定：
1）给同一用户发相同内容消息一天仅允许一次；
2）如果是 ISV 接入方式，给同一用户发消息一天不得超过 100 次；如果是企业接入方式，此上限为 500 。
因此如果给用户推送消息且每次推送的内容一致的话，只接收第一个消息。
注：当定时调度设置了「图文推送>自定义链接」的情况，重复链接可以正常推送。
因为图文推送，都会往调用钉钉图片上传接口，钉钉返回一个图片 url ，每次返回的 url 都不同，所以不会接受不到。
解决方案：
在推送消息时，给推送的主题或者内容加一个时间变量 ${now()} （也可以是别的变量）即可。钉钉消息推送详情参考：钉钉定时推送消息
12. 飞书同步不到用户编辑
原因分析：
飞书应用目前只支持可见范围是全体成员，如果选择单个部门，飞书管理的用户管理处无法获取到飞书用户。
解决方案：
移动端插件 11.0.65 版本之后支持可见范围是部门，可以更新插件解决该问题。
13. 单点集成后报错：errorMessage：corpid不合法编辑
14. 钉钉报错：errorcode: -8编辑
问题描述：
钉钉单点集成后保存
解决方案：
工程部署在内网/局域网内，需要确保设备网络和服务器网络在同一个网段。
15. 提示钉钉对应企业没有域名微应用编辑
问题描述：
用户配置好钉钉集成环境以后，手机上进行单点登录操作，发现如下报错：
排查步骤：
1）排查域名一致性：
钉钉应用如果跟配置了对应的域名环境，由于本身钉钉那边已经配置过对应域名URL了，故本地钉钉配置的时候会报错：为保证企业自建应用安全，同一个域名只能被一个企业使用，该自建应用与XXX使用的域名相同。然后对比这个报错，排查钉钉后台对应的应用中的首页地址，跟实际环境的地址，查看是否是由于域名不匹配引起的。
2）检查具体参数：
既然提示信息说的是对应企业没有该域名微应用，而实际上钉钉企业号里是正常配置了域名微应用，故怀疑是否添加的钉钉应用信息与钉钉后台对应的参数不一致，这里需要检查下 corpID，APPkey，APPsecret 是否正确。