勤哲Excel服务器WebAPI实用案例：获取企业微信打卡数据
范工，电话（微信同号）：15818855188，QQ：3051828416
一、准备阶段：
a) 勤哲系统套餐7，小版本更新到19.1.11（或更新）。
b) 企业微信账号。
二、 获取企业微信打卡应用的access_token。
企业微信每一个API每一次调用都需要使用access_token认证，所以必须会熟练获取各种access_token.
a) 获取access_token - 接口文档 - 企业微信开发者中心 (qq.com) 打开网页查看技术文档
b) Corpid 来自企业微信，我的企业， 企业ID.
c) Corpsecret 来自每个应用的Secret, 例如打卡应用
d) 进入勤哲系统设计界面，新增一个WebAPI，接口地址参考图一access_token技术文档说明，注意，不要包含？（问号）及后面的部分，这部分会通过请求参数自动拼接到接口URL.
e) 填写请求参数，注意参数名称必须和技术文档里面的一致。默认值可添加也可不添加。
f) 返回参数，可以从企业微信access_token技术文档直接复制粘贴。不需要的字段可以删除。点识别，进入参数集设置，比较简单，唯一要注意的是设置一个成功条件。这个可以根据技术文档描述决定。例如返回errcode为0的时候，代表本次API调用成功， 也可以用errmsg=”ok”为成功标志。确定后即可。
g) Access_token都是有时效性的，默认为7200秒（2小时）。关于access_token获取的时机，有2种方案，自己根据需求灵活决定。方案一，在提取打卡数据时生成（先获取access_token, 随后用它提取打卡数据，全部在一个模板内完成）。方案二，单独做一个模板，专门用来获取(更新)各种应用的access_token. 下面采用方案二进行演示。
h) 勤哲系统新建一个模板，添加一个WebAPI Reader表间公式。然后在工作台新建一张表单，执行表间公式，获取access_token并保存。注意保密access_token，不要在前端任何地方显示完整的access_token.
i) 可以通过下面方法减少access_token在前端暴露的风险。1. 相关单元格使用自定义格式化（;;;**）+ 2. 字段设置为隐藏，不可编辑。
三、 获取打卡数据：
a) 阅读获取企业打卡数据，参看 API文档
b) 在勤哲系统新建一个WebAPI, 参考API文档填写接口地址等。 问号之后的都不要。注意，这个API的调用方法是POST, 前面获取access_token是GET方法。
c) 直接复制API文档里面的请求参数示例，然后点识别。
d) 转到QueryParam界面，点击右上加号，增加一个access_token的参数，文字类型选500或新建一个文字类型，access_token长度为214.
e) 返回参数，直接从API文档复制粘贴，可以删除不要的字段。
f) 点识别后进入参数集界面，设置一个成功条件，确定即可。
g) 在勤哲系统，设计里面新建一个模板，提取企业微信打卡数据。开始时间与结束时间，可以通过EXCEL公式转换为unix时间戳。公式为：(C5-DATE(1970,1,1))*86400，其中C5为引用的普通时间格式。
h) 新建一个普通提数公式，从前面做模板提取access_token.
i) 再新建一个WebApiReader提数公式，从企业微信提取打卡数据。
j) 请求参数设置，其中微信用户_明细.UserId, 其实也是一个从企业微信提取的考勤用户表。也可以手工做一份表。
四、 演示
a) 获取access_token
b) 从企业微信提取打卡数据
五．总结
WebAPI是继勤哲外部数据源功能之后一项重大新功能，适应客户对不同系统之间数据共享的安全与便捷的需求。通过WebAPI不但可以从企业微信提取打卡数据，其他例如企业微信内置应用的数据（例如审批等）都可以通过类似方法获取，同样钉钉内置应用数据，金数据，问卷星，企业ERP系统（提供API接口的）都可以实现数据与勤哲系统互通，包括提取与回写。 欢迎大家尝试，需要技术支持请联系范工（15818855188）。
