俗話說：“沒有規(guī)矩，不成方圓”。一個企業(yè)想要發(fā)展，就必須建立起一套成體系的管理機制。作為企業(yè)管理中的日常項目，員工打卡這一環(huán)節(jié)至關(guān)重要。近年來，隨著移動互聯(lián)網(wǎng)的發(fā)展，企業(yè)考勤方式不斷更新迭代，逐漸由傳統(tǒng)人工打卡向信息化改進。到如今，大多數(shù)企業(yè)已經(jīng)用上了基于人工智能技術(shù)開發(fā)的微信移動考勤系統(tǒng)。
實際上，相對傳統(tǒng)的指紋打卡，微信移動考勤指的是員工只要掏出手機，輕輕點擊就能完成打卡。即使遇到上下班打卡高峰期，也可以隨時打卡，完全自由自主，不受擁擠人潮的影響。微信打卡不僅方便員工，也有利于企業(yè)信息化管理。企業(yè)可自行設(shè)定員工的考勤范圍，只有進入考勤范圍，員工的打卡才算有效。且人臉具有唯一性，復(fù)制難度高、成本高，可以有效避免代打卡事件的發(fā)生。
一、準(zhǔn)備階段：
a)勤哲系統(tǒng)套餐7，小版本更新到19.1.11(或更新)。
b)企業(yè)微信賬號。
二、獲取企業(yè)微信打卡應(yīng)用的access_token。企業(yè)微信每一個API每一次調(diào)用都需要使用access_token認證，所以必須會熟練獲取各種access_token.
a)獲取access_token - 接口文檔 - 企業(yè)微信開發(fā)者中心打開網(wǎng)頁查看技術(shù)文檔
b)Corpid 來自企業(yè)微信，我的企業(yè)， 企業(yè)ID.
c)Corpsecret 來自每個應(yīng)用的Secret, 例如打卡應(yīng)用
d)進入勤哲系統(tǒng)設(shè)計界面，新增一個WebAPI，接口地址參考圖一access_token技術(shù)文檔說明，注意，不要包含?(問號)及后面的部分，這部分會通過請求參數(shù)自動拼接到接口URL.
e)填寫請求參數(shù)，注意參數(shù)名稱必須和技術(shù)文檔里面的一致。默認值可添加也可不添加。
f)返回參數(shù)，可以從企業(yè)微信access_token技術(shù)文檔直接復(fù)制粘貼。不需要的字段可以刪除。點識別，進入?yún)?shù)集設(shè)置，比較簡單，唯一要注意的是設(shè)置一個成功條件。這個可以根據(jù)技術(shù)文檔描述決定。例如返回errcode為0的時候，代表本次API調(diào)用成功， 也可以用errmsg=”ok”為成功標(biāo)志。確定后即可。
g)Access_token都是有時效性的，默認為7200秒(2小時)。關(guān)于access_token獲取的時機，有2種方案，自己根據(jù)需求靈活決定。方案一，在提取打卡數(shù)據(jù)時生成(先獲取access_token, 隨后用它提取打卡數(shù)據(jù)，全部在一個模板內(nèi)完成)。方案二，單獨做一個模板，專門用來獲取(更新)各種應(yīng)用的access_token. 下面采用方案二進行演示。
h)勤哲系統(tǒng)新建一個模板，添加一個WebAPI Reader表間公式。然后在工作臺新建一張表單，執(zhí)行表間公式，獲取access_token并保存。注意保密access_token，不要在前端任何地方顯示完整的access_token.
i)可以通過下面方法減少access_token在前端暴露的風(fēng)險。1. 相關(guān)單元格使用自定義格式化(;;;**)+ 2. 字段設(shè)置為隱藏，不可編輯。
三、獲取打卡數(shù)據(jù)：
a)閱讀獲取企業(yè)打卡數(shù)據(jù)API文檔。
b)在勤哲系統(tǒng)新建一個WebAPI, 參考API文檔填寫接口地址等。 問號之后的都不要。注意，這個API的調(diào)用方法是POST, 前面獲取access_token是GET方法。
c)直接復(fù)制API文檔里面的請求參數(shù)示例，然后點識別。
d)轉(zhuǎn)到QueryParam界面，點擊右上加號，增加一個access_token的參數(shù)，文字類型選500或新建一個文字類型，access_token長度為214.
e)返回參數(shù)，直接從API文檔復(fù)制粘貼，可以刪除不要的字段。
f)點識別后進入?yún)?shù)集界面，設(shè)置一個成功條件，確定即可。
g)在勤哲系統(tǒng)，設(shè)計里面新建一個模板，提取企業(yè)微信打卡數(shù)據(jù)。開始時間與結(jié)束時間，可以通過EXCEL公式轉(zhuǎn)換為unix時間戳。公式為：(C5-DATE(1970,1,1))*86400，其中C5為引用的普通時間格式。
h)新建一個普通提數(shù)公式，從前面做模板提取access_token.
i)再新建一個WebApiReader提數(shù)公式，從企業(yè)微信提取打卡數(shù)據(jù)。
j)請求參數(shù)設(shè)置，其中微信用戶_明細.UserId, 其實也是一個從企業(yè)微信提取的考勤用戶表。也可以手工做一份表。
四、演示
a)獲取access_token
b)從企業(yè)微信提取打卡數(shù)據(jù)
總結(jié)：
根據(jù)相關(guān)負責(zé)人介紹，WebAPI是繼勤哲外部數(shù)據(jù)源功能之后一項重大新功能，適應(yīng)客戶對不同系統(tǒng)之間數(shù)據(jù)共享的安全與便捷的需求。通過WebAPI不但可以從企業(yè)微信提取打卡數(shù)據(jù)，其他例如企業(yè)微信內(nèi)置應(yīng)用的數(shù)據(jù)(例如審批等)都可以通過類似方法獲取，同樣釘釘內(nèi)置應(yīng)用數(shù)據(jù)，金數(shù)據(jù)，問卷星，企業(yè)ERP系統(tǒng)(提供API接口的)都可以實現(xiàn)數(shù)據(jù)與勤哲系統(tǒng)互通，包括提取與回寫。
