3.1.2钉钉打卡实时上传对接
<p>[TOC]</p>
<pre><code> 介绍新增钉钉打卡主动推送至人力管家后台配置操作</code></pre>
<h5>一、版本要求</h5>
<p>1.客户系统版本必须要在release/V202012版本及以上版本</p>
<h5>二、参数配置</h5>
<p>1.系统升级完成之后，进入人力管家系统，在“规则设置-配置信息”处筛选“钉钉”,检查以下参数是否配置正确并填写：
1)dd_appKey（详见钉钉配置文档）
<strong>对接钉钉时进行配置</strong>
2)dd_appSecert（详见钉钉配置文档）
<strong>对接钉钉时进行配置</strong>
3)dd_encoding_aes_key（数据加密密钥。用于回调数据的加密， 长度固定为43个字符 ，从a-z, A-Z, 0-9共62个字符中选取,您可以随机生成，ISV(服务提供商)推荐使用注册套件时填写的EncodingAESKey
例如：FxCNkHQzDFPkuM6cXs4DP1T5NFOdMI7DpmV3Zbdy1Tx）
<strong>直接复制该信息，修改个别几个地方的字母即可。</strong>
4)dd_encoding_token（加解密需要用到的token，ISV(服务提供商)推荐使用注册套件时填写的token，普通企业可以随机填写
例如：0123453789ABCDEFGHIJKLMNOPQRSTUV）
<strong>直接复制该信息，修改个别几个地方的字母即可。</strong>
5)dd_callback_tag（打卡回调填写:check_in,其他事件回调参考钉钉开放平台)
需要监听的事件类型，有20种，通常直接复制填入即可：
["user_add_org","user_modify_org","user_leave_org","org_admin_add","org_admin_remove","org_dept_create","org_dept_modify","org_dept_remove","org_remove","label_user_change","label_conf_add","label_conf_modify","label_conf_del","org_change","chat_add_member","chat_remove_member","chat_quit","chat_update_owner","chat_update_title","chat_disband","chat_disband_microapp","check_in","bpms_task_change","bpms_instance_change"]）
<strong>这个信息研发默认配置为：‘check in’，不需要处理</strong></p>
<pre><code> 注：以上信息配置完成后，需要重启客户服务，配置才会生效。（截止21年1月25日功能，操作以实际情况为准）</code></pre>
<h5>三、校验检查</h5>
<p>1.执行链接查询钉钉事件回调类型：
<a href="https://yanshi.cxyhr.cn/api/dd/getCallback，黄色部分替换为客户域名">https://yanshi.cxyhr.cn/api/dd/getCallback，黄色部分替换为客户域名</a>。
执行结果有两种，一种未注册，一种已经注册，效果分别为如下图，执行失败找研发：
未注册：
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/17836269009d8d3fbf0bc74524f9ea4c" alt="" />
已注册：
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/0cad5ada35ca9d10b0c4921e4fc3d529" alt="" />
2.如果未注册，需要执行注册链接进行注册：
<a href="https://yanshi.cxyhr.cn/api/dd/registerCallback，黄色部分替换为客户域名">https://yanshi.cxyhr.cn/api/dd/registerCallback，黄色部分替换为客户域名</a>。
执行成功如下图，执行失败找研发。。。
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/dd481331d3f262793e9ff07c31f5727a" alt="" />
3.如果已经注册，但是接口返回的事件类型没有“check_in”，则需要执行更新链接：
<a href="https://yanshi.cxyhr.cn/api/dd/updateCallback?callBackTag=["user_add_org","user_modify_org","user_leave_org","org_admin_add","org_admin_remove","org_dept_create","org_dept_modify","org_dept_remove","org_remove","label_user_change","label_conf_add","label_conf_modify","label_conf_del","org_change","chat_add_member","chat_remove_member","chat_quit","chat_update_owner","chat_update_title","chat_disband","chat_disband_microapp","check_in","bpms_task_change","bpms_instance_change"]，黄色部分替换为客户域名">https://yanshi.cxyhr.cn/api/dd/updateCallback?callBackTag=["user_add_org","user_modify_org","user_leave_org","org_admin_add","org_admin_remove","org_dept_create","org_dept_modify","org_dept_remove","org_remove","label_user_change","label_conf_add","label_conf_modify","label_conf_del","org_change","chat_add_member","chat_remove_member","chat_quit","chat_update_owner","chat_update_title","chat_disband","chat_disband_microapp","check_in","bpms_task_change","bpms_instance_change"]，黄色部分替换为客户域名</a>。
执行成功如下图，执行失败找研发。。。
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/677ea97097493fffa455558c0ad13926" alt="" />
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/5adc4b41cbd3349fba9d18b06d7b1b0a" alt="" />
4.如果不再使用钉钉回调事件，删除全部回调，执行链接：
<a href="https://yanshi.cxyhr.cn/api/dd/deleteCallback">https://yanshi.cxyhr.cn/api/dd/deleteCallback</a>
执行成功如下图，执行失败找研发。。。
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/4b0c862b054db98ef8627b709cdfdbb6" alt="" /></p>
<h5>四、配置结果</h5>
<p>1.员工在钉钉打卡，打卡记录钉钉会主动推送至人力管家，不需要定时推送</p>