Workiva 支援中心

使用 Oracle® Hyperion® Financial Management 連接器，您可以，在鏈中使用命令 與 Oracle Hyperion Financial Management (HFM) 版本 11.1.2.4.x 或 11.2.x 進行交互。例如，您可以创建一个链从 Oracle HFM 中提取数据作为文件上传到 Wdata 表 。

重要 ：雖然此連接器由 Workiva 建立以連線至 HFM 系統，但我們的支援團隊僅能在您的工作區內協助配置此連接器；我們無法排除故障或以其他方式協助處理任何源自 Workiva 平台之外的問題。

附註： 若要連接至 Oracle HFM 版本 9.3.1 至 11.1.2.3，使用 Oracle HFM Legacy 連接器 。

必要條件

要設定連線，您需要：

• 可存取/使用 Oracle HFM 的伺服器。
  它應已安裝整個 HFM 套件（包括 JDK、支援資產等）。
• 的安裝：
  • HFM 隨附的 Java 運行時。  截至 2026 年，這通常是 OracleJava Runtime Environment (JRE) 8 。此運行時間應安裝為系統層級 JRE。

  • 此運行時必須可以從命令列存取/使用。 
    您可以開啟終端機 (Linux) 或 Command Prompt/PowerShell (Windows) 並輸入java -version 來測試。回應應如下所示：（版本 1.8.x 是 JRE 8）

    java 版本 "1.8.0_481" Java(TM) SE Runtime Environment (build 1.8.0_481-b10) Java HotSpot(TM) 64 位伺服器虛擬機器 (build 25.481-b10, mixed mode)

    如果無法存取/使用，您需要調整您的 PATH 環境變數 。

    附註： 如果您嘗試使用其他 JVM，連接器可能無法正常運作；這是由於 Oracle HFM Java 檔案庫的一些傳統需求所致。

• 一個 GroundRunner 執行代理

  附註： 在託管 HFM 應用程式服務的 Enterprise Performance (EPM) 伺服器機器上安裝 GroundRunner。  當 GroundRunner 執行於與 Oracle HFM 實例不同的伺服器或網路時，Workiva 無法提供疑難排解支援。

• 到 Oracle Enterprise Performance (EPM) 系統實例及其HFM 主目錄的路徑。
• 在 EPM 共享服務註冊表中顯示的 HFM 伺服器群集名稱。

• Oracle HFM 整合使用者，用於驗證 Oracle HFM 實例。

  附註： 整合使用者必須是 Native Directory 使用者 - 而非 Microsoft® Active Directory® (MSAD) 使用者 - 並可存取報告和延伸分析所需的資料。仍然需要 MSAD 使用者，但其目的是與 GroundRunner 進行通訊。

• 在 Oracle HFM 和關係資料庫中執行任務的 GroundRunner。

  附註： 要啟用連線，GroundRunner 的整合使用者需要 HFM 主目錄的 Execute 權限。

若要在建立和建構鏈時獲得協助，我們也建議您確認： 您的 Workiva 管理員

• 您的 Workiva 管理員
• Oracle HFM 管理員
• 您的網路和基礎架構工程團隊

設定與 Oracle HFM 的連線

要建立連線，IT 管理員要設定伺服器，工作區擁有者要建立連線到 Oracle HFM。

步驟 1.配置服务器

1. 在 Oracle HFM 中，建立整合使用者，並授權他們存取報表和延伸分析。
2. 在可以存取 Oracle HFM 的伺服器上：

   • 安裝 HFM 隨附的 Java runtime(搭售)方案。這將是Java Runtime Environment 8 或更高版本。

     注意：安裝 Java 時，系統可能會詢問您是要安裝 Java Development Kit (JDK) 或 Java Runtime Environment (JRE)。僅需要 JRE。

   • 新增與 Oracle HFM 一併打包的 JVM 路徑 (通常是 JRE 的JAVA_HOME ，然後是bin 資料夾) 到系統PATH 。
   • 下載、安裝並啟動 GroundRunner 執行代理 。
   • 允許 Workiva 使用主機網域 。

步驟 2.設定 Oracle HFM 連接器

注意：為了使連接器可用於組織的鏈結，組織安全性管理員首先要從組態中啟用它。

1. 在「鏈結產生器」中，按一下「連線 」compare_arrows，然後按一下右上角的「建立」。
2. 在Connector Connection 下 ，選擇Oracle Hyperion Financial Management 和伺服器上安裝的 GroundRunner。
3. 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別連結。

4. 在「屬性」(Properties) 下，輸入連結的詳細資料：

   附註： 請向您的 Oracle HFM 管理員查詢正確的值。

   摘要資訊	詳細資料
   使用者名稱	輸入 Oracle HFM 整合使用者的使用者名稱。
   密碼	輸入 Oracle HFM 整合使用者的密碼。
   EPM home	輸入 Oracle EPM 系統 HFM home 目錄的路徑 。  預設為：C:/Oracle/Middleware/EPMSystem11R1 。
   EPM 實例	輸入 EPM 系統的路徑。  預設為：C:/Oracle/Middleware/user_projects/epmsystem1 。
   HFM 群集	輸入 Oracle HFM 伺服器的群集名稱，如其在 EPM Shared Services 登錄中所示。

   注意：所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。

5. 選擇工作區環境 與連接器一起使用，然後按一下儲存 。
6. 要測試連線，與Oracle HFM 連接器的Extract Members List 指令 建立並執行連線 ，並驗證它會傳回有效的輸出。

疑難排解

我可以在負載平衡的伺服器上使用 HFM 連接器嗎？

負載平衡是 HFM 內建的，不受 Chains 控制，但您可以在設定連接器時，在 ClusterName 欄位中輸入您的設定。

與 Oracle HFM 的連接失敗

確認要連線的 Oracle HFM 叢集名稱，以及 Oracle HFM 整合使用者的驗證憑證。

連接器返回空白輸出或無回應

為確保 GroundRunner 可以與 Oracle HFM JAR 檔案通訊，請驗證 HFM 主目錄和 EPM 範例的路徑。

連接器回傳 "insufficient permissions" 錯誤。

確認 Oracle HFM 整合使用者具有讀取和寫入存取權 - 而非僅限讀取。

注意： GroundRunner 所依賴的 MSAD 使用者，也必須有足夠的讀/寫存取權限，才能存取任何包含 Chains 將會與之互動的檔案的目錄。

命令返回成功的退出代碼，但沒有輸出

如果Clear slice、Copy data、Extract data to database ，或Extract data to file 命令成功，但沒有輸出，請驗證其 "Expand only" 屬性是否被選取。選擇「Expand only」檢視沒有擷取的會員，例如用於測試。

在多台伺服器上安裝時發生驗證錯誤

在日誌中尋找以下一行：

 INFO：無法找到檔案 reg.properties。

如果找到了，請從Oracle\Middleware\user_projects\config\foundation\11.1.2.0 複製reg.properties 檔案。

至

Oracle/Middleware\user_projects\epmsystem1\config\foundation\11.1.2.0.