Mit dem Oracle® Essbase® Connector können Sie Befehle in einer Kette verwenden, um mit Oracle Essbase zu interagieren. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:
- Ausführen von Berechnungs-, MaxL- und Berichtsskripten in Oracle Essbase
- Auflisten und Verwalten von Essbase-Datenbanken, -Anwendungen und -Variablen
- Hochladen, Herunterladen und Löschen von Dateien in Oracle Essbase
Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.
Voraussetzungen
Um die Verbindung zu aktivieren, verwendet der Konnektor die Oracle Essbase Java® API, die über eine einfache Authentifizierung mit Benutzername und Passwort gesichert ist. Um die Verbindung herzustellen, benötigen Sie:
- Ein spezieller GroundRunner, der für den Anschluss eingerichtet wurde
- Ein bestimmter Integrationsbenutzer, der in Oracle Essbase für den Konnektor eingerichtet wurde
- Die Authentifizierungsdaten des Integrationsbenutzers
- Der Integrationsbenutzer muss über die Berechtigungen verfügen, die für die Befehle gelten, die der Connector ausführt.
- Die Basis-URL der Essbase-Instanz, mit der eine Verbindung hergestellt werden soll
- Der Name des Essbase-Clusters, mit dem eine Verbindung hergestellt werden soll
- Der Pfad zu diesen Essbase-Client-Java-Archivdateien (JAR):
ess_es_server.jaress_japi.jaress_maxl.jar
- ob die Essbase-Instanz den eingebetteten Modus aktiviert hat
Hinweis zur Kompatibilität: Workiva hat diesen Konnektor ausschließlich mit den Versionen 11.1.2.2.x, 11.1.2.3, 11.1.2.4, und 11.2 getestet und validiert. Workiva kann nicht garantieren, dass dieser Connector mit ungetesteten Versionen wie gewünscht funktioniert.
Suchen Sie die Essbase-Client-JAR-Dateien
Um die Verbindung zu ermöglichen, benötigt der Connector Client-JAR-Dateien, die sich in der Oracle Essbase-Installation befinden.
- Standardpfad für Microsoft® Windows®:
C:\Oracle\Middleware\EPMSystem11R1\common\EssbaseJavaAPI\<version_#>\lib - Standardpfad für Linux:
/Benutzer/Benutzername/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/<version_#>/lib
Wenn GroundRunner und Oracle Essbase auf unterschiedlichen Servern installiert sind, kopieren Sie die JAR-Dateien in einen Ordner auf dem GroundRunner-Server und notieren Sie den Pfad zu diesem Ordner für die Eigenschaft Java API Path des Konnektors.
Einrichten des Oracle Essbase-Konnektors
Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.
- Von Chain Builder, klicken Sie auf Verbindungen , und dann Erstellen oben rechts.
- Unter Connector Connection, wählen Sie Oracle Essbase und den GroundRunner, der mit dem Connector verwendet werden soll.
- Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
-
Geben Sie unter Eigenschaften die Details des Connectors ein:
Eigenschaft Details Name des Benutzers Geben Sie den Benutzernamen des Essbase-Integrationsbenutzers des Connectors ein. Kennwort Geben Sie das Passwort für die Eigenschaft User Name ein. Instanz-URL Geben Sie die Basis-URL für die Essbase-Instanz ein, mit der eine Verbindung hergestellt werden soll, einschließlich des führenden Protokolls; häufig eine IP-Adresse wie http://100.0.0.1.Name des Clusters Geben Sie den Essbase-Cluster an, mit dem Sie sich verbinden möchten: standardmäßig EssbaseCluster.Java-API-Pfad Geben Sie den Pfad zu den Client-JAR-Dateien für die Essbase-Instanz ein:
- Wenn GroundRunner und Essbase auf demselben Server installiert sind, geben Sie den Pfad zu den JAR-Dateien in der Essbase-Installation an.
- Wenn GroundRunner und Essbase auf verschiedenen Servern installiert sind, geben Sie den Pfad zu dem Ordner auf dem GroundRunner Server an, der Kopien der JAR-Dateien enthält.
Eingebetteter Modus aktiviert Wenn in der Essbase-Instanz der eingebettete Modus aktiviert ist, markieren Sie dieses Feld.
(In eigenständigen Oracle Hyperion®-Umgebungen ist der Embedded Mode in der Regel aktiviert).
Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.
- Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
- Um die Verbindung zu testen, erstellen Sie und führen Sie eine Kette mit dem Befehl Anwendungen auflisten des Konnektors aus, und überprüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.
Fehlersuche
In diesem Abschnitt werden mögliche Probleme mit dem Oracle Essbase Connector selbst und seinen Befehlen behandelt.
Wenn die Verbindung zu Oracle Essbase fehlschlägt:
- Überprüfen Sie die Authentifizierungsdaten des Essbase-Integrationsbenutzers.
- Überprüfen Sie den für den Anschluss ausgewählten GroundRunner.
- Überprüfen Sie die Basis-URL für die Essbase-Instanz, mit der eine Verbindung hergestellt werden soll.
- Überprüfen Sie den Namen des Essbase-Clusters, mit dem eine Verbindung hergestellt werden soll.
- Überprüfen Sie den Pfad zu den Essbase-Client-JAR-Dateien. Wenn der GroundRunner auf einem anderen Server als die Essbase-Instanz installiert ist, muss sichergestellt werden, dass die JAR-Dateien auf den GroundRunner-Server kopiert werden und der Pfad zu den Kopien als Eigenschaft des Konnektors Java API Path eingetragen wird.
- Überprüfen Sie die Dateierweiterung Ihrer hochgeladenen Datei