附註: 此 Workiva 開發的連接器可讓您連接 Workiva 和 Workday 平台。Workiva 支援團隊很樂意指導您在工作區內配置連接器。然而,任何 Workday 平台內的錯誤或疑難排解都必須由您的 Workday 管理員或其支援團隊處理。
使用 Workday 連接器,您可以在鏈結中使用命令 與 Workday® HR 和 Financials 進行交互,以: 獲取 Workday 租戶資訊:
- 從 Workday 下載自訂報表
- 將預算資料匯入 Workday
- 啟動 Workday Enterprise Interface Builder (EIB) 整合
需求
要設定連線,您需要:
- 要連接/串連的 Workday 租戶。
- 要連接的 Workday 環境的主機和網域。
- 在 Workday 中建立的整合系統使用者的驗證認證。
步驟 1:獲取 Workday 租用戶資訊
您可以從 Workday公共網路服務 WSDL XML 檔案中確定租戶、主機和網域資訊。
- 在 Workday 的搜尋長條圖中輸入「Public Web Services」,然後選取該報告。
- 尋找您正在使用的特定整合的 Web 服務。
範例包括:GetWorker 的人員編制、匯入預算的財務管理、EIB 相關命令的整合…… - 按一下該服務的「相關動作」按鈕,然後按一下「Web 服務」選單下的 檢視 WSDL 。
- 在 XML 檔案中,找到
soapbind:address元素(這個元素通常靠近檔案底部)。 - 使用
位置屬性中的 URL,從 URL 中擷取租用戶、主機和網域資訊。
URL 使用以下格式:https://{主機}。{domain}/ccx/service/{租用戶}/public_web_service_name/version_number
範例
使用上述格式,我們可以從範例 WSDL URL 中找到租用戶、主機和網域:https://wd2-impl-services1.workday.com/ccx/service/mycompany/Financial_Management/v45.1
| 摘要資訊 | 樣本值 |
|---|---|
| 租用戶 | mycompany |
| 寄存 | wd2-impl-services1 |
| 網域 | workday.com |
在下一步中設定連接器時,您將需要這些值。
第 2 步:設定 Workday 驗證
此連接器提供兩種驗證方式:透過 API 的 OAuth2 和使用者 + 密碼。
OAuth2 API 驗證
如果您使用 OAuth2 API 驗證,則必須在 Workday 中設定 API 用戶端。有關建立 API 用戶端的說明,請參閱 Workday 支援頁面 註冊 API 用戶端 。
作為此 API 用戶端設定的一部分,請確保您已:
- 已選取 持有者 作為 存取權杖類型。
- 啟用(標示)以下核取方塊:
- 不會過期的重新整理權杖
- 包括 Workday 擁有的範圍
重新導向 URL
Workiva 有針對連接器配置的區域特定連線覆寫 URL。使用下表為您的位置選取正確的 URL。
如果您位於北美、中美或南美,請使用預設 URL。如果您位於亞太地區,請使用亞太地區 URL。如果您位於 EMEA,請使用 EU URL。
| 環境 | 重新導向 URL |
|---|---|
| 亞太地區產品 | https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback |
| 歐盟產品 | https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback |
| 美國產品 | https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback |
OAuth2 端點
如果您使用 OAuth2 驗證連線,則您需要以下端點值。當您在 Workday 的 編輯 API 用戶端 頁面上設定 Workday API 用戶端時,系統會列出這些項目。
| 端點 | 樣本值 |
|---|---|
| Workday REST 端點 | https://xxxx.workday.com/ccx/api/v1/xxxx |
| Workday OAuth2 權杖端點 | https://xxxx.workday.com/ccx/oauth2/xxxx/token |
| Workday OAuth2 授權端點 | https://xxxx.workday.com/xxxx/authorize |
提示: 如果您在使用 OAuth2 權杖和密碼的現有 API 用戶端執行個體,則可以在 Workday 檢視 API 頁面的頂部看到此資訊。
基本驗證
如果您使用的是 基本驗證,請參閱 Workday 支援頁面在 Workday 中建立整合系統使用者 (ISU) 帳戶 ,以了解有關建立整合系統使用者 (ISU) 的說明。
第 3 步:設定 Workday 連接器
注意: 為了使連接器可用於組織的鏈結, 組織安全性管理員必須首先從設定啟用它。
- 從 Chain Builder中按一下 Connections,然後按一下右上角的 Create 。
- 在 Connector Connection下,選取 Workday Connector 和預設的 CloudRunner。
- 在「基本資訊」(Basic Info) 下,輸入唯一的名稱和描述以識別連結。
-
在屬性 ,輸入連線的詳細資訊。
如果您使用 OAuth2,則需要輸入 Workday REST Endpoint、 Workday OAuth2 Token Endpoint和 Workday OAuth2 Authorization Endpoint的值。
如果您使用 基本驗證 (使用者名稱+密碼),請將這些保留空白。欄位 內容 租用戶 要連接/串連的 Workday 租戶。 寄存 要連線的 Workday 環境主機。在環境的 URL 中, 網域 屬性之前的字元代表主機。 網域 要連線的 Workday 環境網域,
例如workday.com或myworkday.com。Workday REST 端點 Workday 提供的 REST 端點 URL。
(僅限使用 OAuth2 驗證時。)Workday OAuth2 權杖端點 Workday 提供的 OAuth2 權杖端點 URL。
(僅限使用 OAuth2 驗證時。)Workday OAuth2 授權端點 Workday 提供的 OAuth2 端點 URL。
(僅限使用 OAuth2 驗證時。)
疑難排解
如果與 Workday 的連線失敗:
- 驗證整合系統使用者的驗證憑證是否正確。
- 確認整合系統使用者俱有適當的權限,可以存取與連線命令相關的功能群組和網域。
- 驗證為連接器輸入的 Workday 租客、主機和網域是否正確。
- 當執行Download custom report 命令時,請確保報告類型設定為Advanced 。綜合報表目前無法透過 Workday API 使用。