借助 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 年，这通常是 Oracle Java 运行时环境 (JRE) 8。该运行时环境应作为系统级 JRE 安装。
-
此运行时 必须 可从命令行访问。
您可以通过打开终端（Linux）或命令提示符/PowerShell（Windows）并输入java -version来测试这一点。响应应该类似于这样：（版本 1.8.x 对应 JRE 8）java 版本“1.8.0_481” Java(TM) SE 运行时环境（内部版本 1.8.0_481-b10） Java HotSpot(TM) 64 位服务器虚拟机（内部版本 25.481-b10，混合模式）如果无法访问，您需要调整 您的 PATH 环境变量。
注意：如果您尝试使用其他 JVM，连接器可能无法正常工作；这是由于 Oracle HFM Java 库的一些遗留要求造成的
。
-
注意： 将 GroundRunner 安装在托管 HFM 应用程序服务的企业性能 (EPM) 服务器上。当 GroundRunner 运行在与 Oracle HFM 实例不同的服务器或网络上时，Workiva 无法提供故障排除支持。
- Oracle 企业性能 (EPM) 系统实例及其 HFM主目录的路径。
- HFM 服务器在 EPM 共享服务注册表中显示的集群名称。
-
Oracle HFM 集成用户，用于向 Oracle HFM 实例进行身份验证。
注意： 集成用户必须是 Native Directory 用户（而不是 Microsoft® Active Directory® (MSAD) 用户），并且必须拥有对报表和扩展分析所需数据的访问权限。仍然需要 MSAD 用户，但其目的是与 GroundRunner 通信。
-
使用 GroundRunner 在 Oracle HFM 和关系数据库中执行任务。
注： 要启用连接，GroundRunner 集成用户需要对 HFM 主目录具有执行权限。
为了帮助您创建和构建供应链，我们还建议您确定以下事项：
- 您的 Workiva 管理员
- Oracle HFM 管理员
- 您的网络和基础设施工程团队
设置与 Oracle HFM 的连接
要建立连接，IT 管理员配置服务器，工作区所有者创建与 Oracle HFM 的连接。
第一步：配置服务器
- 在 Oracle HFM 中，创建集成用户，并授予其对报表和扩展分析的访问权限。
- 在可以访问Oracle HFM的服务器上：
-
安装 HFM 自带的 Java 运行时环境。这将使用 Java运行时环境 8或更高版本。
注： 安装 Java 时，系统可能会询问您是安装 Java 开发工具包 (JDK) 还是 Java 运行时环境 (JRE)。只需要JRE即可。
- 将 Oracle HFM 打包的 JVM 路径（通常是 JRE 的
JAVA_HOME目录，然后是bin文件夹）添加到系统 PATH中。 - 下载、安装并激活 GroundRunner 执行代理。
- 允许 Workiva 的主机域。
-
步骤 2. 设置 Oracle HFM 连接器
注意： 要使连接器可在您组织的链中使用， 组织安全管理员必须首先在配置中启用它。
- 从 链构建器中，单击 连接 ，然后单击右上角的 创建 。
- 在 连接器连接下，选择 Oracle Hyperion Financial Management 和服务器上安装的 GroundRunner。
- 在 基本信息下，输入一个唯一的名称和描述，以帮助识别连接。
-
在 属性下，输入连接的详细信息：
注： 请咨询您的 Oracle HFM 管理员以获取正确的值。
注意：所有敏感凭证均会自动加密，并以高级加密标准 (AES ) -256 加密方式存储
。 - 选择要与连接器一起使用的 工作区环境 ，然后单击 保存。
- 要测试连接， 创建并运行链 使用 Oracle HFM 连接器的提取成员列表命令，并验证它是否返回有效输出。
疑难解答
我可以在负载均衡服务器上使用 HFM 连接器吗？
负载均衡是 HFM 内置的功能，不受 Chains 控制，但您可以在设置连接器时将配置输入到 ClusterName 字段中。
与 Oracle HFM 的连接失败
验证要连接的 Oracle HFM 集群的名称以及 Oracle HFM 集成用户的身份验证凭据。
连接器返回空白输出或无响应
为确保 GroundRunner 可以与 Oracle HFM JAR 文件通信，请验证 HFM 主目录和 EPM 实例的路径。
连接器返回“权限不足”错误
确认 Oracle HFM 集成用户拥有读取和写入权限，而不仅仅是读取权限。
注： GroundRunner 所依赖的 MSAD 用户必须对 Chains 将要交互的任何包含文件的目录拥有足够的读/写权限。
命令返回成功退出代码，但没有输出。
如果 清除切片、复制数据、将数据提取到数据库或 将数据提取到文件 命令成功但没有输出，请验证其“仅展开”属性是否未被选中。选择“仅展开”以查看没有提取的成员，例如用于测试。
在多个服务器上安装时发生身份验证错误
请在日志中查找以下行：
信息：找不到文件 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.