OneStream 與 Workiva 的整合 使組織能夠自動擷取、轉換並從 OneStream Cloud 傳送至 Workiva 平台。此整合可以透過 Workiva 鏈結和 HTTP 連接器使用 ] 以 API 為基礎的直接連線 來實作，也可以使用 OneStream 智慧整合連接器 (SIC) 以 檔案為基礎的 SFTP 工作流程 來實作。
這兩種整合方法都支援將資料擷取至 Workiva，以便進行下游串連報告流程。
API 整合
API 連線需求
- OneStream 雲端環境： 僅當 OneStream 託管在可公開存取的雲端環境中時，才支援 API 整合方式。
- 專用服務帳戶： 為了安全性、稽核和操作穩定性，請在 OneStream 內專門為整合建立一個專用的非互動式服務帳戶。
- 最低要求權限： 僅指派服務帳戶存取相關立方體視圖和相關資料所需的權限。
- 個人存取權杖 (PAT)： 使用服務帳戶憑證產生一個 PAT，並在建立後立即安全地儲存權杖，因為之後可能無法擷取它。
- 網路和防火牆存取： 確保 Workiva 的靜態 IP 位址 已列入允許清單，以允許與 OneStream API 端點的出站 HTTPS（連接埠 443）通訊。
設定 API 整合
API 整合利用 GetCubeView 或 GetAdoDataSetForCubeViewCommand 端點從 OneStream 擷取 Cube View 資料。
Workiva 鏈結可以針對 OneStream 進行身份驗證、執行 API 要求、轉換傳回的 JSON 有效負載，並將結果資料集載入 Wdata 表格以進行報告和下游處理。
Workiva 設定步驟
- 安全地儲存 PAT： 在 Chain Builder 中建立一個 工作區變數 （例如
onestream_api_pat），並將該變數標記為 Secret ，以加密值並防止未經授權的可見性。 - 啟用所需的連接器： 驗證是否已在 Workiva 環境中啟用並正確配置 HTTP 連接器、JSON 轉換連接器和表格轉換連接器。
- 建立目的地 Wdata 表格： 從 OneStream 將範例 Cube View 匯出為 CSV 檔案，並將其作為 Wdata 表格結構描述的範本。記錄表格 ID 以在鏈結組態中使用。
- 轉換和對應資料： 如有需要，將 JSON 回應 轉換為表格格式，然後將 OneStream 欄位名稱對應至對應的 Workiva 表格欄位和資料類型。
- 配置鏈自動化： 配置鏈的觸發機制以控制它何時執行，選項包括按定義的 時間表運行，按需（手動執行），作為 更大的協調工作流程[] 中的一個步驟 ，或由 控制工作表觸發。
必要 API 參數
| 參數 | 必要的 | 說明 |
| BaseWebServerUrl | 是 | OneStream 應用程式伺服器的基準 URL。 |
| ApplicationName | 是 | 包含 Cube View 的 OneStream 應用程式的名稱。 |
| CubeViewName | 是 | 用於擷取資料集的 Cube 檢視。 |
| CubeName | 是 | Cube 檢視所使用的關聯 Cube 名稱。 |
SFTP 整合
在基於 SFTP 的整合中，OneStream 使用智慧型整合連接器將資料檔案 (通常為 CSV 格式) 匯出到中間 SFTP 位置。然後，Workiva 鏈結使用 SFTP 連接器擷取檔案、處理資料，並將其載入 Wdata 表格。
此方法通常在無法直接 API 存取或偏好不建立或使用 CubeView 的組織中使用。
| 客戶 IT / 財務團隊職責 | 實施合作夥伴職責 |
|
|