使用 Oracle® Essbase® 連接器,您可以在連鎖中使用命令 與 Oracle Essbase 進行交互。例如,使用此連接器,您可以
- 在 Oracle Essbase 中執行計算、MaxL 和報表指令碼
- 列出和管理 Essbase 資料庫、應用程式和變數
- 在 Oracle Essbase 中上傳、下載及刪除檔案
註: 此連接器由 Workiva 建立並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器,但我們無法排除故障或協助解決任何源自 Workiva 平台以外的問題。
必要條件
為了啟用連線,連接器使用 Oracle Essbase Java® API,透過基本的使用者名稱和密碼認證來確保安全性。要設定連線,您需要:
- 為連接器設定指定的 GroundRunner
- 在 Oracle Essbase 中為連接器設定的指定整合使用者
- 整合使用者的驗證憑證
- 整合使用者必須具有適用於連接器執行指令的權限。
- 要連接的 Essbase 實例的基本 URL
- 要連接的 Essbase 集群名稱
- 這些 Essbase 用戶端 Java 存檔 (JAR) 檔案的路徑:
ess_es_server.jaress_japi.jaress_maxl.jar
- Essbase 實例是否已啟用嵌入式模式
相容性聲明: Workiva 已針對 11.1.2.2.x、11.1.2.3、11.1.2.4 及 11.2 版本測試及驗證此連接器。Workiva 不保證此連接器在未測試過的版本下能如預期般運作。
找到 Essbase 用戶端 JAR 檔案
要啟用連接,連接器需要用戶端 JAR 檔案,這些檔案位於 Oracle Essbase 安裝中。
- Microsoft® Windows® 的預設路徑:
C:\Oracle\Middleware\EPMSystem11R1\common\EssbaseJavaAPI\<version_#>\lib - Linux 的預設路徑:
/User/username/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/<version_#>/lib
如果 GroundRunner 和 Oracle Essbase 安裝在不同的伺服器上,請將 JAR 檔案複製到 GroundRunner 伺服器上的資料夾,並註記連接器的Java API Path 屬性的資料夾路徑。
設定 Oracle Essbase 連接器
注意:為了使連接器可用於組織的鏈結,組織安全性管理員首先要從組態中啟用它。
- 從Chains(自動化工作流程)建立器 ,按連線 ,然後按右上方的建立 。
- 在Connector Connection 下 ,選取Oracle Essbase 和 GroundRunner 與連接器一起使用。
- 在「基本資訊」(Basic Info) 下,輸入唯一的名稱和描述以識別連結。
-
在Properties 下 ,輸入連接器的詳細資訊:
摘要資訊 詳細資料 使用者名稱 輸入連接器的 Essbase 整合使用者的使用者名稱。 密碼 輸入使用者名稱 屬性的密碼。 實例 URL 輸入要連接的 Essbase 實例的基本 URL,包括前導通訊協定;通常是 IP 位址,如 http://100.0.0.1。群集名稱 輸入要連接的 Essbase 集群;預設為 EssbaseCluster。Java API 路徑 輸入 Essbase 實例用戶端 JAR 檔案的路徑:
- 如果 GroundRunner 和 Essbase 安裝在 相同的伺服器上 ,請在 Essbase 安裝中輸入 JAR 檔案的路徑。
- 如果 GroundRunner 和 Essbase 安裝在不同的伺服器上 ,請輸入 GroundRunner 伺服器上包含 JAR 檔案複本的資料夾路由。
已啟用嵌入式模式 如果 Essbase 实例已启用嵌入式模式,请选中此复选框。
(獨立的 Oracle Hyperion® 環境通常已啟用 Embedded Mode)。
注意:所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。
- 選擇連接使用的環境,然後按一下儲存 。
- 若要測試連線,,使用連接器的List Applications 指令 建立並執行連線 ,並驗證它是否傳回有效的輸出。
疑難排解
本節涵蓋 Oracle Essbase 連接器本身及其指令的潛在問題。
如果與 Oracle Essbase 的連接失敗:
- 驗證 Essbase 整合使用者的驗證憑證。
- 檢查連接器所選的 GroundRunner。
- 檢查要連接的 Essbase 實例的基本 URL。
- 檢查要連接的 Essbase 集群名稱。
- 檢查 Essbase 客戶端 JAR 檔案的路徑。如果 GroundRunner 安裝在與 Essbase 實例不同的伺服器上,請確保將 JAR 檔案複製到 GroundRunner 的伺服器上,並將複本的路徑輸入為連線器的Java API Path 屬性。
- 檢查上傳檔案的副檔名