前身為 Adaptive Insights 的 Workday Adaptive Planning Connector在鏈中使用命令 來匯入或匯出資料或元資料。
附註: 此連接器由 Workiva 建立,並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器,但我們無法排除故障或以其他方式協助解決源自 Workiva 平台之外的任何問題。
要求
要啟用連接,該連接器使用 Workday Adaptive Planning REST API。要設定連接器,您需要
- 在 Adaptive Planning 中設定的整合使用者,該使用者已被指派具有適當權限的角色,以執行連接器的指令。
- 整合使用者的使用者名稱和密碼。
- 如果整合使用者可以存取 Adaptive Planning 的多個實體,他們將連線到的實體代碼。
注意: 要確定整合使用者的可用實例代碼,您可以使用 Adaptive Planning
exportInstancesAPI 端點。
設定 Workday Adaptive Planning 連接器
注意:為了使連接器可用於組織的鏈結,組織安全性管理員首先要從組態中啟用它。
- 在「鏈結產生器」中,按一下「連線 compare_arrows,然後按一下右上角的「建立」。
- 在Connector Connection 下 ,選取Workday Adaptive Planning 和預設 CloudRunner。
Workiva 提供兩種驗證方法 (Basic 與 JWT Bearer Grant (Workday Credentials))。您可以在連線組態中的Credentials 下選取要使用的一種。
使用基本驗證進行驗證
- 在屬性 下 ,選用輸入適應性規劃實例的實例代碼。
- 選取「基本憑證」作為驗證型別。
- 輸入下列值:
Username: 連接器使用的整合使用者名稱。
密碼: 使用者名稱欄位中提供者的密碼。
使用 JWT 承載者授與進行驗證 (Workday 認證)
此驗證方法使用 Workday 認證與 Adaptive Planning 進行驗證,並要求: 已啟用 SSO:
- 單一登入已啟用。
- 已啟用 Adaptive Planning User Sign-on 和 Public APIs 的 Workday 租戶設定。
- 在 Workday 和 Adaptive Planning 之間對應了 Public API ISU。
有關此項設定的具體細節,請參考以下 Workday 文件 (資料):
作為此組態配置的一部分,x509 私密金鑰必須上傳到此連線的Connection Resources 部分,由此金鑰建立的公用金鑰必須上傳到 Workday,並與「JWT Bearer Grant」型 API 用戶端相關聯。此用戶端又必須與您用於向 Adaptive Planning 請求的 ISU 相關聯,並在兩個系統之間對應憑證。
有關此項設定的具體細節,請參考以下 Workday 說明文件 (資料):註冊 API 用戶端。
資料鍵/金鑰詳情
支援的私密金鑰格式設定為 PKCS#8,可以是密碼保護或非密碼保護。使用 openssl 可以用以下命令建立新的資料鍵/金鑰: openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650:
openssl req -x509 \ -newkey rsa:2048 \ -keyout key.pem \ -out cert.pem -days 3650
確定 Workday 主機、網域和租戶
使用 API Client 下列出的 Workday REST API 端點,識別主機、網域和租戶,其格式設定為https://{host}.{domain}/ccx/api/v1/{tenant}
範例
https://wd2-impl-services1.workday.com/ccx/api/v1/mycompany
| 摘要資訊 | 值 |
| 租用戶 | mycompany |
| 寄存 | wd2-impl-services1 |
| 網域 | workday.com |
在 Adaptive Planning 連接器中設定承載憑證類型
- 上傳您的私人密碼匙到連線的資源部分。
- 選取「承載者」驗證型別。
- 輸入下列資訊:
摘要資訊 詳細資料 x509 資料鍵/金鑰 輸入上傳私人密碼匙的名稱,與連線資源中顯示的完全相同。 密碼 輸入私人密碼匙的密碼。如果您的資料鍵/金鑰不受密碼保護,請留空此欄位。 用戶端 ID 輸入 JWT Bearer Grant API 用戶端的用戶端 ID。 整合服務使用者 輸入與 API Client 相關聯的整合服務使用者 (ISU) 名稱 寄存 輸入要連接的 Workday 環境的主機。在環境的 URL 中,Domain 屬性前的字元代表主機。 租用戶 輸入要連線至的 Workday 租戶。 網域 輸入要連接的 Workday 環境的網域,例如workday.com 或myworkday.com 。
設定認證後:
- 請選取要使用連結的環境,然後按一下「儲存」(Save)。
- 要測試連線,建立並執行連接器的Export Versions 命令 的鏈結 ,並驗證它是否匯出有效輸出。
疑難排解
如果與 Workday Adaptive Planning 的連接失敗:
- 驗證整合使用者的驗證憑證。
- 確保整合使用者的角色對於連接器執行的指令有適當的權限。
- 如果整合使用者可以存取 Adaptive Planning 的多個實體,請檢查為連接器輸入的實體代碼。
有關使用 Workday 認證進行 Adaptive Planning API 請求的其他資訊,請參閱此 Workday 頁面:使用 Workday 認證進行 Adaptive Planning API 請求者。