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 文件

要启用连接，连接器需要位于 Oracle Essbase 安装目录中的客户端 JAR 文件。

• 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. 从 链构建器中，单击 连接比较箭头，然后单击右上角的 创建 。
2. 在 连接器连接下，选择 Oracle Essbase和要与连接器一起使用的 GroundRunner。
   
3. 在 基本信息下，输入一个唯一的名称和描述，以帮助识别连接。

4. 在 属性下，输入连接器的详细信息：
   

   摘要信息	详细信息
   用户名	输入连接器的 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®环境通常启用嵌入式模式。）

   注意：所有敏感凭证均会自动加密，并以高级加密标准 (AES ) -256 加密方式存储

   。
5. 选择要与连接一起使用的环境，然后单击 保存。
6. 要测试连接， 创建并运行一个链 使用 连接器的 列出应用程序命令，并验证它是否返回有效输出。

疑难解答

本节涵盖 Oracle Essbase 连接器本身及其命令可能存在的问题。

 线程“main”中出现异常 [] false} stdErr="java.lang.NoClassDefFoundError: com/essbase/api/base/EssException"

错误：com.essbase.api.base.EssException：无法连接到提供程序服务器

错误：com.essbase.api.base.EssException：无法连接到 olap 服务。无法连接到 Essbase 服务器。错误：Essbase 错误(1042003): 网络错误 [11001]: 无法检索 [Essbase-Cluster1] 的名称信息。与 Essbase 进行身份验证时出错：无法连接到 olap 服务。无法连接到 Essbase 服务器。错误：Essbase 错误(1042003): 网络错误 [11001]: 无法检索 [Essbase-Cluster1] 的名称信息

无法创建olap文件对象。Essbase 错误 (1030014): 传递给 ESSAPI 函数的对象类型无效