Conector a Oracle Hyperion Financial Management (HFM)

Con el conector Oracle® Hyperion® Financial Management, puedes utilizar comandos en una cadena para interactuar con Oracle Hyperion Financial Management (HFM) versión 11.1.2.4.x o 11.2.x. Por ejemplo, puedes crear una cadena para extraer datos de Oracle HFM como un archivo para subir a una tabla de Wdata.

Importante: Aunque este conector ha sido creado por Workiva para conectarse a un sistema HFM, nuestro equipo de Soporte sólo puede ayudar a configurar este conector dentro de tu espacio de trabajo; no podemos solucionar ni ayudar de ningún otro modo con cualquier problema que se origine fuera de la plataforma Workiva.

Nota: Para conectarte a las versiones 9.3.1 a 11.1.2.3 de Oracle HFM, utiliza el conector Oracle HFM Legacy.

Requisitos previos

Para establecer la conexión, necesitarás:

Un servidor con acceso a Oracle HFM.
Debe tener instalada toda la suite HFM (incluidos los JDK, activos de soporte, etc.)
Instalaciones de:
- El tiempo de ejecución de Java incluido con HFM. A partir de 2026, suele ser Oracle Java Runtime Environment (JRE) 8. Este tiempo de ejecución debe instalarse como JRE a nivel de sistema.
- Este tiempo de ejecución debe ser accesible desde la línea de comandos.
  Puedes Evaluar esto abriendo un terminal (Linux) o Símbolo del sistema/PowerShell (Windows) e introduciendo java -version. La respuesta debería parecerse a esto: (la versión 1.8.x es JRE 8)
```
java version "1.8.0_481" Java(TM) SE Runtime Environment (build 1.8.0_481-b10) Java HotSpot(TM) 64-Bit Server VM (build 25.481-b10, mixed mode)
```
  Si no es accesible, tendrás que ajustar tu variable de entorno PATH.
  
  Nota: Si intentas utilizar otras JVM, es posible que el conector no funcione correctamente; esto se debe a algunos requisitos heredados de las bibliotecas Java de Oracle HFM.

Un agente de ejecución GroundRunner

Nota: Instala el GroundRunner en una máquina servidor de Enterprise Performance (EPM) que aloje el Servicio de aplicaciones HFM. Workiva no puede proporcionar asistencia para la resolución de problemas cuando el GroundRunner se ejecuta en un servidor o red distintos a los de la instancia de Oracle HFM.

Rutas a la instancia del sistema Oracle Enterprise Performance (EPM) y a su directorio de página principal HFM.
El nombre del clúster del servidor HFM tal y como aparece en el Registro de Servicios Compartidos de EPM.
Un usuario de integración de Oracle HFM, utilizado para autenticarse con la instancia de Oracle HFM.

Nota: El usuario de integración debe ser un usuario del Directorio Nativo -no un usuario de Microsoft® Active Directory® (MSAD)- con acceso a los datos necesarios para Informes y Análisis ampliados. El usuario MSAD sigue siendo necesario, pero su finalidad es comunicarse con el GroundRunner.
Un GroundRunner para realizar las tareas en Oracle HFM y la base de datos relacional.

Nota: Para habilitar la conexión, el usuario de integración de GroundRunner requiere privilegios de Ejecución en el directorio principal de HFM.

Para recibir ayuda al crear y construir cadenas, también te recomendamos que te identifiques:

Tus administradores de Workiva
Los administradores de Oracle HFM
Tus equipos de ingeniería de redes e infraestructuras

Establece la conexión con Oracle HFM

Para establecer la conexión, un administrador de TI configura el servidor y el propietario de un espacio de trabajo crea la conexión con Oracle HFM.

Paso 1. Configurar el servidor

En Oracle HFM, crea el usuario de integración y concédele acceso a Informes y Análisis ampliados.
En el servidor que puede acceder a Oracle HFM:
- Instala el tiempo de ejecución de Java incluido con HFM. Esto será Java Runtime Environment 8 o superior.
  
  Nota: Al instalar Java, es posible que se te pregunte si deseas instalar el Kit de Desarrollo de Java (JDK) o el Entorno de Ejecución de Java (JRE). Solo se necesita el JRE.
- Añade la ruta a la JVM empaquetada con Oracle HFM (suele ser JAVA_HOME del JRE y, a continuación, la carpeta bin ) al sistema PATH.
- Descargar, instalar y activar el agente de ejecución GroundRunner.
- Permitir los dominios de host para Workiva.

Paso 2. Establecer el conector de Oracle HFM

Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.

En el Generador de cadenas, haz clic en Conexiones compare_arrows y, a continuación, en Crear en la parte superior derecha.
En Conexión de conectores, selecciona Oracle Hyperion Financial Management y el GroundRunner instalado en el servidor.
En Información básica, ingresa un nombre único y una descripción para ayudar a identificar la conexión.

En Propiedades, ingresa los detalles de la conexión:

Nota: Consulta a tu administrador de Oracle HFM los valores correctos.

Propiedad	Detalles
Nombre de usuario	Introduce el nombre de usuario del usuario de integración de Oracle HFM.
Contraseña	Introduce la Contraseña del usuario de integración de Oracle HFM.
Página principal de EPM	Introduce la ruta al directorio principal de HFM para el sistema Oracle EPM. Valores predeterminados es: `C:/Oracle/Middleware/EPMSystem11R1`.
Instancia de EPM	Introduce la ruta al sistema EPM. Valores predeterminados es: `C:/Oracle/Middleware/user_projects/epmsystem1`.
Grupo HFM	Introduce el nombre del clúster del servidor de Oracle HFM, tal y como aparece en el registro de Servicios Compartidos de EPM.

Nota: Todas las credenciales confidenciales se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

Selecciona los entornos del Espacio de trabajo para utilizarlos con el conector, y haz clic en Guardar como....
Para probar la conexión, crea y ejecuta una cadena con el comando Extraer lista de miembros del conector Oracle HFM, y comprueba que devuelve un resultado válido.

Solución de problemas

¿Puedo utilizar el conector HFM en un servidor con carga equilibrada?

El equilibrio de carga está integrado en HFM y no lo controlan las Cadenas, pero puedes introducir tu configuración en el campo ClusterName al configurar el conector.

Se ha producido un error en la conexión a Oracle HFM

Verifica el nombre del clúster de Oracle HFM al que te vas a conectar y las credenciales de autenticación del usuario de integración de Oracle HFM.

El conector devuelve una salida en blanco o ninguna respuesta

Para asegurarte de que el GroundRunner puede comunicarse con los archivos JAR de Oracle HFM, verifica las rutas al directorio principal de HFM y a la instancia de EPM.

El conector devuelve un error de "permisos insuficientes".

Verifica que el usuario de integración de Oracle HFM tiene acceso tanto de Lectura como de Escritura -- no solo de Lectura.

Nota: El usuario MSAD -del que depende el GroundRunner- también debe tener suficiente acceso de Lectura/Escritura a cualquier directorio que contenga archivos con los que interactuará Cadenas.

Un comando devuelve un código de salida Éxito pero no tiene salida

Si el comando Borrar selección, Copiar datos, Extraer datos a la base de datos, o Extraer datos al archivo tiene éxito pero no tiene resultado, comprueba que su propiedad "Sólo expandir" no está seleccionada. Selecciona "Solo expandir" para ver los miembros sin extracción, como para las pruebas.

Se ha producido un error de Autenticación al instalar en varios servidores

Busca la siguiente línea se ha encontrado en los registros:

 INFO: No se ha encontrado el archivo reg.properties.

Si lo encuentras, copia el archivo reg.properties de Oracle\Middleware\user_projects\config\foundation\11.1.2.0

Oracle\Middleware\user_projects\epmsystem1\config\foundation\11.1.2.0.

Soporte técnico

Comunidad

Centro de soporte de Workiva