Portail de support Workiva

Avec le connecteur Oracle® Essbase®, vous pouvez utiliser les commandes dans une chaîne pour interagir avec Oracle Essbase. Par exemple, avec ce connecteur, vous pouvez :

• Exécuter des scripts de calcul, MaxL et de rapport dans Oracle Essbase
• Répertorier et gérer les bases de données, les applications et les variables d'Essbase
• Charger, télécharger et supprimer des fichiers dans Oracle Essbase

Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Conditions préalables

Pour permettre la connexion, le connecteur utilise l'API Oracle Essbase Java®, sécurisée par une authentification de base par nom d'utilisateur et mot de passe. Pour établir la connexion, vous aurez besoin des éléments suivants :

• Un GroundRunner désigné mis en place pour le connecteur
• Un utilisateur d'intégration désigné dans Oracle Essbase pour le connecteur
• Les informations d'authentification de l'utilisateur de l'intégration
• L'utilisateur de l'intégration doit disposer des autorisations applicables aux commandes exécutées par le connecteur.
• URL de base de l'instance Essbase à laquelle se connecter
• Le nom du cluster Essbase auquel se connecter
• Le chemin d'accès à ces fichiers d'archive Java (JAR) du client Essbase :
  • ess_es_server.jar
  • ess_japi.jar
  • ess_maxl.jar
• Si l'instance d'Essbase a activé le mode intégré (Embedded Mode)

Avis de compatibilité : Workiva a testé et validé ce connecteur exclusivement avec les versions 11,1.2,2.x, 11,1.2,3, 11,1.2,4 et 11,2. Workiva ne peut pas garantir que ce connecteur fonctionnera comme souhaité avec des versions non testées.

Localiser les fichiers JAR du client Essbase

Pour permettre la connexion, le connecteur a besoin de fichiers JAR client situés dans l'installation d'Oracle Essbase.

• Chemin par défaut pour Microsoft® Windows® : C :\NOracle\NMiddleware\NEPMSystem11R1\Ncommon\NEssbaseJavaAPI\N<version_#>\Nlib
• Chemin par défaut pour Linux : /User/nom d’utilisateur/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/<version_#>/lib

Si le GroundRunner et Oracle Essbase sont installés sur des serveurs différents, copiez les fichiers JAR dans un dossier sur le serveur du GroundRunner et notez le chemin d'accès au dossier pour la propriété Java API Path du connecteur.

Configurer le connecteur Oracle Essbase

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. Depuis Chain Builder, cliquez sur Connections compare_arrows, puis sur Create en haut à droite.
2. Sous Connector Connection, sélectionnez Oracle Essbase et le GroundRunner à utiliser avec le connecteur.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.

4. Sous Properties, entrez les détails du connecteur :
   

   Propriété	Détails
   Nom de l'utilisateur	Entrez le nom d'utilisateur de l'utilisateur d'intégration Essbase du connecteur.
   Mot de passe	Saisissez le mot de passe pour la propriété User Name.
   URL de l'instance	Saisissez l'URL de base de l'instance d'Essbase à laquelle se connecter, y compris le protocole principal ; il s'agit souvent d'une adresse IP telle que http://100.0.0.1.
   Nom du groupe	Entrez le cluster Essbase auquel vous connecter ; par défaut, EssbaseCluster.
   Chemin d'accès à l'API Java	Saisissez le chemin d'accès aux fichiers JAR du client pour l'instance Essbase : Si GroundRunner et Essbase sont installés sur le même serveur, saisissez le chemin d'accès aux fichiers JAR dans l'installation d'Essbase. Si le GroundRunner et l'Essbase sont installés sur différents serveurs, indiquez le chemin d'accès au dossier du serveur du GroundRunner qui contient des copies des fichiers JAR.
   Mode intégré activé	Si l'instance d'Essbase a activé le mode intégré, cochez cette case. (Les environnements Oracle Hyperion® autonomes ont généralement le mode intégré activé).

   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 à utiliser avec la connexion et cliquez sur enregistrer.
6. Pour tester la connexion, créez et exécutez une chaîne avec la commande List Applications du connecteur et vérifiez qu'elle renvoie une sortie valide.

Dépannage

Cette section couvre les problèmes potentiels liés au connecteur Oracle Essbase lui-même et à ses commandes.

 Exception dans le thread "main" [] false} stdErr="java.lang.NoClassDefFoundError : com/essbase/api/base/EssException"

Erreur : com.essbase.api.base.EssException : Impossible de se connecter au serveur du fournisseur

Erreur : com.essbase.api.base.EssException : Impossible de se connecter au service olap. Impossible de se connecter au serveur Essbase. Erreur:Erreur Essbase(1042003) : Erreur réseau [11001] : Failed to retrieve name information for [Essbase-Cluster1] Erreur d'authentification avec Essbase : Impossible de se connecter au service olap. Impossible de se connecter au serveur Essbase. Erreur:Erreur Essbase(1042003) : Erreur réseau [11001] : Failed to retrieve name information for [Essbase-Cluster1] (Échec de la récupération des informations de nom pour [Essbase-Cluster1])

Impossible de créer un objet fichier olap. Erreur Essbase(1030014) : Type d'objet non valide transmis à la fonction ESSAPI