利用勤哲Excel服务器获取钉钉打卡数据
范工，电话（微信同号）：15818855188，QQ：3051828416
一、准备阶段：
a) 勤哲系统套餐7，小版本更新到19.1.11（或更新）
b) 钉钉账号
二、 获取钉钉应用access_token。a) 在钉钉中自建应用
与企业微信类似，每一个API每一次调用都需要使用access_token认证，但钉钉获取access_token稍微有些不同，需要先自建一个应用, 关于自建应用，可以参考 勤哲官网在线教程30.2.4节或者钉钉相关指南。用这个应用的AppKey与AppSecret换取access_token，相关API技术要求参考 API文档
b) 定义WebAPI
进入勤哲系统设计界面，新增一个WebAPI。参考API技术文档，抄写请求地址到接口地址，选择GET调用方法，自定义一个名称。然后参考文档要求和下面示例，依次完成请求参数与返回参数的填写。
c) 获取 access_token
利用上一个案例《获取企业微信打卡数据》中AccessToken模板，添加一个WebAPI Reader表间公式。然后在工作台新建一张表单，执行表间公式，获取access_token并保存。注意保密access_token，不要在前端任何地方显示完整的access_token.
三、 获取打卡数据：
a) 阅读获取钉钉打卡数据API文档。
b) 在勤哲系统新建一个WebAPI, 参考API文档填写接口地址等。
c) 设置返回参数
这里，理论上可以直接从API文档说明直接复制粘贴，但经过实测，发现钉钉API文档没有及时更新，与实际返回数据稍有不同，建议先用第3方API测试工具例如Postman测试后，复制过来。
d) 新建用于提取钉钉打卡数据的模板
在勤哲系统，设计里面新建一个模板，提取钉钉打卡数据。开始时间与结束时间，与从企业微信提取打卡数据不同，这里的开始时间和结束时间不需要转换为unix时间戳。但开始时间和结束时间之间的间隔不能超过7天。
e) 新建一个WebApiReader提数公式，从钉钉提取打卡数据。
四、 演示
五．总结
勤哲系统通过WebAPI与提供API的接口的系统安全高效地进行数据交换，不管对方是企业微信，是钉钉，还是其他有API接口的系统，操作过程都是类似的。先查阅对方API文档说明，在勤哲系统创建WebAPI进行对接，最后在模板中通过表间公式执行数据提取或回写。
需要留意的是，考虑到数据量与效率问题，钉钉会对一些API每次返回的数据量进行控制，这样用户可能需要多次提取考勤打卡数据。例如，本例中引用的API，一次只能提取50个员工，50条记录。钉钉关于考勤方面的API还有很多个，例如考勤月度总结， 其他方面例如OA审批等都可以按照上面步骤提取到勤哲系统。
欢迎大家尝试，需要技术支持请联系范工（15818855188）。
