Centro de soporte de Workiva

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: Si bien este conector fue creado por Workiva para conectarse a un sistema HFM, nuestro equipo de soporte solo puede ayudarlo a configurar este conector dentro de su espacio de trabajo; no podemos solucionar problemas ni ayudar con ningún problema que se origine fuera de la plataforma Workiva.

Nota: Para conectarse a las versiones 9.3.1 a 11.1.2.3 de Oracle HFM, utilice 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 JDK, recursos de soporte, etc.)
• Instalaciones de:
  • El entorno de ejecución de Java que viene incluido con HFM.A partir de 2026, este suele ser Oracle Java Runtime Environment (JRE) 8. Este entorno de ejecución debe instalarse como JRE a nivel de sistema.

  • Este entorno de ejecución debe ser accesible desde la línea de comandos.
    Puede probar esto abriendo una terminal (Linux) o Símbolo del sistema/PowerShell (Windows) e ingresando java -version. La respuesta debería verse así: (la versión 1.8.x es JRE 8)

    Versión de Java "1.8.0_481", entorno de ejecución Java(TM) SE (compilación 1.8.0_481-b10), máquina virtual de servidor Java HotSpot(TM) de 64 bits (compilación 25.481-b10, modo mixto).

    Si no es accesible, necesitará ajustar su variable de entorno PATH.

    Nota: Si intenta 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: Instale GroundRunner en un servidor de rendimiento empresarial (EPM) que aloje el servicio de aplicación 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 de inicio 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

1. En Oracle HFM, crea el usuario de integración y concédele acceso a Informes y Análisis ampliados.
2. En el servidor que puede acceder a Oracle HFM:

   • Instale el entorno de ejecución de Java que viene incluido con HFM. Este 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.

   • Agregue la ruta a la JVM empaquetada con Oracle HFM (normalmente es JAVA_HOME del JRE y luego 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.

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

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

   Nota: Consulte a su administrador de Oracle HFM para obtener 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. El valor predeterminado es: C:/Oracle/Middleware/EPMSystem11R1.
   Instancia de EPM	Introduce la ruta al sistema EPM. El valor predeterminado 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 sensibles se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

5. Selecciona los entornos del Espacio de trabajo para utilizarlos con el conector, y haz clic en Guardar como....
6. 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

a

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