- 勤哲系统套餐7,小版本更新到 19.1.11(或更新)
- 企业微信账号
一、准备阶段
二、获取企业微信打卡应用的access_token
企业微信每一个 API 每一次调用都需要使用 access_token 认证。
a. 查看技术文档 — 打开企业微信开发者中心获取 access_token 接口文档。
b-c. 获取Corpid和Corpsecret — Corpid 来自企业微信"我的企业"企业ID;Corpsecret 来自每个应用的Secret(例如打卡应用)。
d-f. 在勤哲系统新增WebAPI — 填写接口地址(不含?及后面参数)、请求参数(参数名称必须与文档一致),以及返回参数(可从文档直接复制粘贴),设置成功条件(errcode为0或errmsg="ok")。
g-h. 获取并保存access_token — 单独建一个模板专门更新各应用的access_token。access_token有效期7200秒(2小时)。注意保密,不要在前端显示完整token。
i. 隐藏access_token — 可通过自定义格式化(;;;**)+ 字段设置隐藏不可编辑,减少token在前端暴露的风险。
三、获取打卡数据
a-f. 新建打卡数据WebAPI — 参考企业微信获取打卡数据 API 文档,注意调用方法是 POST(与获取token的GET不同),直接复制粘贴请求参数示例,设置access_token参数和返回参数。
g-i. 新建模板并设置公式 — 在模板中设置普通提数公式获取access_token,再设置WebApiReader提数公式从企业微信提取打卡数据。开始/结束时间通过Excel公式转换为Unix时间戳:(C5-DATE(1970,1,1))*86400
四、演示效果
总结
WebAPI 是勤哲外部数据源功能之后的一项重大新功能。通过 WebAPI 不但可以从企业微信提取打卡数据,还可以获取企业微信内置应用(审批等)数据,同样钉钉内置应用数据、金数据、问卷星、企业ERP系统(提供API接口的)都可以实现数据与勤哲系统互通,包括提取与回写。