客户的成功,我们的骄傲

我们的上万家客户来自电信、电力能源、石油石化、冶金矿产、金融保险、制造、流通、服务、科教文卫、IT高科技、政府及公共服务等各个行业,他们靠自己的力量成功实现了企业管理信息化,请来分享他们的成功故事,还有,你也能!

利用勤哲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文档
获取钉钉打卡数据 - 建立应用

获取钉钉打卡数据 - 查看 secret
获取钉钉打卡数据 - 查看 secret 和 appkey

b) 定义WebAPI

进入勤哲系统设计界面,新增一个WebAPI。参考API技术文档,抄写请求地址到接口地址,选择GET调用方法,自定义一个名称。然后参考文档要求和下面示例,依次完成请求参数与返回参数的填写。
获取钉钉打卡数据 - 定义WebAPI(1)
获取钉钉打卡数据 - 定义WebAPI(2)
获取钉钉打卡数据 - 定义WebAPI(3)
获取钉钉打卡数据 - 定义WebAPI(4)

c) 获取 access_token

利用上一个案例《获取企业微信打卡数据》中AccessToken模板,添加一个WebAPI Reader表间公式。然后在工作台新建一张表单,执行表间公式,获取access_token并保存。注意保密access_token,不要在前端任何地方显示完整的access_token.
WebApi reader - 获取钉钉应用的 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)。