跳至主要內容
Peakon
上次更新時間 :2024-09-06
下載 PDF
使用 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 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
    客戶端金鑰
    記下
    客戶端金鑰
    值,因為關閉此頁面後無法恢復它。發生斷開連接時需要它。
  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。
    我們建議在按組織進行過濾時使用此功能而不是
    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 個整合事件稽核日誌記錄。