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.jaress_japi.jaress_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.
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connectionväljer du Oracle Essbase och den GroundRunner som ska användas med connectorn.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera anslutningen.
-
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.
- Välj de miljöer som ska användas med anslutningen och klicka på Save.
- 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.
Om anslutningen till Oracle Essbase misslyckas:
- Verifiera autentiseringsuppgifterna för Essbase-integrationsanvändaren.
- Kontrollera vilken GroundRunner som valts för kontakten.
- Kontrollera bas-URL:en för Essbase-instansen som du ska ansluta till.
- Kontrollera namnet på Essbase-klustret som du vill ansluta till.
- Kontrollera sökvägen till Essbase-klientens JAR-filer. Om GroundRunner är installerad på en annan server än Essbase-instansen ska du se till att JAR-filerna kopieras till GroundRunners server och att sökvägen till kopiorna anges som connectorens Java API Path egenskap.
- Kontrollera filtillägget för din uppladdade fil