跳至主要內容
Peakon
上次更新時間 :2025-05-16
使用 OAuth 連接到 Workday

使用 OAuth 連接到 Workday

在 Workday 中建立以下整合項目:
  • 整合功能領域的
    整合安全
    域。
  • 整合系統用戶。
  • 整合系統安全群組。
安全性:Peakon 中的管理員存取權限。
您可以將 Peakon 連接到 Workday,並使用 OAuth 對傳輸的資料進行身份驗證。
我們建議您 使用 ISU 使用者名稱和密碼連線到 Workday這樣更容易設置,而且不太容易因外部因素而斷開連接。
  1. 在 Workday 中,存取
    「編輯租用戶設定 - 安全性」
    任務。
  2. 選取
    「啟用 OAuth 2.0 用戶端」
    複選框。
  3. 在 Workday 中,存取
    「註冊 API 用戶端」
    任務。
  4. 輸入
    客戶端名稱
    並選擇
    授權碼授予
  5. 選擇
    Bearer
    作為
    存取權杖類型
    ,並輸入
    重定向 URL
    重定向 URL 格式為
    https://companyname.peakon.com/workday/complete
    。您必須將
    companyname.peakon.com
    替換為您的自訂子網域。
  6. 選取
    「永不過期的刷新令牌」
    複選框。
  7. 請從
    「範圍(功能領域)」
    提示中選​​擇以下功能領域:
    • 聯絡資訊
    • 執行
    • 個人資料
    • 公開數據
    • 人員配備
    • 系統
  8. 點選
    確定
  9. 收集
    租用戶
    Web服務主機
    用戶端ID
    用戶端金鑰
    驗證主機的
    值。
    Workday REST API 端點
    包含
    Web 服務主機
    租用戶
    。例如:端點為
    https://wd3-services1.myworkday.com/api/v1/tenant_name
    時,
    Web 服務主機
    wd3-services1.myworkday.com
    租用戶
    tenant_name
    授權端點
    包含
    授權主機
    。例如:授權端點為
    https://wd3.myworkday.com/tenant_name/authorize
    時,
    授權主機
    wd3.myworkday.com
    Workday會相應地標記
    客戶端ID
    客戶端金鑰
    請記下
    客戶端金鑰
    的值,因為關閉此頁面後將無法恢復該值。斷線時需要用到。
  10. 在隱身視窗中開啟 Peakon,以 Peakon 整合系統使用者 (ISU) 登入。
    當您的公司使用 SSO 登入 Workday 租用戶時,請使用下列 URL 範本以 Peakon ISU 身分登入 Workday:(https://<workdayDomain>/wday/authgwy/<tenant>/login.htmld?redirect=n)。 <workdayDomain> 是您的 Workday 租用戶域名,<tenant> 是您的 Workday 租用戶名稱。
    透過無痕視窗登入可確保整合不會使用錯誤的 Workday 租用戶憑證進行連接,從而避免同步問題。
  11. 在 Peakon 中,前往
    「管理
    整合
    Workday」
  12. 身份驗證模式
    提示中選擇
    OAuth
  13. 將步驟 9 中的值輸入到以下欄位:
    • 租用戶
    • 網路服務主機
    • 客戶ID
    • 客戶機密 (Client Secret)
    • 驗證主機
  14. 點選
    “連接”
    同步操作已啟動,並將自動運作。如果您需要防止這種情況發生,同時仍能在步驟 17 中繼續進行設置,請按一下
    「停用」
  15. (可選)在登入頁面上,以 ISU 登入。
  16. 點選
    “允許”
  17. 配置 Peakon 上 Workday 整合頁面上目前顯示的設定。
    部分選項需要額外的網域安全存取權限。 看 在安全性群組中設定網域以進行 Workday 集成
    選項
    說明
    整合系統識別碼
    (可選)如果您需要建立欄位覆蓋以傳輸自訂欄位或使用
    PEAKON_INCLUDED
    功能,請填寫此欄位。
    組織 ID
    (可選)填寫此欄位可依組織篩選員工。若要同步多個組織中的員工,請用一個空格分隔組織 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 不會同步受影響員工的段落,而是顯示錯誤訊息。
Workday 的
管理
整合
中,按一下
「全部同步」
執行完整同步。
首次完全同步後,Peakon 將每小時逐步同步任何未來的更改,但也可以手動啟動完全同步。
您可以使用整合審核中的
「匯出至 CSV」
按鈕,以 CSV 格式匯出最新的 5,000 條整合事件審核日誌記錄。