借助 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.