一、准备阶段

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

二、获取企业微信打卡应用的access_token

企业微信每一个 API 每一次调用都需要使用 access_token 认证。

a. 查看技术文档 — 打开企业微信开发者中心获取 access_token 接口文档。

b-c. 获取Corpid和Corpsecret — Corpid 来自企业微信"我的企业"企业ID;Corpsecret 来自每个应用的Secret(例如打卡应用)。

access_token文档
access_token接口文档
查看Secret
在打卡应用中查看Corpsecret

d-f. 在勤哲系统新增WebAPI — 填写接口地址(不含?及后面参数)、请求参数(参数名称必须与文档一致),以及返回参数(可从文档直接复制粘贴),设置成功条件(errcode为0或errmsg="ok")。

新增WebAPI
勤哲系统新增WebAPI配置
请求参数
填写请求参数
返回参数
参数集设置
参数集设置(设置成功条件)

g-h. 获取并保存access_token — 单独建一个模板专门更新各应用的access_token。access_token有效期7200秒(2小时)。注意保密,不要在前端显示完整token。

WebAPI Reader定义
WebAPI Reader表间公式定义
执行获取token
执行公式获取access_token

i. 隐藏access_token — 可通过自定义格式化(;;;**)+ 字段设置隐藏不可编辑,减少token在前端暴露的风险。

隐藏token
隐藏设置
隐藏关键信息的设置方法

三、获取打卡数据

a-f. 新建打卡数据WebAPI — 参考企业微信获取打卡数据 API 文档,注意调用方法是 POST(与获取token的GET不同),直接复制粘贴请求参数示例,设置access_token参数和返回参数。

打卡API文档
企业微信获取打卡数据API文档
POST方法配置
请求参数识别
参数识别结果
直接复制API文档示例,点识别自动解析
access_token参数
添加access_token参数(长度214)
返回参数
成功条件
设置成功条件

g-i. 新建模板并设置公式 — 在模板中设置普通提数公式获取access_token,再设置WebApiReader提数公式从企业微信提取打卡数据。开始/结束时间通过Excel公式转换为Unix时间戳:(C5-DATE(1970,1,1))*86400

模板设计
时间戳转换
Unix时间戳转换公式
模板完整
获取token公式
提取access_token的普通提数公式
WebApiReader公式
WebApiReader提数公式配置
请求参数设置
请求参数详情
请求参数设置(含考勤用户ID)

四、演示效果

获取token演示
获取access_token演示
提取打卡数据演示
从企业微信提取打卡数据演示

总结

WebAPI 是勤哲外部数据源功能之后的一项重大新功能。通过 WebAPI 不但可以从企业微信提取打卡数据,还可以获取企业微信内置应用(审批等)数据,同样钉钉内置应用数据、金数据、问卷星、企业ERP系统(提供API接口的)都可以实现数据与勤哲系统互通,包括提取与回写。