一、准备阶段

  • 勤哲系统套餐7,小版本更新到 19.1.11(或更新)
  • 钉钉账号

二、获取钉钉应用access_token

a. 在钉钉中自建应用 — 与企业微信类似,每次API调用都需要access_token。钉钉需要先自建一个应用,用该应用的AppKey与AppSecret换取access_token。

建立钉钉应用
在钉钉中创建应用
查看secret
查看应用Secret
查看AppKey
查看Secret和AppKey

b. 定义WebAPI — 在勤哲系统设计界面新增WebAPI,参考API技术文档填写请求地址,选择GET调用方法,依次完成请求参数与返回参数的填写。

定义WebAPI-1
定义WebAPI-2
定义WebAPI-3
定义WebAPI-4
WebAPI定义(请求/返回参数配置)

c. 获取access_token — 利用 《获取企业微信打卡数据》 中 AccessToken 模板,添加 WebAPI Reader 表间公式,执行后获取并保存 access_token。注意不要在前端任何地方显示完整的 access_token。

获取access_token
WebAPI Reader获取钉钉access_token

三、获取打卡数据

a. 阅读API文档 — 查阅钉钉"开放考勤打卡数据"API文档。注意:与企业微信不同,钉钉开始/结束时间不需要转换为Unix时间戳,但两者之间间隔不能超过7天。

API文档-1
API文档-2
API文档-3
钉钉打卡API文档

b. 新建打卡WebAPI — 参考API文档填写接口地址等。

WebAPI配置-1
WebAPI配置-2
WebAPI配置-3
WebAPI配置-4
钉钉打卡WebAPI配置

c. 设置返回参数 — 注意:钉钉API文档未及时更新,与实际返回数据稍有不同,建议先用Postman等工具测试后再复制。

返回参数-1
返回参数-2
返回参数设置(建议先用Postman验证)

d-e. 新建提取模板并配置WebApiReader公式

提取模板
新建用于提取钉钉打卡数据的模板
WebApiReader-1
WebApiReader-2
WebApiReader-3
WebApiReader-4
WebApiReader提数公式设置

四、演示效果

演示
从钉钉提取打卡数据演示

总结

勤哲系统通过 WebAPI 与提供API接口的系统安全高效地进行数据交换,不管对方是企业微信、钉钉还是其他有API接口的系统,操作过程都是类似的:先查阅对方API文档,在勤哲系统创建WebAPI进行对接,最后在模板中通过表间公式执行数据提取或回写。

需要留意的是,钉钉会对一些API每次返回的数据量进行控制,例如本例引用的API一次只能提取50个员工、50条记录,需要多次提取。钉钉关于考勤方面的API还有很多(考勤月度总结等),OA审批等也都可以按照上面步骤提取到勤哲系统。