Workiva 支援中心

使用 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.jar
  • ess_japi.jar
  • ess_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 連接器

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

1. 從Chains（自動化工作流程）建立器 ，按連線 compare_arrows ，然後按右上方的建立 。
2. 在Connector Connection 下 ，選取Oracle Essbase 和 GroundRunner 與連接器一起使用。
   
3. 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別連結。

4. 在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 加密方式儲存。

5. 選擇連接使用的環境，然後按一下儲存 。
6. 若要測試連線，，使用連接器的List Applications 指令 建立並執行連線 ，並驗證它是否傳回有效的輸出。

疑難排解

本節涵蓋 Oracle Essbase 連接器本身及其指令的潛在問題。

 在線程 "main「 中發現異常 [] false} stdErr=」java.lang.NoClassDefFoundError: com/essbase/api/base/EssException"

Error: com.essbase.api.base.EssException：無法連線至提供者伺服器

Error: com.essbase.api.base.EssException：無法連線至 olap 服務。無法連線至 Essbase 伺服器。Error:Essbase Error(1042003)：網路錯誤 [11001]：Failed to retrieve name information for [Essbase-Cluster1] Error authenticating with Essbase：無法連線至 olap 服務。無法連線至 Essbase 伺服器。Error:Essbase Error(1042003)：網路錯誤 [11001]：無法檢索 [Essbase-Cluster1] 的名稱資訊

無法建立 olap 檔案物件。Essbase 錯誤(1030014)：傳送到 ESSAPI 函式的物件類型無效