- 勤哲系统套餐7,小版本更新到 19.1.11(或更新)
- 钉钉账号
一、准备阶段
二、获取钉钉应用access_token
a. 在钉钉中自建应用 — 与企业微信类似,每次API调用都需要access_token。钉钉需要先自建一个应用,用该应用的AppKey与AppSecret换取access_token。
在钉钉中创建应用
查看应用Secret
查看Secret和AppKey
b. 定义WebAPI — 在勤哲系统设计界面新增WebAPI,参考API技术文档填写请求地址,选择GET调用方法,依次完成请求参数与返回参数的填写。
WebAPI定义(请求/返回参数配置)
c. 获取access_token — 利用 《获取企业微信打卡数据》 中 AccessToken 模板,添加 WebAPI Reader 表间公式,执行后获取并保存 access_token。注意不要在前端任何地方显示完整的 access_token。
WebAPI Reader获取钉钉access_token
三、获取打卡数据
a. 阅读API文档 — 查阅钉钉"开放考勤打卡数据"API文档。注意:与企业微信不同,钉钉开始/结束时间不需要转换为Unix时间戳,但两者之间间隔不能超过7天。
钉钉打卡API文档
b. 新建打卡WebAPI — 参考API文档填写接口地址等。
钉钉打卡WebAPI配置
c. 设置返回参数 — 注意:钉钉API文档未及时更新,与实际返回数据稍有不同,建议先用Postman等工具测试后再复制。
返回参数设置(建议先用Postman验证)
d-e. 新建提取模板并配置WebApiReader公式
新建用于提取钉钉打卡数据的模板
WebApiReader提数公式设置
四、演示效果
从钉钉提取打卡数据演示
总结
勤哲系统通过 WebAPI 与提供API接口的系统安全高效地进行数据交换,不管对方是企业微信、钉钉还是其他有API接口的系统,操作过程都是类似的:先查阅对方API文档,在勤哲系统创建WebAPI进行对接,最后在模板中通过表间公式执行数据提取或回写。
需要留意的是,钉钉会对一些API每次返回的数据量进行控制,例如本例引用的API一次只能提取50个员工、50条记录,需要多次提取。钉钉关于考勤方面的API还有很多(考勤月度总结等),OA审批等也都可以按照上面步骤提取到勤哲系统。