钉钉集成常见问题
温馨提示：本页面内容较多，可通过浏览器 Ctrl+F 搜索关键字
1、定时同步钉钉通讯录
解决办法：
苍穹预置了钉钉通讯录同步的定时任务，开启之后即可定时同步：
步骤一：5.0及以下版本进入【系统服务云】->【系统管理】->【调度管理】->【调度作业】搜索“钉钉”关键字，如果作业是禁用状态需手动开启，如已启用状态则无需操作（直接进入步骤二）。
6.0及以上版本菜单路径【系统服务云】->【调度中心】->【调度作业】
步骤二：5.0及以下版本进入【调度计划】界面新增一个计划引用【调度作业】界面的钉钉同步的作业，定时同步的间隔时间按需求自定义。启用该计划即可定时同步。
6.0及以上版本菜单路径【系统服务云】->【调度中心】->【调度计划】
2、多数据中心钉钉免登问题
问题描述：
钉钉创建了两个应用，分别对应两个不同的数据中心，点击打开其中一个，再打开另一个应用失败，打开的还是上一个数据中心的页面该如何解决？
即将发布的6.0版本已修复此问题，6.0以下版本可通过以下方式处理
解决办法：
第一次点击登录成功，钉钉携带cookie，第二次点击还是默认第一个数据中心，需要修改钉钉管理后台配置的url，将页面指向登录页，登录页会获取钉钉的人员code重新进行登录。具体配置如下：
http://XXXXXX/login-mobile.html?apptype=dd&corpid=dinge9401391dcd3b5b7ee0f45d8e4f7c288&appkey=dingsn7809psa3iqyojv&agentid=782958350&redirect=你现在配置的url，这个url要encode一下，如
3、使用邮箱映射同步钉钉人员
问题描述：
钉钉同步人员，默认使用手机号匹配，如何调整为使用邮箱匹配，建立苍穹与钉钉人员的映射关系？
解决办法：
mc配置租户参数：dingding_login_type，设置为email即可。
4、开启SSO单点插件之后，钉钉免登失败，如何排查？
问题描述：
开启SSO单点插件之后，钉钉免登失败，如何排查？
解决办法：
钉钉免登的流程如下：
【前端获取人员code】->【携带code请求后端】->【后端根据配置+code请求钉钉接口】->【钉钉根据权限返回手机号或者邮箱】->【后端根据邮箱或者手机号进行登录】
一般url会先请求到后端，比如待办请求，是后端的请求，所有并不会经过前端而是直接到后端，后端发现未携带code则会继续往下走认证过程，直到重定向到登录页，前端处理获取code。在此过程中会经过SSO单点插件，SSO单点插件未正确处理则会免登失败。
具体解决见：https://vip.kingdee.com/article/515523200159925248?productLineId=29&isKnowledge=1
5、钉钉人员同步成功，但是映射关系没有建立，如何排查？
问题描述：
钉钉人员同步成功，但是映射关系没有建立，如何排查？
解决办法：
（1）.确定钉钉接口权限是否开启，钉钉是根据手机号或者邮箱进行通讯录同步，所以手机号及邮箱接口权限必须开启。
（2）.确定钉钉端手机号（邮箱）与星瀚（苍穹）端是否一致，不一致不会同步。
（3）.以上检查完毕都没问题就使用postman调接口调试，看看钉钉的接口返回什么值，返回值是否有误，详情见链接：
6、钉钉免登失败，报错431是怎么回事？
问题描述：
解决办法：
钉钉在免登时前端会获取人员信息code，拿到code访问后端，后端正常消费这个code，并且免登，后端返回异常就会出现此问题。
排查方法：根据免登插件查看后端monitor日志，不确定是哪个插件可以去monitor查看属性
比较常见的问题有：
·未配置免登插件，按照上面的步骤authtication.apps搜索不到插件：去mc将免登插件配置上去，authtication.apps=kd.bos.login.thirdauth.app.dingding.DDAuthticationPublic
·星瀚&苍穹端未配置钉钉的应用信息或者配置的信息有误：在界面上进行配置（注意检查不要有回车或者空格等特殊符号）
·首页链接信息有误，检查这几个参数：
7、 发送到钉钉的待办链接打不开如何排查？
问题描述：
发送到钉钉的待办链接打不开如何排查？
解决办法：
从页面上把链接复制出来，如图
·看下这个链接（示例如下）是否携带code，没携带则是前端未生成code（红色部分），需要仔细检查链接是否携带正确的参数（蓝色部分）
http://172.xxxx.87/ierp/integration/yzjShareOpen.do?formId=wf_approvalpageview_bac&mb_formId=wf_approvalmobileview_bac&pkId=1808779549375213568&src=wf&accountId=1687792179327533056&processInstanceId=1808779580153017344&type=dynApply&msgId=1808779678392004608&apptype=dd&corpid=dingba8e5ddb0f1ec961a6cb783455b&appkey=dingqykrmrvdv4ke39&code=xxxxx
·如果参数携带code，则去monitor查询免登日志（查询步骤同问题6），检查免登是否报错。
·若monitor日志未发现问题，检查是否开启SSO单点登录，是否被SSO插件拦截
8、 移动端钉钉待办链接打开乱码，PC端打开是到首页？
问题描述：
移动端钉钉待办链接打开乱码，PC端打开是到首页,这种情况如何排查？
解决办法：
原因：链接上没有formId参数导致的。移动端页面必须要有formId参数，没有该参数则会报错，而PC端没有该参数则会默认跳转到首页。
·（1）检查发送到钉钉的链接是否携带formId参数；
·（2）检查是否有SSO单点插件进行过重定向，重定向的地址是否正确
如图，重定向的链接有误：
正确的重定向链接： http://172.xxxx.87/ierp/integration/yzjShareOpen.do?formId=wf_approvalpageview_bac&mb_formId=wf_approvalmobileview_bac&pkId=1808779549375213568&src=wf&accountId=1687792179327533056&processInstanceId=1808779580153017344&type=dynApply&msgId=1808779678392004608&apptype=dd&corpid=dingba8e5ddb0f1ec961a6cb783455b&appkey=dingqykrmrvdv4ke39&code=xxxxx
单点插件重定向之后变成：http://172.xxxx.87/ierp/integration/mobile.html?formId=wf_approvalpageview_bac&mb_formId=wf_approvalmobileview_bac&pkId=1808779549375213568&src=wf&accountId=1687792179327533056&processInstanceId=1808779580153017344&type=dynApply&msgId=1808779678392004608&apptype=dd&corpid=dingba8e5ddb0f1ec961a6cb783455b&appkey=dingqykrmrvdv4ke39&code=xxxxx
是这种情况则需要修改代码
9、同步钉钉通讯录，人员无法正常同步
问题描述：
手机号无误，但同步钉钉通讯录，人员未正常同步
问题分析：
由于钉钉推出的“企业账户”在钉钉旧接口中不返回手机号，导致在苍穹中无法同步钉钉通讯录这类企业账户，需升级至v6.06以上版本。
10、钉钉同步通讯录无法同步海外手机号
问题描述：
员工手机号是香港或海外手机号，如何正常同步钉钉通讯录并实现钉钉免登苍穹？
解决办法：
由于钉钉接口将区号非86的手机号拆分为区号和手机号2个字段返回，导致钉钉用户的手机号无法跟苍穹用户匹配上，要实现正常同步和免登，需升级苍穹至v6.0.2版本，即可正常免登。
如不升级，另外方案是通过二开插件解决，详见《海外手机号钉钉免登二开案例》
11、钉钉页面打不开或者打开是空白页面？
解决办法：
1、查看钉钉免登日志，看看是否有日志记录；
2、有过有日志记录根据日志提示修改配置，若没有日志提示，则检查Corpid、appkey、agentid这些参数是否正确，如果不正确，则前端获取不到人员code，无法跳转也会显示空白。
钉钉集成常见问题
本文2024-09-23 00:33:43发表“云苍穹知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-cangqiong-140254.html
