Portail de support Workiva

Avec le connecteur Oracle® Hyperion® Financial Management, vous pouvez utiliser les commandes dans une chaîne pour interagir avec Oracle Hyperion Financial Management (HFM) version 11.1.2.4.x ou 11.2.x. Par exemple, vous pouvez créer une chaîne pour extraire des données d'Oracle HFM sous forme de fichier à télécharger dans une table Wdata.

Important : Bien que ce connecteur ait été conçu par Workiva pour se connecter à un système HFM, notre équipe d’assistance ne peut que vous aider à configurer ce connecteur dans votre espace de travail ; nous ne sommes pas en mesure de dépanner ou d’aider à résoudre les problèmes qui surviennent en dehors de la plateforme Workiva.

Remarque : Pour vous connecter aux versions 9,3.1 à 11,1.2,3 d’Oracle HFM, utilisez le connecteur Oracle HFM Legacy.

Conditions préalables

Pour établir la connexion, vous aurez besoin des éléments suivants :

• Un serveur ayant accès à Oracle HFM.
  L’ensemble de la suite HFM doit être installé sur ce serveur (y compris les JDK, les supports, etc.).
• Installations de :
  • Le moteur d’exécution Java fourni avec HFM.  À partir de 2026, il s’agit généralement de l’Oracle Java Runtime Environment (JRE) 8. Ce runtime doit être installé en tant que JRE au niveau du système.

  • Ce runtime doit être accessible à partir de la ligne de commande. 
    Vous pouvez tester cela en ouvrant un terminal (Linux) ou Command Prompt/PowerShell (Windows) et en entrant java -version. La réponse devrait ressembler à ceci : (la version 1,8.x est 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)

    S’il n’est pas accessible, vous devrez ajuster votre variable d’environnement PATH.

    Note : Si vous essayez d’utiliser d’autres JVM, le connecteur risque de ne pas fonctionner correctement ; cela est dû à certaines exigences des bibliothèques Oracle HFM Java.

• Un agent d'exécution GroundRunner

  Note : Installez le GroundRunner sur un serveur Enterprise Performance (EPM) hébergeant le service d’application HFM.  Workiva ne peut pas fournir de support de dépannage lorsque le GroundRunner fonctionne sur un serveur ou un réseau différent de l'instance Oracle HFM.

• Chemins d'accès à l'instance du système Oracle Enterprise Performance (EPM) et à son répertoire d'origine HFM.
• Le nom du cluster du serveur HFM tel qu'il apparaît dans le registre des services partagés EPM.

• Un utilisateur d'intégration Oracle HFM, utilisé pour s'authentifier auprès de l'instance Oracle HFM.

  Note : L’utilisateur d’intégration doit être un utilisateur Native Directory - et non un utilisateur Microsoft® Active Directory® (MSAD) - ayant accès aux données requises pour Reporting et Extended Analytics. L'utilisateur du MSAD est toujours nécessaire, mais son objectif est de communiquer avec le GroundRunner.

• Un GroundRunner pour effectuer les tâches dans Oracle HFM et la base de données relationnelle.

  Note : Pour activer la connexion, l’utilisateur d’intégration du GroundRunner doit disposer des droits d’exécution sur le répertoire d’origine de HFM.

Pour vous aider à créer et à construire des chaînes, nous vous recommandons également d'identifier :

• Vos administrateurs Workiva
• Les administrateurs d'Oracle HFM
• Vos équipes d'ingénierie de réseau et d'infrastructure

Configurer la connexion à Oracle HFM

Pour établir la connexion, un administrateur informatique configure le serveur et un propriétaire d'espace de travail crée la connexion à Oracle HFM.

Étape 1. Configurer le serveur

1. Dans Oracle HFM, créez l'utilisateur d'intégration et accordez-lui l'accès à Reporting et Extended Analytics.
2. Sur le serveur qui peut accéder à Oracle HFM :

   • Installez le moteur d’exécution Java fourni avec HFM. Il s’agit de Java Runtime Environment 8 ou d’une version supérieure.

     Note : Lors de l'installation de Java, il se peut que l'on vous demande d'installer le kit de développement Java (JDK) ou l'environnement d'exécution Java (JRE). Seul le JRE est nécessaire.

   • Ajoutez le chemin d’accès à la JVM fournie avec Oracle HFM (il s’agit généralement du dossier JAVA_HOME du JRE, puis du dossier bin ) au système PATH.
   • Télécharger, installer et activer l'agent d'exécution GroundRunner.
   • Autoriser les domaines hôtes pour Workiva.

Étape 2. Configurer le connecteur Oracle HFM

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

1. À partir du Générateur de chaînes, cliquez sur Connexions   compare_arrows, puis sur Créer en haut à droite.
2. Sous Connector Connection, sélectionnez Oracle Hyperion Financial Management et le GroundRunner installé sur le serveur.
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.

4. Sous Propriétés, entrez les détails de la connexion :

   Note : Consultez votre administrateur Oracle HFM pour connaître les valeurs correctes.

   Propriété	Détails
   Nom d’utilisateur	Saisissez le nom d'utilisateur de l'utilisateur de l'intégration Oracle HFM.
   Mot de passe	Saisissez le mot de passe de l'utilisateur de l'intégration Oracle HFM.
   Accueil EPM	Saisissez le chemin d'accès au répertoire d'accueil HFM pour le système Oracle EPM.  La valeur par défaut est : C :/Oracle/Middleware/user_projects/epmsystem1 C :/Oracle/Middleware/EPMSystem11R1.
   Instance EPM	Entrez le chemin d'accès au système EPM.  La valeur par défaut est : C :/Oracle/Middleware/user_projects/epmsystem1 C :/Oracle/Middleware/user_projects/epmsystem1.
   Groupe HFM	Saisissez le nom du cluster pour le serveur Oracle HFM, tel qu'il apparaît dans le registre EPM Shared Services.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256.

5. Sélectionnez les environnements de l'espace de travail à utiliser avec le connecteur et cliquez sur Save.
6. Pour tester la connexion, créez et exécutez une chaîne avec la commande Extract Members List du connecteur Oracle HFM, et vérifiez qu'elle renvoie un résultat valide.

Dépannage

Puis-je utiliser le connecteur HFM sur un serveur à charge équilibrée ?

L'équilibrage de charge est intégré à HFM et n'est pas contrôlé par les chaînes, mais vous pouvez saisir votre configuration dans le champ ClusterName lors de la configuration du connecteur.

La connexion à Oracle HFM échoue

Vérifiez le nom du cluster Oracle HFM auquel se connecter et les informations d'authentification de l'utilisateur de l'intégration Oracle HFM.

Le connecteur renvoie une sortie vide ou aucune réponse

Pour s'assurer que le GroundRunner peut communiquer avec les fichiers JAR Oracle HFM, vérifiez les chemins d'accès au répertoire d'accueil HFM et à l'instance EPM.

Le connecteur renvoie une erreur "permissions insuffisantes".

Vérifiez que l'utilisateur de l'intégration Oracle HFM dispose d'un accès en lecture et en écriture, et non en lecture seule.

Note : L'utilisateur MSAD - dont dépend le GroundRunner - doit également disposer d'un accès suffisant en lecture/écriture à tous les répertoires contenant des fichiers avec lesquels les chaînes interagiront.

Une commande renvoie un code de sortie "Success" mais n'a pas de résultat.

Si la commande Clear slice, Copy data, Extract data to database, ou Extract data to file réussit mais ne produit aucun résultat, vérifiez que la propriété "Expand only" n'est pas sélectionnée. Sélectionnez "Développer uniquement" pour afficher les membres sans extraction, par exemple pour les tests.

Une erreur d'authentification se produit lors de l'installation sur plusieurs serveurs

Recherchez la ligne suivante dans les journaux :

 INFO : Le fichier reg.properties n'a pas été trouvé.

Si c'est le cas, copiez le fichier reg.properties à partir de Oracle\Middleware\user_projects\config\foundation\11.1.2.0

à

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