勤哲Excel服務(wù)器WebAPI實(shí)用案例：獲取企業(yè)微信打卡數(shù)據(jù)

范工，電話(huà)（微信同號(hào)）：15818855188，QQ：3051828416

一、準(zhǔn)備階段：

二、 獲取企業(yè)微信打卡應(yīng)用的access_token。

a) 獲取access_token - 接口文檔 - 企業(yè)微信開(kāi)發(fā)者中心 (qq.com) 打開(kāi)網(wǎng)頁(yè)查看技術(shù)文檔

b) Corpid 來(lái)自企業(yè)微信，我的企業(yè)， 企業(yè)ID.

c) Corpsecret 來(lái)自每個(gè)應(yīng)用的Secret, 例如打卡應(yīng)用

d) 進(jìn)入勤哲系統(tǒng)設(shè)計(jì)界面，新增一個(gè)WebAPI，接口地址參考圖一access_token技術(shù)文檔說(shuō)明，注意，不要包含？（問(wèn)號(hào)）及后面的部分，這部分會(huì)通過(guò)請(qǐng)求參數(shù)自動(dòng)拼接到接口URL.

e) 填寫(xiě)請(qǐng)求參數(shù)，注意參數(shù)名稱(chēng)必須和技術(shù)文檔里面的一致。默認(rèn)值可添加也可不添加。

f) 返回參數(shù)，可以從企業(yè)微信access_token技術(shù)文檔直接復(fù)制粘貼。不需要的字段可以刪除。點(diǎn)識(shí)別，進(jìn)入?yún)?shù)集設(shè)置，比較簡(jiǎn)單，唯一要注意的是設(shè)置一個(gè)成功條件。這個(gè)可以根據(jù)技術(shù)文檔描述決定。例如返回errcode為0的時(shí)候，代表本次API調(diào)用成功， 也可以用errmsg=”ok”為成功標(biāo)志。確定后即可。

g) Access_token都是有時(shí)效性的，默認(rèn)為7200秒（2小時(shí)）。關(guān)于access_token獲取的時(shí)機(jī)，有2種方案，自己根據(jù)需求靈活決定。方案一，在提取打卡數(shù)據(jù)時(shí)生成（先獲取access_token, 隨后用它提取打卡數(shù)據(jù)，全部在一個(gè)模板內(nèi)完成）。方案二，單獨(dú)做一個(gè)模板，專(zhuān)門(mén)用來(lái)獲取(更新)各種應(yīng)用的access_token. 下面采用方案二進(jìn)行演示。

h) 勤哲系統(tǒng)新建一個(gè)模板，添加一個(gè)WebAPI Reader表間公式。然后在工作臺(tái)新建一張表單，執(zhí)行表間公式，獲取access_token并保存。注意保密access_token，不要在前端任何地方顯示完整的access_token.

i) 可以通過(guò)下面方法減少access_token在前端暴露的風(fēng)險(xiǎn)。1. 相關(guān)單元格使用自定義格式化（;;;**）+ 2. 字段設(shè)置為隱藏，不可編輯。

三、 獲取打卡數(shù)據(jù)：

a) 閱讀獲取企業(yè)打卡數(shù)據(jù)，參看 API文檔

b) 在勤哲系統(tǒng)新建一個(gè)WebAPI, 參考API文檔填寫(xiě)接口地址等。 問(wèn)號(hào)之后的都不要。注意，這個(gè)API的調(diào)用方法是POST, 前面獲取access_token是GET方法。

c) 直接復(fù)制API文檔里面的請(qǐng)求參數(shù)示例，然后點(diǎn)識(shí)別。

d) 轉(zhuǎn)到QueryParam界面，點(diǎn)擊右上加號(hào)，增加一個(gè)access_token的參數(shù)，文字類(lèi)型選500或新建一個(gè)文字類(lèi)型，access_token長(zhǎng)度為214.

e) 返回參數(shù)，直接從API文檔復(fù)制粘貼，可以刪除不要的字段。

f) 點(diǎn)識(shí)別后進(jìn)入?yún)?shù)集界面，設(shè)置一個(gè)成功條件，確定即可。

g) 在勤哲系統(tǒng)，設(shè)計(jì)里面新建一個(gè)模板，提取企業(yè)微信打卡數(shù)據(jù)。開(kāi)始時(shí)間與結(jié)束時(shí)間，可以通過(guò)EXCEL公式轉(zhuǎn)換為unix時(shí)間戳。公式為：(C5-DATE(1970,1,1))*86400，其中C5為引用的普通時(shí)間格式。

h) 新建一個(gè)普通提數(shù)公式，從前面做模板提取access_token.

i) 再新建一個(gè)WebApiReader提數(shù)公式，從企業(yè)微信提取打卡數(shù)據(jù)。

j) 請(qǐng)求參數(shù)設(shè)置，其中微信用戶(hù)_明細(xì).UserId, 其實(shí)也是一個(gè)從企業(yè)微信提取的考勤用戶(hù)表。也可以手工做一份表。

四、 演示

a) 獲取access_token

b) 從企業(yè)微信提取打卡數(shù)據(jù)

五．總結(jié)