Workiva supportcenter

Med Oracle® Essbase® Connector kan du använda kommandon i en kedja för att interagera med Oracle Essbase. Med den här kontakten kan du t.ex:

• Exekvera beräknings-, MaxL- och rapportskript i Oracle Essbase
• Lista och hantera Essbase-databaser, applikationer och variabler
• Ladda upp, ladda ner och radera filer i Oracle Essbase

Obs: Denna kontakt är byggd av Workiva och ansluts till ett system från tredje part. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.

Förkunskapskrav

För att aktivera anslutningen använder connectorn Oracle Essbase Java® API, som är säkrat via grundläggande autentisering med användarnamn och lösenord. För att konfigurera anslutningen behöver du:

• En särskild GroundRunner upprättad för kontakten
• En utsedd integrationsanvändare som har konfigurerats i Oracle Essbase för anslutningen
• Autentiseringsuppgifter för integrationsanvändaren
• Integrationsanvändaren måste ha behörighet som gäller för de kommandon som connectorn utför.
• Bas-URL för Essbase-instansen som du ska ansluta till
• Namnet på Essbase-klustret att ansluta till
• Sökvägen till dessa JAR-filer (Java Archive) för Essbase-klienten:
  • ess_es_server.jar
  • ess_japi.jar
  • ess_maxl.jar
• Om Essbase-instansen har Embedded Mode aktiverat

Meddelande om kompatibilitet: Workiva har testat och validerat den här kontakten uteslutande med versionerna 11.1.2.2.x, 11.1.2.3, 11.1.2.4 och 11.2. Workiva kan inte garantera att den här anslutningen fungerar som önskat med otestade versioner.

Leta reda på Essbase-klientens JAR-filer

För att aktivera anslutningen kräver connectorn klientens JAR-filer som finns i Oracle Essbase-installationen.

• Standardsökväg för Microsoft® Windows®: C:\Oracle\Middleware\EPMSystem11R1\common\EssbaseJavaAPI\<version_#>\lib
• Standardsökväg för Linux: /User/username/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/<version_#>/lib

Om GroundRunner och Oracle Essbase är installerade på olika servrar kopierar du JAR-filerna till en mapp på GroundRunners server och noterar sökvägen till mappen för connectorens Java API Path egenskap.

Konfigurera Oracle Essbase-anslutningen

Obs: För att göra kontakten tillgänglig för användning i din organisations kedjor, en org säkerhetsadministratör först aktivera den från Konfiguration.

1. Från Chain Builder, klicka på Connections  compare_arrows, och sedan Create längst upp till höger.
2. Under Connector Connectionväljer du Oracle Essbase och den GroundRunner som ska användas med connectorn.
   
3. Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera anslutningen.

4. Under Properties anger du kontaktens detaljer:
   

   Egenskap	Information
   Användarens namn	Ange användarnamnet för connectorens Essbase-integrationsanvändare.
   Lösenord	Ange lösenordet för Användarnamn egendom.
   Instansens URL	Ange bas-URL:en för Essbase-instansen som du ska ansluta till, inklusive det ledande protokollet; ofta en IP-adress som http://100.0.0.1.
   Klustrets namn	Ange Essbase-klustret som du vill ansluta till; som standard EssbaseCluster.
   Java API sökväg	Ange sökvägen till klientens JAR-filer för Essbase-instansen: Om GroundRunner och Essbase är installerade på samma server, ange sökvägen till JAR-filerna i Essbase-installationen. Om GroundRunner och Essbase är installerade på olika servrar, ange sökvägen till den mapp på GroundRunners server som innehåller kopior av JAR-filerna.
   Inbäddat läge aktiverat	Om Essbase-instansen har Embedded Mode aktiverat markerar du den här rutan. (Fristående Oracle Hyperion®-miljöer har vanligtvis Embedded Mode aktiverat).

   Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.

5. Välj de miljöer som ska användas med anslutningen och klicka på Save.
6. Testa anslutningen genom att skapa och köra en kedja med -anslutningens List Applications -kommando, och kontrollera att den returnerar en giltig utdata.

Felsökning

I det här avsnittet behandlas potentiella problem med både själva Oracle Essbase Connector och dess kommandon.

 Undantag i tråden "main" [] false} stdErr="java.lang.NoClassDefFoundError: com/essbase/api/base/EssException"

Fel: com.essbase.api.base.EssException: Det går inte att ansluta till Provider Server

Fel: com.essbase.api.base.EssException: Det går inte att ansluta till olap-tjänsten. Det går inte att ansluta till Essbase Server. Fel:Essbase-fel(1042003): Nätverksfel [11001]: Det gick inte att hämta namninformation för [Essbase-Cluster1] Fel vid autentisering med Essbase: Det går inte att ansluta till olap-tjänsten. Det går inte att ansluta till Essbase Server. Fel:Essbase-fel(1042003): Nätverksfel [11001]: Det gick inte att hämta namninformation för [Essbase-Cluster1]

Det går inte att skapa ett olap-filobjekt. Essbase Fel(1030014): Ogiltig objekttyp skickad till ESSAPI-funktion