SDK 結構

SDK 採用靜態類別 (static) 提供相關的方法 (method),可以讓開發人員快速的呼叫使用,其結構範例如下:

📜 UofxService
|  ├ [屬性] UofxServerUrl : 站台網址
|  ├ [屬性] Key : 金鑰
|  └─ 📜 BASE : 人員組織模組
|    └─ 📜 Department : 部門模組
|      ├ Create : 新增部門方法
|      ├ Update : 更新部門方法
|      ├ Delete : 刪除部門方法
|      └─ ...

從最上層的根節點 UofxService 開始,此處提供兩個 必填 的屬性設定,分別是站台網址以及金鑰,再往下展開其他模組 (例: BASE、BPM) 與其內部的子模組 (例: Department) ,每個模組或子模組皆以 非同步 的方式提供相關的方法,用來跟 UOF X 互動。簡單的程式碼範例如下:

//設定金鑰
UofxService.Key = "xxx";
//設定 UOF X 站台網址
UofxService.UofxServerUrl = "https://myuofx.com.tw";

//呼叫建立部門
await UofxService.BASE.Department.Create(...);

當呼叫 UofxService.BASE.Department.Create 建立部門後,SDK 會接手後面的金鑰驗證、API 呼叫、加密傳輸、以及錯誤處理等邏輯。

加密傳輸

SDK 與 UOF X 傳輸過程中的資料均會使用 RSA + AES 混和加密進行傳輸

站台網址

輸入站台網址請勿包含公司代碼,例如公司代碼為 ede,則請勿輸入 https://myuofx.com.tw/ede,正確應輸入 https://myuofx.com.tw