钉钉集成常见问题

温馨提示：本页面内容较多，可通过浏览器 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一下，如

 http://XXXXXX/login-mobile.html?apptype=dd&corpid=dinge9401391dcd3b5b7ee0f45d8e4f7c288&appkey=dingsn7809psa3iqyojv&agentid=782958350&redirect=http://XXXXXX/mobile.html%3Fform%3Ddz_mobindex%26apptype%3Ddd%26corpid%3Ddinge9401391dcd3b5b7ee0f45d8e4f7c288%26appkey%3Ddingsn7809psa3iqyojv%26agentid%3D782958350

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&