跳至主要內容
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 個整合事件稽核日誌記錄。