用勤哲Excel服务器软件获取企业微信打卡数据

俗话说：“没有规矩，不成方圆”。一个企业想要发展，就必须建立起一套成体系的管理机制。作为企业管理中的日常项目，员工打卡这一环节至关重要。近年来，随着移动 互联网 的发展，企业考勤方式不断更新迭代，逐渐由传统人工打卡向信息化改进。到如今，大多数企业已经用上了基于人工智能技术开发的 微信 移动考勤系统。

实际上，相对传统的指纹打卡，微信移动考勤指的是员工只要掏出 手机 ，轻轻点击就能完成打卡。即使遇到上下班打卡高峰期，也可以随时打卡，完全自由自主，不受拥挤人潮的影响。微信打卡不仅方便员工，也有利于企业信息化管理。企业可自行设定员工的考勤范围，只有进入考勤范围，员工的打卡才算有效。且人脸具有唯一性，复制难度高、成本高，可以有效避免代打卡事件的发生。

一、准备阶段：

a)勤哲系统套餐7，小版本更新到19.1.11(或更新)。

b)企业微信账号。

二、获取企业微信打卡应用的access_token。企业微信每一个API每一次调用都需要使用access_token认证，所以必须会熟练获取各种access_token.

a)获取access_token - 接口文档 - 企业微信开发者中心打开网页查看技术文档

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接口的)都可以实现数据与勤哲系统互通，包括提取与回写。