Workiva Support Center

Mit dem Oracle® Hyperion® Financial Management Connector können Sie Befehle in einer Kette verwenden, um mit Oracle Hyperion Financial Management (HFM) Version 11.1.2.4.x oder 11.2.x zu interagieren. Sie können zum Beispiel eine Kette erstellen, um Daten aus Oracle HFM als Datei zu extrahieren und in eine Wdata-Tabelle hochzuladen.

Wichtig: Obwohl dieser Connector von Workiva für die Verbindung zu einem HFM-System entwickelt wurde, kann unser Support-Team nur bei der Konfiguration dieses Connectors innerhalb Ihres Arbeitsbereichs helfen. Wir können keine Fehler beheben oder anderweitig bei Problemen helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.

Hinweis: Um eine Verbindung zu den Oracle HFM-Versionen 9.3.1 bis 11.1.2.3 herzustellen, verwenden Sie den Oracle HFM Legacy-Konnektor.

Voraussetzungen

Um die Verbindung herzustellen, benötigen Sie:

• Ein Server mit Zugriff auf Oracle HFM.
  Es sollte die gesamte HFM-Suite installiert sein (einschließlich JDKs, unterstützende Assets usw.)
• Installationen von:
  • Die Java-Laufzeitumgebung, die im Lieferumfang von HFM enthalten ist.  Ab 2026 ist dies in der Regel die Oracle Java Runtime Environment (JRE) 8. Diese Laufzeitumgebung sollte als JRE auf Systemebene installiert werden.

  • Diese Laufzeitumgebung muss von der Befehlszeile aus zugänglich sein. 
    Sie können dies testen, indem Sie ein Terminal (Linux) oder eine Eingabeaufforderung/PowerShell (Windows) öffnen und java -version eingeben. Die Antwort sollte in etwa wie folgt aussehen: (Version 1.8.x ist JRE 8)

    java Version "1.8.0_481" Java(TM) SE Laufzeitumgebung (Build 1.8.0_481-b10) Java HotSpot(TM) 64-Bit Server VM (Build 25.481-b10, gemischter Modus)

    Wenn er nicht zugänglich ist, müssen Sie Ihre PATH-Umgebungsvariable anpassen.

    Hinweis: Wenn Sie versuchen, andere JVMs zu verwenden, kann es sein, dass der Connector nicht ordnungsgemäß funktioniert; dies liegt an einigen Legacy-Anforderungen der Oracle HFM Java-Bibliotheken.

• Ein GroundRunner Ausführungsagent

  Hinweis: Installieren Sie den GroundRunner auf einem Enterprise Performance (EPM) Serverrechner, auf dem der HFM Application Service gehostet wird.  Workiva kann keine Unterstützung bei der Fehlerbehebung bieten, wenn der GroundRunner auf einem anderen Server oder Netzwerk läuft als die Oracle HFM Instanz.

• Pfade zur Oracle Enterprise Performance (EPM)-Systeminstanz und deren HFM-Home-Verzeichnis.
• Der Clustername des HFM-Servers, wie er in der EPM Shared Services Registry erscheint.

• Ein Oracle HFM-Integrationsbenutzer, der für die Authentifizierung bei der Oracle HFM-Instanz verwendet wird.

  Hinweis: Der Integrationsbenutzer muss ein Native Directory-Benutzer und kein Microsoft® Active Directory® (MSAD)-Benutzer sein, der Zugriff auf die für Reporting und Extended Analytics erforderlichen Daten hat. Der MSAD-Benutzer wird immer noch benötigt, aber sein Zweck ist die Kommunikation mit dem GroundRunner.

• Ein GroundRunner, der die Aufgaben in Oracle HFM und der relationalen Datenbank ausführt.

  Hinweis: Um die Verbindung zu aktivieren, benötigt der GroundRunner Integrationsbenutzer Ausführungsrechte für das HFM-Home-Verzeichnis.

Für Unterstützung beim Erstellen und Aufbauen von Ketten empfehlen wir Ihnen außerdem, Folgendes zu identifizieren:

• Ihre Workiva-Administratoren
• Die Oracle HFM-Administratoren
• Ihre Teams für Netzwerk- und Infrastrukturtechnik

Einrichten der Verbindung zu Oracle HFM

Um die Verbindung einzurichten, konfiguriert ein IT-Administrator den Server, und ein Arbeitsbereichseigentümer erstellt die Verbindung zu Oracle HFM.

Schritt 1. Konfigurieren Sie den Server

1. Legen Sie in Oracle HFM den Integrationsbenutzer an, und gewähren Sie ihm Zugriff auf Reporting und Extended Analytics.
2. Auf dem Server, der auf Oracle HFM zugreifen kann:

   • Installieren Sie die Java-Laufzeitumgebung, die im Lieferumfang von HFM enthalten ist. Dies wird Java Runtime Environment 8 oder höher sein.

     Hinweis: Bei der Installation von Java werden Sie möglicherweise gefragt, ob Sie das Java Development Kit (JDK) oder die Java Runtime Environment (JRE) installieren möchten. Nur die JRE ist erforderlich.

   • Fügen Sie den Pfad zu der mit dem Oracle HFM gepackten JVM (dies ist normalerweise der JAVA_HOME der JRE und dann der bin Ordner) zum System PATH hinzu.
   • Downloaden, installieren und aktivieren Sie den GroundRunner Ausführungsagenten.
   • Erlaube die Host-Domains für Workiva.

Schritt 2. Einrichten des Oracle HFM-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.

1. Klicken Sie unter Chain-Generator auf Verbindungen   compare_arrows und dann auf Erstellen oben rechts.
2. Unter Connector Connection, wählen Sie Oracle Hyperion Financial Management und den auf dem Server installierten GroundRunner.
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.

4. Geben Sie unter Eigenschaften die Details der Verbindung ein:

   Hinweis: Wenden Sie sich an Ihren Oracle HFM-Administrator, um die richtigen Werte zu erfahren.

   Eigenschaft	Details
   Benutzername	Geben Sie den Benutzernamen des Oracle HFM-Integrationsbenutzers ein.
   Kennwort	Geben Sie das Kennwort für den Oracle HFM-Integrationsbenutzer ein.
   EPM Startseite	Geben Sie den Pfad zum HFM-Home-Verzeichnis für das Oracle EPM-System ein.  Die Voreinstellung ist: C:/Oracle/Middleware/EPMSystem11R1.
   EPM-Instanz	Geben Sie den Pfad zum EPM-System ein.  Die Voreinstellung ist: C:/Oracle/Middleware/user_projects/epmsystem1.
   HFM-Cluster	Geben Sie den Clusternamen für den Oracle HFM-Server ein, wie er in der EPM Shared Services-Registrierung erscheint.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

5. Wählen Sie die Arbeitsbereich-Umgebungen aus, die Sie mit dem Konnektor verwenden möchten, und klicken Sie auf Speichern.
6. Um die Verbindung zu testen, erstellen Sie eine Kette und führen Sie diese mit dem Befehl Mitgliederliste extrahieren des Oracle HFM-Konnektors  aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

Kann ich den HFM-Konnektor auf einem Server mit Lastausgleich verwenden?

Der Lastausgleich ist in HFM integriert und wird nicht von Chains gesteuert, aber Sie können Ihre Konfiguration in das Feld ClusterName eingeben, wenn Sie den Connector einrichten.

Die Verbindung zu Oracle HFM schlägt fehl

Überprüfen Sie den Namen des Oracle HFM-Clusters, zu dem eine Verbindung hergestellt werden soll, und die Authentifizierungsdaten des Oracle HFM-Integrationsbenutzers.

Der Konnektor gibt eine leere Ausgabe oder keine Antwort zurück

Um sicherzustellen, dass der GroundRunner mit den Oracle HFM JAR-Dateien kommunizieren kann, überprüfen Sie die Pfade zum HFM-Home-Verzeichnis und zur EPM-Instanz.

Der Konnektor gibt den Fehler "unzureichende Berechtigungen" zurück

Vergewissern Sie sich, dass der Oracle HFM-Integrationsbenutzer sowohl Lese- als auch Schreibzugriff hat - nicht nur Lesezugriff.

Hinweis: Der MSAD-Benutzer - von dem der GroundRunner abhängt - muss auch ausreichenden Lese-/Schreibzugriff auf alle Verzeichnisse haben, die Dateien enthalten, mit denen Chains interagieren wird.

Ein Befehl gibt den Exit-Code "Success" zurück, hat aber keine Ausgabe

Wenn der Befehl Slice löschen, Daten kopieren, Daten in die Datenbank extrahieren oder Daten in die Datei extrahieren erfolgreich ist, aber keine Ausgabe erfolgt, überprüfen Sie, ob die Eigenschaft "Nur expandieren" nicht ausgewählt ist. Wählen Sie "Nur erweitern", um Mitglieder ohne Extraktion anzuzeigen, z. B. für Tests.

Bei der Installation auf mehreren Servern tritt ein Authentifizierungsfehler auf

Suchen Sie in den Protokollen nach der folgenden Zeile:

 INFO: Die Datei reg.properties konnte nicht gefunden werden.

Wenn dies gefunden wird, kopieren Sie die Datei reg.properties von Oracle\Middleware\user_projects\config\foundation\11.1.2.0

bis

Oracle\Middleware\user_projects\epmsystem1\config\foundation\11.1.2.0.