利用勤哲Excel服務(wù)器獲取釘釘打卡數(shù)據(jù)
范工，電話（微信同號）：15818855188，QQ：3051828416
一、準備階段：
a) 勤哲系統(tǒng)套餐7，小版本更新到19.1.11（或更新）
b) 釘釘賬號
二、 獲取釘釘應(yīng)用access_token。a) 在釘釘中自建應(yīng)用
與企業(yè)微信類似，每一個API每一次調(diào)用都需要使用access_token認證，但釘釘獲取access_token稍微有些不同，需要先自建一個應(yīng)用, 關(guān)于自建應(yīng)用，可以參考 勤哲官網(wǎng)在線教程30.2.4節(jié)或者釘釘相關(guān)指南。用這個應(yīng)用的AppKey與AppSecret換取access_token，相關(guān)API技術(shù)要求參考 API文檔
b) 定義WebAPI
進入勤哲系統(tǒng)設(shè)計界面，新增一個WebAPI。參考API技術(shù)文檔，抄寫請求地址到接口地址，選擇GET調(diào)用方法，自定義一個名稱。然后參考文檔要求和下面示例，依次完成請求參數(shù)與返回參數(shù)的填寫。
c) 獲取 access_token
利用上一個案例《獲取企業(yè)微信打卡數(shù)據(jù)》中AccessToken模板，添加一個WebAPI Reader表間公式。然后在工作臺新建一張表單，執(zhí)行表間公式，獲取access_token并保存。注意保密access_token，不要在前端任何地方顯示完整的access_token.
三、 獲取打卡數(shù)據(jù)：
a) 閱讀獲取釘釘打卡數(shù)據(jù)API文檔。
b) 在勤哲系統(tǒng)新建一個WebAPI, 參考API文檔填寫接口地址等。
c) 設(shè)置返回參數(shù)
這里，理論上可以直接從API文檔說明直接復(fù)制粘貼，但經(jīng)過實測，發(fā)現(xiàn)釘釘API文檔沒有及時更新，與實際返回數(shù)據(jù)稍有不同，建議先用第3方API測試工具例如Postman測試后，復(fù)制過來。
d) 新建用于提取釘釘打卡數(shù)據(jù)的模板
在勤哲系統(tǒng)，設(shè)計里面新建一個模板，提取釘釘打卡數(shù)據(jù)。開始時間與結(jié)束時間，與從企業(yè)微信提取打卡數(shù)據(jù)不同，這里的開始時間和結(jié)束時間不需要轉(zhuǎn)換為unix時間戳。但開始時間和結(jié)束時間之間的間隔不能超過7天。
e) 新建一個WebApiReader提數(shù)公式，從釘釘提取打卡數(shù)據(jù)。
四、 演示
五．總結(jié)
勤哲系統(tǒng)通過WebAPI與提供API的接口的系統(tǒng)安全高效地進行數(shù)據(jù)交換，不管對方是企業(yè)微信，是釘釘，還是其他有API接口的系統(tǒng)，操作過程都是類似的。先查閱對方API文檔說明，在勤哲系統(tǒng)創(chuàng)建WebAPI進行對接，最后在模板中通過表間公式執(zhí)行數(shù)據(jù)提取或回寫。
需要留意的是，考慮到數(shù)據(jù)量與效率問題，釘釘會對一些API每次返回的數(shù)據(jù)量進行控制，這樣用戶可能需要多次提取考勤打卡數(shù)據(jù)。例如，本例中引用的API，一次只能提取50個員工，50條記錄。釘釘關(guān)于考勤方面的API還有很多個，例如考勤月度總結(jié)， 其他方面例如OA審批等都可以按照上面步驟提取到勤哲系統(tǒng)。
歡迎大家嘗試，需要技術(shù)支持請聯(lián)系范工（15818855188）。
