Prozessbeschreibungen zur Integration von Oracle ERP Cloud-Daten mit benutzerdefinierten Abfragen

Sie können Daten mit einer benutzerdefinierten Abfrage aus Oracle ERP Cloud abrufen und in Oracle Enterprise Performance Management Cloud laden. Die benutzerdefinierte Abfrage wird für einen beliebigen Bericht aus Oracle Business Intelligence Publisher ausgeführt, mit dem eine CSV-formatierte Datendatei erstellt wird und die Daten anschließend in EPM Cloud geladen werden. Die Komponente Datenintegration führt in diesem Fall den Bericht aus, um die Daten zu extrahieren, und lädt sie in EPM Cloud.

Führen Sie zum Laden von Daten aus Oracle ERP Cloud in EPM Cloud mit BI Publisher-Berichtsextrakten mit einer benutzerdefinierten Abfrage die folgenden Schritte aus:

Hinweis:

Um eine benutzerdefinierte Oracle ERP Cloud-Integrationsdefinition mit EPM Cloud zu erstellen, registrieren Sie sie als ESS-Job. Informationen hierzu finden Sie unter BI Publisher-Berichte als Oracle Enterprise Scheduler-(ESS-)Jobs registrieren.
  1. Als Voraussetzung für eine Oracle ERP Cloud-Integration benötigen Sie die Berechtigungen oder die Benutzerrolle und den Datenzugriff auf alle zu integrierenden ERP-Hauptbücher. Weitere Informationen zu den Anforderungen an Oracle ERP Cloud-Sicherheitsrollen finden Sie unter Oracle ERP Cloud - ERP sichern.

  2. Navigieren Sie zu Oracle ERP Cloud, und führen Sie einen BI Publisher-Bericht aus, indem Sie auf Neuen Prozess planen klicken.

    Das Bild zeigt BI Publisher mit ausgewählter Option zum Planen eines neuen Prozesses.

  3. Wählen Sie auf der Seite Suchen und auswählen unter Name einen Bericht oder ein Extrakt aus, und klicken Sie auf OK.

    Sie können einen beliebigen BI Publisher-Bericht auswählen, solange der Bericht eine Ausgabedatei im CSV-Format generiert. Nicht alle Berichte in Fusion generieren eine Datei im CSV-Format.

    Das Bild zeigt die Berichtsauswahl.

    Beispiel: Geben Sie Saldo ein, um einen Saldenbilanzbericht zu suchen.

    Das Bild zeigt die Seite "Suchen und auswählen".

  4. Wählen Sie unter Prozessdetails die Parameter für das Extrakt oder den Bericht aus, und klicken Sie auf Weiterleiten.

    Im folgenden Beispiel lautet der Wert für "Hauptbuch" "Vision Operations", und der Wert für den Betragstyp lautet "Jahr kumuliert" oder "Periode kumuliert".

    Geben Sie unbedingt die Buchungsperiode an. Die Buchungsperiode ist der Parameter, der in der Komponente Datenintegration eingerichtet wird, damit der Bericht erneut verwendet werden kann.

    Hinweis:

    Die Oracle ERP Cloud- und die EPM Cloud-Integration können erst dann erfolgreich durchgeführt werden, wenn der ausgewählte Extrakt in Oracle ERP Cloud mindestens einen von EPM Cloud übergebenen Bind-Parameter enthält. Der Bind-Parameter dient als Platzhalter für Istwerte in der SQL-Anweisung. Bind-Parameter müssen in Tilden (~~) eingeschlossen sein. Beispiel: Geben Sie ~PERIOD~ an, wenn Sie "Period" als Bind-Parameter verwenden möchten. Der Name muss genau mit dem in der SQL-Abfrage angegebenen Namen übereinstimmen.

    Erstellen Sie dazu einen Bind-Parameter direkt im Bericht, der nicht in der Datenmodellabfrage referenziert wird. Geben Sie in der Komponente Datenintegration eine zufällige Zeichenfolge, z.B. "ABC", in der Berichtsparameterliste an, die an den von Ihnen in der Berichtsdefinition erstellten Bind-Parameter übergeben wird.

    Das Bild zeigt die Seite "Suchen und auswählen".

    Das Bild zeigt die Seite "Prozessdetails".

    Wenn der Bericht generiert wurde, werden die Ergebnisse der Weiterleitung im Abschnitt "Ausgabe" angezeigt.

    Das Bild zeigt den Abschnitt "Ausgabe" für den Bericht.

  5. Klicken Sie auf die Option zum erneuten Veröffentlichen, und klicken Sie auf der Seite Berichtsausgabe auf csv.

  6. Wählen Sie die CSV-Ausgabedatei aus, klicken Sie mit der rechten Maustaste darauf, und wählen Sie Öffnen aus.

    Das Bild zeigt die CSV-Ausgabedatei des Berichts.

  7. Speichern Sie den Bericht lokal in Ihrem Dateisystem.

    Benennen Sie die heruntergeladene Ausgabedatei in Appname.csv um, wobei Appname der gewünschte Anwendungsname für die Datenquellenanwendung in der Komponente Datenintegration ist, der für den BI Publisher-Berichtsextrakt steht.

  8. Wählen Sie auf der Homepage der Komponente Datenintegration unter Aktionen die Option Anwendungen aus.

  9. Klicken Sie auf der Seite Anwendungen auf Das Bild zeigt die Schaltfläche "Hinzufügen". (Symbol "Hinzufügen").

  10. Wählen Sie unter Kategorie die Option Datenquelle aus.

  11. Wählen Sie unter Typ die Option Oracle ERP Cloud (Benutzerdefiniert) aus.

    Das Bild zeigt

  12. Klicken Sie unter Datei auf Das Bild zeigt das Durchsuchen-Symbol, und navigieren Sie zu dem Ordner, in dem Sie die CSV-Datei gespeichert haben. Wählen Sie die Datei aus, und klicken Sie auf OK.

    Das Bild zeigt

    Der Bericht wird als Zielanwendung gespeichert, und der Anwendungsname wird automatisch aufgefüllt.

  13. Geben Sie unter Präfix ein Präfix an, um den Anwendungsnamen eindeutig zu machen.

    Das Präfix wird mit dem Dateinamen verkettet, sodass ein eindeutiger Anwendungsname entsteht. Beispiel: Wenn Sie einer Anwendung denselben Namen wie einer bereits vorhandenen Anwendung geben möchten, können Sie Ihre Initialen als Präfix zuweisen.

  14. Klicken Sie auf OK.

  15. Klicken Sie auf Speichern.

    Die Komponente Datenintegration registriert die Anwendung und gibt alle Spalten unter "Dimensionsdetails" zurück.

  16. Klicken Sie auf der Seite Anwendung neben der Datenquellenanwendung auf Das Bild zeigt das Symbol "Auswählen"., und wählen Sie Anwendungsdetails aus.

  17. Geben Sie unter Verbindungsname den Namen des Quellsystems an.

    Beispiel: Wenn der Name Ihres Quellsystems "ERP Cloud" lautet, geben Sie ERP Cloud an.

    Sie können auch einen Oracle ERP Cloud- oder den Hauptbuch-Quellsystemnamen verwenden oder einen neuen Namen definieren.

  18. Ausführungsmethode - Geben Sie die Methode zur Ausführung des Jobs an.

    Gültige Optionen:

    • BIP-Bericht - Führt den BI Publisher-Bericht im synchronen Modus aus, der in der Oracle ERP Cloud-Instanz einen Timeoutgrenzwert von etwa 5 Minuten aufweist. Diese Methode eignet sich für kleinere Datasets oder für Abfragen, die schnell ausgeführt werden.

    • ESS-Job - Führt den BI Publisher-Bericht im asynchronen Modus ohne Timeouteinschränkungen aus.

  19. Berichtsname - Geben Sie den Namen des Berichts und den vollständigen Berichtspfad ein, wenn die Ausführungsmethode BIP-Bericht lautet. Beispiel: Geben Sie /Custom/MyReport.xdo ein. Geben Sie in diesem Feld keinen Wert ein, wenn die Ausführungsmethode ESS-Job lautet.

    Wenn Sie den Namen des Berichts in Oracle ERP Cloud suchen müssen, führen Sie die folgenden Schritte aus:

    1. Navigieren Sie zu Oracle ERP Cloud, suchen Sie den Bericht, und wählen Sie Berichte und Analysen aus, um die Parameterinformationen abzurufen.

      Das Bild zeigt die ausgewählte Option "Berichte und Analysen".

    2. Klicken Sie auf Katalog durchsuchen.

    3. Suchen und wählen Sie das Extrakt oder den Bericht aus.

      Das Bild zeigt die Suche nach dem Saldenbilanzbericht.

    4. Klicken Sie auf Mehr, Eigenschaften.

      Das Bild zeigt das Fenster "Eigenschaften".

    5. Scrollen Sie im Abschnitt Benutzerdefinierte Eigenschaften zum Feld Pfad.

    6. Kopieren Sie den Pfad (und den Namen), und fügen Sie ihn im Feld Berichtsname ein, wenn Sie die Zielanwendung in der Komponente Datenintegration registrieren.

  20. Kehren Sie zur Komponente Datenintegration zurück, und geben Sie unter Berichtsparameterliste die Berichtsparameter der benutzerdefinierten Abfrage an.

    Wenn Sie Berichtsparameter identifizieren müssen, führen Sie die folgenden Schritte aus:

    1. Navigieren Sie zu Oracle ERP Cloud, wählen Sie auf der Seite Überblick den Bericht aus, und klicken Sie auf Erneut weiterleiten.

      Mit diesem Schritt können Sie die im BI Publisher-Extrakt oder -Bericht definierten Berichtsparameter anzeigen und erfassen.

      Das Bild zeigt die erneute Weiterleitung des Berichts auf der Seite "Überblick".

      Eine Liste der Berichtsparameter wird generiert.

      Das Bild zeigt die Liste der Parameter.

    2. Kopieren Sie die im Fenster Warnungen angezeigten Berichtsparameter.

      Hinweis:

      Wenn der Parameter "#NULL" (Null) als BI Publisher-Parameter von Oracle ERP Cloud an EPM Cloud übergeben wird, führt der Parameter "#NULL" zu einem Fehler im adapterbasierten ERP-Framework.

      Um dieses Problem zu beheben, entfernen Sie alle Parameter mit dem Wert "#NULL" aus der Parameterliste, und lassen Sie den Wert einfach leer. Entfernen Sie auch die Leerzeichen.

      Beispiel:

      Wenn Ihre aktuellen Parameter wie folgt angezeigt werden:

      argument1=30029384;argument2=#NULL;argument3=01-JAN-2022

      Dann ändern Sie argument2=#NULL wie folgt:

      argument1=30029384;argument2=;argument3=01-JAN-2022

    3. Navigieren Sie zur Komponente Datenintegration, und fügen Sie die Berichtsparameterliste aus dem Fenster Warnungen in das Feld Berichtsparameterliste Ihrer benutzerdefinierten Abfrage ein.

      Geben Sie unbedingt eine zufällige Zeichenfolge, z.B. "ABC", in der Berichtsparameterliste an, die an den von Ihnen in der Berichtsdefinition erstellten Bind-Parameter übergeben wird. Wenn Sie einen Bericht mit einer Abfrage erstellen, die keine von EPM Cloud übergebenen Bind-Parameter enthält, ist der Prozess in EPM Cloud nicht erfolgreich.

  21. Richten Sie in der Komponente Datenintegration die Integrationszuordnung zwischen der Oracle ERP Cloud-Datenquelle und der Zielanwendung ein, indem Sie ein Importformat erstellen.

    Informationen hierzu finden Sie unter Dimensionen zuordnen.

  22. Definieren Sie die Location zum Zuordnen des Importformats.

  23. Ordnen Sie Elemente aus der Quelle dem Ziel zu.

    Informationen hierzu finden Sie unter Elemente zuordnen.

  24. Wählen Sie Quell- und Zieloptionen aus.

    Informationen hierzu finden Sie unter Datenintegrationsoptionen festlegen.

  25. Führen Sie die Integration aus.

    Informationen hierzu finden Sie unter Integrationen ausführen.