如要將 Workday 執行個體的資料複製到支援的目的地 (例如 BigQuery 或 Cloud Storage),可以將 Workday 連結為 Datastream 來源。如要驗證連線,請建立整合系統使用者 (ISU)、授予安全性群組權限,並註冊 OAuth 2.0 的 API 用戶端。
事前準備
開始設定 Workday 以搭配 Datastream 使用之前,您必須:
- 可存取有效的 Workday 執行個體。
- 瞭解如何在 Workday 中瀏覽及變更設定。
- 瞭解如何在 Workday 中建立整合系統使用者和安全性群組。
設定要與 Datastream 搭配使用的 Workday 執行個體
如要在 Workday 執行個體和 Datastream 之間建立連線,您必須在建立 Workday 連線設定檔時,提供執行個體的主機名稱和租戶名稱,以及 OAuth 2.0 用戶端憑證,例如用戶端 ID、用戶端密鑰和更新權杖。
找出主機名稱和租用戶名稱
您可以透過下列任一方式,找出 Workday 執行個體的主機名稱和租戶名稱:
- 使用登入網址。主機名稱和租戶名稱是您用來登入 Workday 的執行個體網址的一部分。舉例來說,如果登入網址是
https://wd5-impl.workday.com/google/d/home.html,則wd5-impl.workday.com部分是主機名稱,而網址中緊接在主機名稱後方的執行個體簡稱或別名,就是租用戶名稱 (在本例中為google)。 使用已註冊的 API 用戶端詳細資料。如果您已註冊 API 用戶端,可以直接從 REST 端點網址擷取這項資訊:
- 在 Workday 中,搜尋並選取「View API 用戶端」工作。
- 在「Client Details」(用戶端詳細資料) 下方,找到「Workday REST API Endpoint」(Workday REST API 端點) 欄位,例如:
https://wd2-impl-services1.workday.com/ccx/api/v1/mytenant。 尋找憑證:
- 主機名稱是網址的網域部分,例如
wd2-impl-services1.workday.com。 - 用戶群名稱是網址中
/v1/後方的最後一個路徑區段 (例如mytenant)。
- 主機名稱是網址的網域部分,例如
如要進一步瞭解如何尋找 API 端點,請參閱 Workday API 說明文件。
設定使用者和安全性群組
如要從 Workday 串流資料,您必須設定專屬的整合系統使用者 (ISU),並指派給不受限制的安全群組,然後授予該群組必要的網域權限。
建立整合系統使用者 (ISU)
- 在 Workday 搜尋列中,搜尋並選取「Create Integration System User」工作。
設定 ISU 帳戶:
- 輸入使用者名稱,例如
datastream_isu。 - 設定高強度密碼。
- 在「Session Timeout Minutes」欄位中輸入
0(不逾時)。 - 取消勾選「Do Not Allow UI Sessions」核取方塊。
- 輸入使用者名稱,例如
依序點選「確定」和「完成」。
建立整合系統安全性群組
- 搜尋並選取「Create Security Group」工作。
設定安全性群組選項:
- 從「Type of Tenanted Security Group」下拉式選單中,選取「Integration System Security Group (Unconstrained)」。
- 在「Name」(名稱) 欄位中,輸入安全性群組的名稱,例如
datastream_sg。
按一下 [確定]。
在接下來的頁面中,搜尋並選取您在上一個步驟中建立的 ISU,該 ISU 位於「Integration System Users」(整合系統使用者) 欄位中。
按一下 [確定]。
授予網域安全性政策權限
為確保完整涵蓋標準資料網域,您必須為必要的 Workday 網域授予安全性群組「Get Only」權限:
- 在安全性群組的詳細資料頁面中,按一下安全性群組名稱旁的「Related Actions」(相關動作) 省略符號圖示
(...)。 - 依序前往「Security Group」(安全性群組) >「Maintain Domain Permissions for Security Group」(維護安全性群組的網域權限)。
在「Domain Security Policy Permissions」(網域安全性政策權限) 表格下方,新增下列網域:
Worker Data: Public Worker ReportsWorkday Usage MetricsManage: Organization IntegrationWorker Data: All PositionsJob Requisition DataManage: Evergreen RequisitionsSpecial OX Web ServicesProspectsCandidate Data: Job ApplicationWorker Data: Skills and ExperiencePayroll InterfaceJob InformationStaffing Organizations: HeaderStaffing Organizations: CompanyStaffing Organizations: RegionStaffing Organizations: Business UnitStaffing Organizations: Custom Organization
針對每個新增的網域,勾選「Get Only」(僅限取得) 存取權欄中的核取方塊。
依序點選「確定」和「完成」。
不對 ISU 套用密碼到期設定
為避免密碼過期導致串流中斷,請將 ISU 排除在租戶的標準密碼到期規則之外:
- 搜尋並選取「Maintain Password Rules」工作。
- 在「System Users exempt from password expiration」(不受密碼到期限制的系統使用者) 欄位中,新增您建立的 ISU。
- 依序點選「確定」和「完成」。
啟用安全性政策變更
請務必明確啟用網域權限變更,否則變更不會生效:
- 搜尋並選取「Activate Pending Security Policy Changes」工作。
- 在「Comment」(註解) 欄位中輸入變更說明,例如
Grant permissions for Datastream Workday integration。 - 按一下 [確定]。
- 在確認頁面上,勾選「確認」核取方塊。
- 按一下「確定」,讓變更生效。
建立及設定 API 用戶端
在 Workday 中執行下列工作,產生 Datastream 連線設定檔所需的憑證。
註冊 API 用戶端
- 在 Workday 搜尋列中,搜尋並選取「Register API 用戶端 for Integrations」工作。
設定 API 用戶端:
- 輸入 Datastream 整合項目的名稱。
- 在「用戶端授權類型」下方,選取「授權碼授權」。
- 在「存取權杖類型」下方,選取「Bearer」。
- 勾選「Enforce Customized Access Token Expiry」(強制執行自訂存取權杖到期時間) 核取方塊,然後指定您選擇的到期時間。
視需要勾選「Non-expiring refresh tokens」(不會過期的更新權杖) 核取方塊,避免連線中斷。
在「Scopes」(範圍) 下方,建議您加入下列功能區域,確保完整涵蓋標準資料網域:
ImplementationJobs & PositionsOrganizations and RolesPayroll InterfacePre-Hire ProcessRecruitingStaffingSystemTalent Pipeline
所需範圍取決於要串流資料的端點。
勾選「Include Workday owned scope」核取方塊。
按一下 [確定]。
複製並儲存產生的用戶端 ID 和用戶端密鑰。您需要這些憑證,才能建立 Datastream 連線設定檔。
管理整合項目的更新權杖
- 註冊用戶端後,按一下用戶端名稱旁的刪節號圖示
(...),然後選取「Manage Refresh Tokens for Integrations」(管理整合項目的更新權杖)。 - 選取先前建立的整合系統使用者 (ISU)。
按一下「產生新的更新權杖」。
編輯 API 用戶端安全性群組
- 為確保 ISU 可使用 API 用戶端,請搜尋「Edit API Client」(編輯 API 用戶端) 工作。
- 選取已註冊的用戶端,然後前往安全性設定。
- 將與 ISU 相關聯的整合系統安全性群組,新增至這個用戶端的允許安全性群組清單。
查看 API 用戶端
- 如要擷取用戶端 ID 和用戶端密鑰,請搜尋「View API Client」(查看 API 用戶端) 工作,或前往 API 用戶端詳細資料頁面。
- 在「Client Details」下方,找出並複製「Client ID」。
- 按一下「Manage Consumer Details」,查看並複製「用戶端密鑰」。
後續步驟
- 進一步瞭解 Workday 來源。