使用 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 檔案庫的一些傳統需求所致。
-
附註: 在託管 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.配置服务器
- 在 Oracle HFM 中,建立整合使用者,並授權他們存取報表和延伸分析。
- 在可以存取 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 連接器
注意:為了使連接器可用於組織的鏈結,組織安全性管理員首先要從組態中啟用它。
- 在「鏈結產生器」中,按一下「連線 compare_arrows,然後按一下右上角的「建立」。
- 在Connector Connection 下 ,選擇Oracle Hyperion Financial Management 和伺服器上安裝的 GroundRunner。
- 在「基本資訊」(Basic Info) 下,輸入唯一的名稱和描述以識別連結。
-
在「屬性」(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 加密方式儲存。
- 選擇工作區環境 與連接器一起使用,然後按一下儲存 。
- 要測試連線,與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.