下載 PDF
使用 OAuth 連接到 Workday
在 Workday 中,建立以下整合項目:
- 整合功能區域中的整合安全域。
- 整合系統用戶。
- 整合系統安全群組。
安全性:Peakon 中的管理員存取。
您可以將 Peakon 連接到 Workday 並使用 OAuth 驗證傳輸的資料。
我們建議您 使用 ISU 名稱和密碼連線到 Workday,設定起來更容易,不容易因外界因素而斷開連線。
- 在 Workday 中,存取編輯租用戶設定 - 安全任務。
- 選取「OAuth 2.0 用戶端已啟用」複選框。
- 仍在 Workday 中時,存取註冊 API 用戶端任務。
- 輸入客戶端名稱並選擇授權碼授予。
- 選擇Bearer作為存取權杖類型並輸入重定向 URL。重定向 URL 格式為https://companyname.peakon.com/workday/complete。您必須用companyname.peakon.com取代您的自訂子網域。
- 選取「永不過期的刷新令牌」複選框。
- 從範圍(功能區)提示中選擇這些功能區域:
- 聯絡資訊
- 執行
- 個人資料
- 公開數據
- 人員配備
- 系統
- 按一下“確定”。
- 收集租用戶、Web 服務主機、用戶端 ID、用戶端金鑰和授權主機值。Workday REST API Endpoint包含Webservice Host和Tenant。範例:端點為https://wd3-services1.myworkday.com/api/v1/tenant_name時,Webservice Host為wd3-services1.myworkday.com,Tenant為tenant_name。授權端點包含授權主機。範例:授權端點為https://wd3.myworkday.com/tenant_name/authorize時,授權主機為wd3.myworkday.com。Workday 會相應地標記客戶端 ID和客戶端金鑰。記下客戶端金鑰值,因為關閉此頁面後無法恢復它。發生斷開連接時需要它。
- 在隱身視窗中開啟 Peakon 以作為 Peakon 整合系統使用者 (ISU) 登入。當您的公司使用 SSO 登入 Workday 租用戶時,請使用此 URL 範本以 Peakon ISU 身分登入 Workday:(https://<workdayDomain>/wday/authgwy/<tenant>/login.htmld?redirect=n)。 <workdayDomain> 是您的 Workday 租用戶網域,<tenant> 是您的 Workday 租用戶名稱。透過無痕視窗登入可確保整合不會與 Workday 租用戶的錯誤憑證連接,進而導致同步問題。
- 在 Peakon 中,前往 。
- 從身份驗證模式提示中選擇OAuth。
- 在這些欄位中輸入步驟 9 中的值:
- 租用戶
- 網路服務主機
- 客戶端 ID
- 客戶機密 (Client Secret)
- 驗證主機
- 按一下“連接”。同步現已啟動並將自動運行。如果您需要防止這種情況發生,同時仍能繼續步驟 17 中的設置,請按一下「停用」。
- (可選)在登入頁面,以 ISU 身分登入。
- 按一下“允許”。
- 配置現在在 Peakon 上的 Workday 整合頁面上顯示的設定。某些選項需要額外的網域安全存取權限。 看 在安全性群組中設定網域以進行 Workday 集成。選項說明整合系統識別碼(可選)如果您需要建立欄位覆蓋來傳輸自訂欄位或使用PEAKON_INCLUDED功能,請填寫此欄位。組織 ID(可選)填寫此欄位可依組織依員工進行篩選。若要同步多個組織中的員工,請用一個空格分隔組織 ID。我們建議在按組織進行過濾時使用此功能而不是PEAKON_INCLUDED功能,因為:
- 以鏡像組織 ID欄位的方式配置PEAKON_INCLUDED功能很難正確實現,因此同步可能無法提供預期的結果。
- 它比PEAKON_INCLUDED功能運行得更快。
時區(可選)選擇此選項可同步本地員工時區。Peakon 將向當地時區的員工發送問卷。地區設定(可選)選擇此選項可同步本地員工語言。如果您組織的調查設定中啟用了這些語言,Peakon 將在員工調查通訊中使用同步的語言。電話號碼(可選)選擇此選項可顯示員工電話號碼同步選項。- 公司
- 住家
- 同步私人電話號碼
如果您想使用簡訊發送調查通知,同步電話號碼很有用。當您同時選擇工作和家庭號碼時,主要工作電話號碼優先。包括特定員工 - 根據 Workday 中設定的自訂標準(可選)選擇此選項僅同步某些員工群組。除了啟用此複選框之外,還要在欄位覆蓋服務中建立PEAKON_INCLUDED欄位覆蓋條目。來源覆蓋必須是一個布林計算字段,對於您希望包含的員工,該字段傳回True。包括特定員工 - 臨時工(可選)選擇此選項也可包含臨時工。按外部 ID 對應(僅當資料不包含重複段時)(可選)選擇此選項可在將屬性從 Workday 對應到 Peakon 時將外部 ID 與段進行配對。當您沒有重複的片段時,此功能可讓您使用更高級的屬性映射。Workday 將這些屬性的段外部 ID 對應到 Peakon:- 部門
- 就業類型
- 性別
- 工作族群
- 管理階層
- 離職原因
當屬性有欄位覆寫時,Workday 不會對應外部 ID。當 Workday 中的細分名稱發生變化時,Workday 不會在 Peakon 中建立新的細分。範例:在 Workday 中,當您將Benefits EMEA Region段的名稱變更為Benefits Global時,Peakon 會自動將現有的Benefits EMEA Region段名稱更新為Benefits Global。當片段包含重複名稱時,Peakon 不會為受影響的員工同步片段,而是顯示錯誤訊息
透過點選 中的
「同步全部」
執行完整同步。完成後,再次運行完整同步以獲取第一次可能錯過的任何剩餘工作者關係。例如:如果在同步員工時尚未建立經理,員工的經理可能不會出現在 Peakon 上。初始完全同步後,Peakon 將每小時逐步同步任何未來的更改,但也可以手動啟動完全同步。
您可以使用整合式稽核上的
「匯出至 CSV」
按鈕以 CSV 格式匯出最新的 5,000 個整合事件稽核日誌記錄。