Workiva-ondersteuningscentrum

Met de Oracle® Essbase® connector kunt u commando's in een keten gebruiken voor interactie met Oracle Essbase. Met deze connector kunt u bijvoorbeeld:

• Berekenings-, MaxL- en rapportscripts uitvoeren in Oracle Essbase
• Essbase databases, toepassingen en variabelen inventariseren en beheren
• Bestanden uploaden, downloaden en verwijderen in Oracle Essbase

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de verbinding mogelijk te maken, gebruikt de connector de Oracle Essbase Java® API, beveiligd via basisverificatie met gebruikersnaam en wachtwoord. Om de verbinding op te zetten, hebt u het volgende nodig:

• Een aangewezen GroundRunner ingesteld voor de connector
• Een aangewezen integratiegebruiker ingesteld in Oracle Essbase voor de connector
• De verificatiegegevens van de integratiegebruiker
• De integratiegebruiker moet rechten hebben die van toepassing zijn op de opdrachten die de connector uitvoert.
• De basis URL van de Essbase instance waarmee verbinding moet worden gemaakt
• De naam van het Essbase-cluster waarmee verbinding moet worden gemaakt
• Het pad naar deze Essbase client Java archief (JAR) bestanden:
  • ess_es_server.jar
  • ess_japi.jar
  • ess_maxl.jar
• Of de Essbase instance de Embedded Mode heeft ingeschakeld

Compatibiliteit: Workiva heeft deze connector uitsluitend getest en gevalideerd met versies 11.1.2.2.x, 11.1.2.3, 11.1.2.4, en 11.2. Workiva kan niet garanderen dat deze connector naar wens zal werken met ongeteste versies.

Zoek de Essbase-client JAR-bestanden

Om de verbinding mogelijk te maken, heeft de connector client JAR-bestanden nodig die zich in de Oracle Essbase installatie bevinden.

• Standaard pad voor Microsoft® Windows®: C:\Oracle\Middleware\EPMSystem11R1\common\EssbaseJavaAPI<versie_#>lib
• Standaardpad voor Linux: /User/username/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/<version_#>/lib

Als de GroundRunner en Oracle Essbase op verschillende servers geïnstalleerd zijn, kopieer dan de JAR bestanden naar een map op de GroundRunner server en noteer het pad naar de map voor de connector's Java API Path property.

De Oracle Essbase-connector instellen

Opmerking: Om de connector beschikbaar te maken voor gebruik in de ketens van uw organisatie, moet een beveiligingsbeheerder van de org deze eerst inschakelen vanuit Configuratie.

1. Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
2. Selecteer onder Connector Connection Oracle Essbase en de GroundRunner die u met de connector wilt gebruiken.
   
3. Voer onder Basisinfo een unieke naam en beschrijving in om de verbinding te helpen identificeren.

4. Voer onder Eigenschappen de gegevens van de connector in:
   

   Eigendom	Details
   Gebruikersnaam	Voer de gebruikersnaam van de Essbase integratiegebruiker van de connector in.
   Wachtwoord	Voer het wachtwoord in voor de eigenschap User Name.
   Instance URL	Voer de basis URL in voor de Essbase instance waarmee verbinding moet worden gemaakt, inclusief het leidende protocol; vaak een IP-adres zoals http://100.0.0.1.
   Clusternaam	Voer het Essbase-cluster in waarmee u verbinding wilt maken; standaard is dit EssbaseCluster.
   Java API-pad	Voer het pad in naar de JAR-bestanden van de client voor de Essbase instance: Als GroundRunner en Essbase op dezelfde server zijn geïnstalleerd, vul dan het pad naar de JAR bestanden in de Essbase installatie in. Als de GroundRunner en Essbase geïnstalleerd zijn op verschillende servers, vul dan het pad in naar de map op de GroundRunner server die kopieën van de JAR bestanden bevat.
   Ingebedde modus ingeschakeld	Vink dit vakje aan als de Essbase instance Embedded Mode ingeschakeld heeft. (Standalone Oracle Hyperion®-omgevingen hebben meestal Embedded Mode ingeschakeld)

   Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.

5. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
6. Om de verbinding te testen, maakt een ketting aan en voert deze uit met de connector's List Applications opdracht, en controleer of deze een geldige uitvoer oplevert.

Probleemoplossing

Deze sectie behandelt mogelijke problemen met zowel de Oracle Essbase connector zelf als de bijbehorende opdrachten.

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

Fout: com.essbase.api.base.EssException: Kan geen verbinding maken met Provider Server

Fout: com.essbase.api.base.EssException: Kan geen verbinding maken met olap-service. Kan geen verbinding maken met Essbase Server. Fout:Essbase-fout(1042003): Netwerkfout [11001]: Mislukt bij het ophalen van naaminformatie voor [Essbase-Cluster1] Fout bij het verifiëren met Essbase: Kan geen verbinding maken met olap service. Kan geen verbinding maken met Essbase Server. Fout:Essbase-fout(1042003): Netwerkfout [11001]: Mislukt bij het ophalen van naaminformatie voor [Essbase-Cluster1]

Kan geen olap-bestandsobject maken. Essbase Fout(1030014): Ongeldig objecttype doorgegeven aan ESSAPI-functie