EBS-Connector-Parallelitätsprogramme in Jitterbit Design Studio

Die im Oracle EBS Connector verfügbaren EBS-Parallelitätsprogramme ermöglichen Ihnen, vorhandene parallele Oracle EBS-Programme zu verwenden, um auf Oracle EBS-Daten und-Funktionen zuzugreifen. Dadurch kann Jitterbit Oracle-Schnittstellentabellen füllen, parallele Programme ausführen und Statusinformationen zur Ausführung abrufen. Mit dieser Aktivität können Sie das Integrationsrepository auf das Schema der Schnittstellentabellen für die ausgewählten parallelen Programme sowie auf die Parameter überprüfen, die zur Ausführung des parallelen Programms erforderlich sind.

Das hier verwendete Konzept und die Implementierung paralleler Programme sind spezifisch für Oracle-Anwendungen. Weitere Informationen zur Implementierung paralleler Oracle-Programme finden Sie im Oracle EBS System Administrator's Guide - Definieren paralleler Programme und Anforderungen.

Auf dieser Seite wird die Verwendung von EBS-Parallelitätsprogrammen in Jitterbit anhand eines vereinfachten Beispiels beschrieben. Dabei werden zunächst Oracle Schnittstellentabellen über eine JDBC-Datenbankverbindung in Jitterbit mit neuen Kundendaten gefüllt und anschließend ein EBS-Parallelitätsprogramm aufgerufen, um die neu erstellten Daten zu validieren und in Oracle Basistabellen anzuwenden.

Auffüllen von Oracle-Schnittstellentabellen

Bevor Sie ein paralleles Oracle-Programm in einem Jitterbit Operation verwenden, sollten Sie bereits einen Operation eingerichtet haben, der die Daten bereitstellt, auf die Sie mit Ihrer Oracle EBS-Instanz zugreifen möchten. Dies wird durch die von Jitterbit bereitgestellte Standardfunktionalität erreicht und ist nicht Teil des Oracle EBS Connectors.

Beispielsweise beginnt die erste Operation unten mit einer lokalen CSV-Quelle und transformiert dann diese Daten zum Einfügen in eine Oracle EBS-Datenbank. Diese erste Operation füllt im Wesentlichen die Schnittstellentabellen in der Oracle-Datenbank. Die zweite Operation, die ein ausgewähltes Parallelitätsprogramm ausführt, um diese Daten zu validieren und auf Basistabellen anzuwenden, ist Teil des Oracle EBS Connector und wird in den anderen Abschnitten auf dieser Seite behandelt.

Das Verfahren zum Einrichten einer Operation, die Oracle-Schnittstellentabellen füllt, ist nicht spezifisch für den Oracle EBS Connector und kann über eine Transformation eingerichtet werden. Siehe Text-zu-Datenbank-Assistent für detaillierte Anweisungen zu diesem Beispiel. Eine Vielzahl anderer Quellen können ebenfalls zur Bereitstellung der Daten für die Operation verwendet werden.

Im hier verwendeten Beispiel wird das Oracle EBS-Datenbankziel mithilfe des Oracle [JDBC]- Treiber mit denselben Anmeldeinformationen konfiguriert, die für den EBS-Connector-Endpoint verwendet werden. Das konfigurierte EBS-Datenbankziel wird für diesen Operation wie folgt eingerichtet:

Erstellen einer EBS- Operation

Im selben Projekt, in dem Sie die Operation eingerichtet haben, die die Daten für die Oracle Schnittstellentabellen bereitstellt, sollten Sie eine weitere Operation erstellen, die das Parallelitätsprogramm ausführt, um diese Daten zu validieren und auf die Oracle Basistabellen anzuwenden. Die folgenden Schritte führen Sie durch die Erstellung einer neuen Operation für das Parallelitätsprogramm und zeigen, wie Sie nach der Erstellung dieser Operation die Operation verketten, damit sie ausgeführt wird, nachdem die erste Operation erfolgreich abgeschlossen wurde.

1. Innerhalb Ihres Projekts in Jitterbit Studio gibt es mehrere Möglichkeiten, ein neues EBS-Parallelitätsprogramm zu starten. Jede der folgenden Optionen startet den EBS-Parallelitätsprogramm-Assistent, der Sie durch den Prozess führt.

   • Gehen Sie zu Datei > Neu > Konnektoren > Neues EBS-Parallelitätsprogramm.
   • Klicken Sie in der Strukturansicht links unter Konnektoren mit der rechten Maustaste auf die Kategorie Oracle EBS und wählen Sie dann Neues EBS-Parallelitätsprogramm aus.
   • Doppelklicken Sie im Baum links unter Connectors auf die Kategorie Oracle EBS, klicken Sie dann mit der rechten Maustaste auf EBS Concurrency Programs und wählen Sie New EBS Concurrency Program.
   • Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) . Wählen Sie im Popup Oracle EBS und dann EBS Concurrency Program aus.

2. Der Endpoint-Bildschirm des EBS Concurrency Program Wizard sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in dem Sie auf Daten zugreifen möchten. Sie sollten Ihren Endpoint bereits in EBS-Connector Endpoint eingerichtet haben. Verwenden Sie das Dropdown-Menü, um den entsprechenden Endpoint auszuwählen. Klicken Sie auf Weiter, wenn Sie fertig sind.

   

3. Der Katalog-Bildschirm des EBS Concurrency Program Wizard zeigt eine Liste von Kategorien an, die bestimmte parallele Programme enthalten, die in Ihrer Oracle EBS-Instanz verfügbar sind. Diese sind spezifisch für EBS und Sie müssen wissen, unter welcher Kategorie sich Ihr gewünschtes paralleles Programm im EBS-Katalog befindet.

   In diesem Beispiel wählen wir zum Erstellen neuer Kundendaten in der verbundenen Oracle EBS-Instanz die Kategorie „Forderungen“ aus. Klicken Sie dann auf Weiter, um fortzufahren.

   

   Hinweis

   Wenn Sie während der Katalog- und Programmauswahl viele Elemente in Ihrer EBS-Instanz verfügbar haben, müssen Sie möglicherweise einen Moment warten, bis diese geladen sind. Sie können auch einen Elementnamen in das Feld Filter eingeben. Versuchen Sie es mit der Schaltfläche Aktualisieren, wenn die Ergebnisse nicht Ihren Erwartungen entsprechen.

4. Der Bildschirm Programm des Assistenten für parallele EBS-Programme zeigt eine Liste der spezifischen parallelen Programme an, die in der ausgewählten Kategorie verfügbar sind. Diese sind spezifisch für EBS, und Sie müssen wissen, welches parallele Programm Sie verwenden möchten.

   In diesem Beispiel verwenden wir das parallele Programm „RACUST“. Klicken Sie auf Fertig, um fortzufahren.

   

5. Jitterbit erstellt dann eine EBS API Anforderungs- und Antwortstruktur, die die Parameter in Ihrem Parallelprogramm definiert. In Studio sollte eine neue Tab mit dem Namen EBS-Parallelprogramme angezeigt werden. Sie können Ihr Parallelprogramm hier bei Bedarf umbenennen. Sie können auch die Schaltflächen + - oder Pfeile verwenden, um alle Elemente in jeder Struktur zu erweitern.

6. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen, die sich unter In einer Integration verwenden in der oberen rechten Ecke befindet. Dadurch wird die Jitterbit Operation erstellt, die Ihr Parallelitätsprogramm in Oracle EBS verwendet.

7. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung des Parallelitätsprogramms innerhalb einer Jitterbit Operation enthält. Speichern Sie Ihre Operation, indem Sie entweder auf das Symbol für eine einzelne Festplatte klicken, um nur diese Operation zu speichern, oder auf das Symbol für mehrere Festplatten, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass das Sternchen auf der Tab Operationen und der Operation verschwinden, da Ihre neue Operation jetzt erstellt und in Ihrem Projekt gespeichert ist.

8. Wenn Sie eine weitere Operation haben, die die Oracle Schnittstellentabellen füllt, können Sie die beiden Operationen jetzt miteinander verketten. Klicken Sie dazu mit der rechten Maustaste auf den Hintergrund der ersten Operation und wählen Sie Bei Erfolg > Operation > Vorhandenes auswählen. Wählen Sie dann die vorhandene Operation aus, die Sie gerade erstellt haben. In diesem Fall war dies unsere RACUST- Operation, die wir „2. Parallelitätsprogramm ausführen - RACUST“ genannt haben. Die Tab Operationen sollte ungefähr wie die folgende aussehen.

   

   Notiz

   Die Symbole für Quelle, Anforderung, Antwort und Ziel im obigen Bild sind Platzhalter für die Operation, die wir im nächsten Abschnitt definieren werden.

Definieren der Komponenten für gleichzeitige Operation

Als Nächstes müssen wir die anderen Komponenten des gleichzeitigen Operation definieren, einschließlich Quelle, Anforderung, Antwort und Ziel.

Sie können entweder zur grafischen Darstellung der von Ihnen erstellten Operation zurückkehren und auf jedes Symbol doppelklicken, um die einzelnen Komponenten zu konfigurieren, oder Sie können Quelle, Anforderung, Antwort und Ziel separat erstellen und diese dann per Drag & Drop aus der Baumstruktur auf der linken Seite direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen.

Für jede Komponente der Operation können viele verschiedene Datentypen verwendet werden. Weitere Informationen zu zusätzlichen Anpassungsoptionen finden Sie im Design Studio Abschnitt unserer Dokumentation.

• Quelle: Um dieses Beispiel zu vereinfachen, wird die Quelle fest codiert. Daher entfernen wir die Quelle, indem wir mit der rechten Maustaste auf das Quellensymbol im Operation klicken und Aus Diagramm entfernen auswählen.

  Hinweis

  In Jitterbit sind verschiedene Quelltypen verfügbar. Siehe Quellen für mehr.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Um dieses Beispiel zu vereinfachen, geben wir das Ergebnis, den Status und die Phase der Operation in eine XML-Datei aus. Klicken Sie auf die Schaltfläche Neues Ziel erstellen und geben Sie Ihrem Ziel einen Namen (z. B. Beispielziel). Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert, und wählen Sie daher den Typ „Lokale Datei“ aus und navigieren Sie zu einem Speicherort auf dem privaten Agenten, an dem wir die Daten speichern möchten. Geben Sie einen Ordner und Dateinamen ein, den Sie speichern möchten.

  Hinweis

  Sie können auch in eine Vielzahl unterschiedlicher Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp identisch sein. Siehe Ziele für Optionen.

• Anfrage: Doppelklicken Sie auf das Anfrage-Symbol und wählen Sie Neue Transformation erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Anfrage führt.

  Notiz

  Weitere Informationen zu Anfragestrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Quelle, um die Quelle für die Transformation auszuwählen. Im Beispiel ist unsere Quelle fest codiert, daher wählen wir „Keine“ aus. Klicken Sie auf Fertig, um fortzufahren.

  2. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielelemente in jedem Baum zu erweitern. Bei einer Transformation würden Sie jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen ziehen. Um in diesem Beispiel die Quelle fest zu codieren, doppelklicken Sie auf jedes Feld auf der Zielseite und geben Sie die folgenden Werte in das Script ein:

     ZIEL: EBS-Parallelitätsprogramm: RACUST EINGABE > RACUST > HEADER	Script
     BENUTZERNAME	<trans> "SERVICES" </trans>
     VERANTWORTUNG	<trans> "QUICK_CUSTOMER" </trans>
     RESP_ANWENDUNG	<trans> "AR" </trans>
     SICHERHEITSGRUPPE	<trans> "STANDARD" </trans>
     SERVERNAME	<trans> "" </trans>
     ORG_ID	<trans> "204" </trans>

     ZIEL: EBS-Parallelitätsprogramm: RACUST EINGABE > RACUST > PROGRAMM_EINGABEN	Script
     ANWENDUNG	<trans> "AR" </trans>
     PROGRAMM	<trans> "RACUST" </trans>
     BESCHREIBUNG	<trans> "INVENTORY" </trans>
     STARTZEIT	<trans> "" </trans>
     SUB_ANFRAGE	<trans> "" </trans>
     RECIPROCAL_CUSTOMER ERSTELLEN	<trans> "1" </trans>
     ORG_ID	<trans> "204" </trans>

     Nach dem Festcodieren der Quelle sollte Ihre Transformation ungefähr wie unten gezeigt aussehen.

     

• Antwort: Doppelklicken Sie auf das Symbol Antwort und wählen Sie Neue Transformation erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Antwort führt.

  Notiz

  Weitere Informationen zu Antwortstrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Ziel, um das Ziel für die Transformation auszuwählen. Im Beispiel möchten wir die Antwort von EBS verwenden, also wählen wir „Oracle EBS Function Response“ aus. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel aus der Dropdown-Liste das Parallelitätsprogramm aus, das Sie bereits eingerichtet haben (z. B. „RACUST“). Im unteren Teil des Bildschirms werden die mit diesem Programm verknüpften Anforderungs- und Antwortstrukturen angezeigt. Klicken Sie auf Fertig, um fortzufahren.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihr Mapping abschließen können. Verwenden Sie das +, um die Quell- und Zielseiten zu erweitern. Klicken Sie auf den Ordner „OUTPUT“ und ziehen Sie ihn von der linken Seite (Quellseite) in den Ordner „OUTPUT“ auf der rechten Seite (Zielseite). Ihr Mapping-Bildschirm sollte nun ungefähr wie unten aussehen.

     

Der endgültige Operation sollte ungefähr wie unten aussehen.

Bereitstellen und Ausführen der Operationen

Nachdem sowohl der Operation zum Einfügen von Daten in die Oracle Schnittstellentabellen als auch der Operation des EBS-Parallelprogramms vollständig konfiguriert sind, können wir mit der einsetzen und Ausführung der Vorgänge beginnen.

1. Klicken Sie in der ersten Operation auf der Tab Operationen auf die einsetzen -Symbol.
2. Klicken Sie dann auf „Ausführen“ , um die Vorgänge zur Ausführung in die Warteschlange zu stellen. Der erste Operation wird zuerst abgeschlossen, gefolgt vom zweiten Operation, der nach erfolgreichem Abschluss des ersten Operation ausgeführt wird.
3. Im unteren Teil des Bildschirms sollte der Operationsmonitor anzeigen, dass Ihre erste Operation erfolgreich ausgeführt wurde. Wenn nicht, können Sie auf das Symbol Status doppelklicken, um alle Protokollmeldungen anzuzeigen. Wenn Sie überprüfen möchten, ob Ihr zweiter Operation auch erfolgreich ausgeführt wurde, können Sie auch mit der rechten Maustaste auf Vorgänge in der Strukturansicht links klicken und Vorgangsprotokoll auswählen, um die Protokolle für alle Vorgänge in Ihrem Projekt anzuzeigen.
4. Sie sollten jetzt auch die Ausgabeantwort sehen, die Ihrer Zieldatei zugeordnet wurde. Im Beispiel wird die XML-Datei jetzt lokal am von Ihnen angegebenen Speicherort erstellt. Da der Operation erfolgreich ausgeführt wurde, wird als Ergebnis „Erfolgreich“, als Status „Normal“ und als Phase „Abgeschlossen“ angezeigt.