3.1.1钉钉对接配置
<p>[TOC]</p>
<table>
<thead>
<tr>
<th>序号</th>
<th>内容</th>
<th>时间</th>
<th>创建人</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>钉钉对接文档更新2.0</td>
<td>2020年7月23日</td>
<td>杨文林</td>
</tr>
</tbody>
</table>
<h3>一、创建微应用</h3>
<h4>1.首先登录企业钉钉，然后点击【工作台】，然后下方的【自建应用】中，点击【自建应用】</h4>
<p><img src="https://www.showdoc.cc/server/api/attachment/visitfile/sign/37fb111e9477c4f6be4c183d9a354148?showdoc=.jpg" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/f951e53282b837e0e2b23acf2cf5709c" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/b36661c04a6252f602e775b3dbc85bae" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/f1ad474076ff5a9ae9ebf541ebf094bf" alt="" /></p>
<h2>**2.然后输入如下图所示</h2>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/3a4a82ceafa47a55322f26d27238a51d" alt="" />
首页地址的编写，agentid的位置见2.1
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/094b72ad0441c737a143814ebb1c7839" alt="" />
网址文字：<a href="https://yanshi.cxyhr.cn/acewill/index.html?agentID=267305405&state=dingding#!/workspace">https://yanshi.cxyhr.cn/acewill/index.html?agentID=267305405&state=dingding#!/workspace</a></p>
<h1>二、获取应用信息，并且配置应用信息</h1>
<pre><code>## **1.接下来需要获取一下钉钉中的几个参数，分别是Agentld，AppKey，AppSect。点击【凭证与基础信息】对应的查看详情。**</code></pre>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/f669e1834a0be406523786979f8b2ba7" alt="" /></p>
<h2><strong> 2.接下来获取一下Cropid，具体方式如下图所示，请记录</strong></h2>
<p><img src="https://www.showdoc.cc/server/api/attachment/visitfile/sign/32975829d53718063fdfe801d373594f?showdoc=.jpg" alt="" /></p>
<h1>三、开通相应权限</h1>
<pre><code>##** 1.接下来开通一下相关的权限，首先返回到刚才的应用中，具体路径如下**</code></pre>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/592453dc61f1f943b3519fba240503ce" alt="" /></p>
<h2><strong>2.获取一下权限</strong></h2>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/e0d23adff967bc0a14373b55d40badf8" alt="" />
各个模块中的权限都要申请添加，主要为通讯录，个人，考勤模块中权限。</p>
<h1>四、应用发布</h1>
<pre><code>## **1.以上配置完成，需要在钉钉后台进行发布，如果不发布的话，钉钉的其他员工是看不到人力管家的。**
## **1.然后点击版本管理进行发布，设置所有人可见**</code></pre>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/74c533b4914d5e3ce48a9a662321e35d" alt="" />
<img src="https://www.showdoc.cc/server/api/attachment/visitfile/sign/b5bbcfe1e2025563d80bc596e6560a04?showdoc=.jpg" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/45d096746edd2013b854b94123ffb58b" alt="" />
以上发布完成即可。</p>
<h1>五、最后一步，配置以上参数四，最后一步，配置以上参数</h1>
<pre><code>## **1.配置第一步,登录客户人力管家网址：**</code></pre>
<p><a href="https://客户.aqwhr.cn/">https://客户.aqwhr.cn/</a></p>
<h2><strong>2.然后点击规则设置--配置信息--找到钉钉相关的配置项。</strong></h2>
<p>名称搜索dd
<img src="https://www.showdoc.cc/server/api/attachment/visitfile/sign/d53af61721cb31f2e61935758e5195fb?showdoc=.jpg" alt="" />
<img src="https://www.showdoc.cc/server/api/attachment/visitfile/sign/d1bb33570adb72f5dbe9f5e7eb3009b8?showdoc=.jpg" alt="" /></p>
<pre><code>## **3.然后按照下方的参数对应信息，将上方获取到的信息对应填写到系统配置信息中。**</code></pre>
<p>dd_cropId 对应上方参数Cropid
dd_appKey 对应上方参数AppKey
dd_appSecer 对应上方参数AppSecret
dd_agentId 对应上方参数AgentId
sync_dd_org_user 是否将人力管家的组织架构同步到钉钉（0代表不同步1代表同步）</p>
<pre><code>##** 4.配置完成后重启一下客户服务就ok了。**</code></pre>
<hr />
<h3>六、同步钉钉需要注意问题</h3>
<h4>1.组织及打卡记录的获取配置</h4>
<p>  1.在人力管家中建立人力管家应用，则所有的数据只能同步到一个组织中，既人员的基本信息与打卡记录等数据只能从一个钉钉中去获取，不能获取打卡记录的是一个组织，获取组织架构的是一个组织
  2.人力管家在钉钉中新建组织的时候，就会同步建立部门群，所以同步前，需要先将钉钉的组织架构手动修改成跟人力管家一致的结构，不然则会建立新的群
  3.钉钉的组织名称跟人力管家的组织名称一样时，则组织架构不会同步，人员则能同步成功。
  4.钉钉与人力管家进行人员同步时，则是人力管家往钉钉同步数据，则人员情况以人力管家的数据为准。同步的时候以手机号进行校验，则不在人力管家，在钉钉的人员会被同步删除。
  5.人力管家往钉钉同步组织的时候，则以人力管家的组织为准，如果人力管家没有此组织，而钉钉有，且钉钉该组织下没有人，则该组织将会被删除，如果该组织下有人，则组织将会被保留。
  6.同步的时候，注意组织架构要与人力管家保持一致，不然会将不同的组织进行删除，同时组织的群也会消失，群聊记录无法进行找回。
  7.如果人力的组织架构跟钉钉的组织架构不同的话，同步后会影响已有的钉钉的审批流，需要坐下审批流的调整。
  8.钉钉中岗位字段是职位，无岗位字段，钉钉中如要展示人力管家的岗位字段，需要在钉钉中新增《岗位》扩展字段，然后进行同步
<strong>备注说明：使用钉钉移动端的客户，要确保钉钉登陆的手机号码与人力管家中人员信息的手机号码保持一致。</strong></p>