Zum Inhalt springen

Erste Schritte mit Jitterbit Design Studio SAP Event Listener

Einführung

Dieses Handbuch fasst die Konfigurationsschritte zusammen, die für die Verwendung des SAP Event Listener erforderlich sind, und beschreibt, wie Harmony und der SAP Event Listener IDoc-Ereignisse verarbeiten.

Schritte für die ersten Schritte

Verwenden Sie die folgenden Schritte als Leitfaden für die empfohlene Reihenfolge, in der die Einrichtung des SAP -Ereignislisteners abgeschlossen werden muss. Diese Schritte enthalten Links zu anderen Seiten innerhalb des SAP -Ereignislisteners Abschnitt der Dokumentation, der zusätzliche Details und Anweisungen enthält.

1. Konfigurieren des SAP -Systems

Ein SAP Administrator muss das SAP System wie unter SAP Ereignislistener SAP -Systemkonfiguration beschrieben konfigurieren. Als Teil dieses Prozesses konfigurieren sie das Jitterbit-RFC-Ziel, erstellen einen tRFC Port (der tRFC- Port wird sowohl für tRFC- als auch für qRFC-Funktionsaufrufe verwendet) und richten Jitterbit als SAP Partner ein.

In dieser Phase des Konfigurationsprozesses kann ein SAP Administrator die Verbindung innerhalb des SAP -Systems nicht erfolgreich testen, da zum Herstellen der Konnektivität zusätzliche Konfigurationen außerhalb des SAP -Systems erforderlich sind.

2. Herunterladen der SAP JCo SDK-Dateien

Ein SAP Benutzer muss die SAP Java Connector (SAP JCo) 3.1 SDK-Dateien von der SAP -Seite SAP Java Connector herunterladen unter dem Abschnitt Java Connector 3.1 SDK herunterladen (Anmeldung bei SAP erforderlich). Diese Dateien werden während der Installation der SAP Event-Listener-Anwendung benötigt, wie unter Herunterladen erforderlicher Komponenten beschrieben in SAP Ereignislistener-Installation.

3. Installieren der SAP JCo SDK-Dateien

Ein Benutzer mit Zugriff auf jeden Rechner, auf dem der SAP Event Listener installiert werden soll, muss die entsprechenden JCo SDK-Dateien wie unter Erforderliche Komponenten installieren beschrieben installieren in SAP Ereignislistener-Installation.

4. Herunterladen des SAP Event-Listeners

Ein Harmony Benutzer muss den SAP Event Listener von den Harmony Portal-Downloads herunterladen wie unter Herunterladen des SAP Ereignislisteners beschrieben in SAP Ereignislistener-Installation.

5. Installieren des SAP Event-Listeners

Ein Benutzer mit Zugriff auf jeden Rechner, auf dem der SAP Event Listener installiert werden soll, muss die SAP Event Listener-Anwendung wie unter Installation des SAP Event Listener beschrieben installieren. Während des Installationsvorgangs werden Sie aufgefordert, den SAP Event Listener zu konfigurieren, wie im nächsten Schritt beschrieben.

6. Konfigurieren des SAP Ereignislisteners

Ein Benutzer mit Zugriff auf jeden SAP Event Listener-Rechner muss die SAP Event Listener-Anwendung wie unter SAP Event Listener-Konfiguration beschrieben konfigurieren.

In dieser Phase des Konfigurationsprozesses kann der Abschnitt Ereignisdetails der SAP Ereignislistener-Konfiguration nicht abgeschlossen werden, da zusätzliche Konfigurationen außerhalb der SAP -Ereignislistener-Konfiguration erforderlich sind, um die Eingabe für dieses Feld zu erhalten. Lassen Sie den Abschnitt Ereignisdetails der Konfiguration leer, bis Sie in einem späteren Schritt dazu aufgefordert werden.

Sie müssen außerdem den SAP -Gateway-Port zur services Datei, sofern nicht bereits vorhanden.

Anschließend können Sie die Verbindung innerhalb der SAP Event Listener-Konfiguration testen und überprüfen, ob der SAP Event Listener-Dienst ausgeführt wird. Der Dienst sollte ausgeführt werden, auch wenn noch keine Ereignisdetails eingegeben wurden.

7. Aktivieren von SAP IDoc-Ereignissen im Design Studio

Ein Harmony-Benutzer, der das Integrationsprojekt entwirft, muss in der Design Studio Anwendung eine Einstellung aktivieren, die die Konfiguration von SAP IDoc-Ereignissen ermöglicht, wie unter Aktivieren von SAP IDoc-Ereignissen beschrieben in SAP Ereignislistener Design Studio konfigurieren und verwenden.

8. Erfassung von Veranstaltungsdetails

Ein Harmony-Benutzer, der das Integrationsprojekt entwirft, muss für jedes Ereignis in Design Studio eine SAP IDoc-Operation erstellen, um die Ereigniskonfiguration abzurufen, die zum Abschließen der SAP Event Listener-Konfiguration erforderlich ist. Dies wird unter Erstellen einer SAP IDoc-Operation und Abrufen von Ereignisdetails beschrieben in SAP Ereignislistener Design Studio konfigurieren und verwenden.

9. Konfiguration des SAP Event Listener abschließen

Ein Benutzer mit Zugriff auf jeden SAP Event Listener-Rechner muss die Konfiguration der SAP Event Listener-Anwendung abschließen, indem er die im vorherigen Schritt erhaltenen Ereigniskonfigurationen in das Feld Ereignisdetails der SAP Event Listener-Konfiguration eingibt. Die Ereignisdetails werden in den SAP Ereignisverbindungseigenschaften eingegeben der SAP Ereignislistener-Konfiguration.

10. Neustart des SAP Event-Listener-Dienstes

Ein Benutzer mit Zugriff auf jeden SAP Event Listener-Rechner muss den SAP Event Listener-Dienst nach Konfigurationsänderungen neu starten, wie unter Neustart des SAP Event Listener-Dienstes beschrieben in SAP Ereignislistener-Installation.

11. Überprüfen der Konnektivität mit dem SAP -Ereignislistener

Ein SAP Administrator sollte die Konnektivität zwischen dem SAP -Gateway und dem SAP -Event-Listener überprüfen, indem er die Verbindung des konfigurierten RFC-Ziels testet. Dies wird in Überprüfen der Konnektivität mit dem SAP Event-Listener beschrieben in SAP Ereignislistener SAP -Systemkonfiguration.

Grundlegendes zur IDoc-Ereignisverarbeitung

In diesem Abschnitt wird beschrieben, wie Harmony und der SAP Ereignislistener jedes IDoc-Ereignis verarbeiten, je nachdem, ob das Queue-RFC-Protokoll (qRFC) oder das Transactional-RFC-Protokoll (tRFC) verwendet wird. Die im SAP RFC-Ziel konfigurierte Programm-ID wird von Harmony und dem SAP Ereignislistener zum Empfangen des IDoc-Ereignisses verwendet.

Verarbeitung von qRFC IDoc-Ereignissen

Wenn qRFC-IDocs von SAP an eine registrierte Serverprogramm-ID gesendet werden, empfangen die Harmony Operationen die IDocs in der Reihenfolge für diese bestimmte Warteschlange. Die Harmony-Operationen schließen die Verarbeitung der qRFC-IDocs auch in der Reihenfolge ab, in der die IDocs empfangen wurden.

Die Verarbeitung der qRFC-IDoc-Ereignisse erfolgt in dieser Reihenfolge:

  1. SAP sendet das erste qRFC-IDoc für eine Programm-ID über den SAP Event-Listener. Harmony blockiert das Senden eines weiteren qRFC-IDocs durch SAP, bis der Operation die Verarbeitung des aktuellen qRFC-IDocs erfolgreich abgeschlossen hat.
  2. Harmony sendet erst dann eine Erfolgsmeldung, wenn der Operation erfolgreich abgeschlossen wurde. Die Erfolgsmeldung wird über den SAP Event Listener an SAP gesendet.
  3. Sobald SAP eine Erfolgsmeldung für das erste qRFC-IDoc empfängt, wird das nächste qRFC-IDoc in der Sequenz für die Programm-ID an den SAP -Event-Listener gesendet.
  4. Wenn die Operation des qRFC-IDocs fehlschlägt, sendet Harmony eine Fehlermeldung über den SAP Ereignislistener an SAP. SAP sendet das qRFC-IDoc erneut, bis eine Erfolgsmeldung vom SAP Ereignislistener eingeht.
  5. Der SAP Event Listener empfängt das nächste qRFC-IDoc, das sich auf die Queue-/Programm-ID bezieht, von SAP erst, nachdem das vorherige IDoc erfolgreich verarbeitet wurde. Der SAP Event Listener empfängt jedoch andere Nachrichten zur Verarbeitung, die zu einer anderen Queue-/Programm-ID gehören.

Wenn der SAP Event Listener während der Verarbeitung eines qRFC-IDocs ausfällt oder gestoppt wird, erhält der SAP Event Listener keine Erfolgs- oder Fehlermeldung. Sie können in den Protokolldateien überprüfen, ob das letzte qRFC-IDoc erfolgreich verarbeitet wurde:

  • Wenn das qRFC-IDoc erfolgreich von Harmony verarbeitet wurde, stellen Sie sicher, dass alle fehlgeschlagenen Nachrichten für dieses qRFC-IDoc aus SAP gelöscht werden, bevor Sie den SAP -Ereignislistener neu starten.
  • Wenn der qRFC-IDoc-Operation nicht erfolgreich abgeschlossen wurde, wartet SAP bereits im Fehlerzustand. In diesem Fall starten Sie den SAP Ereignislistener neu, und SAP sendet das vorherige qRFC-IDoc erneut bzw. versucht, es zu verarbeiten.

Verarbeitung von tRFC-IDoc-Ereignissen

Wenn tRFC-IDocs von SAP an eine registrierte Server-Programm-ID gesendet werden, schließen Harmony Operationen die Verarbeitung der tRFC-IDocs in beliebiger Reihenfolge ab. Die tRFC-IDocs werden parallel über alle verfügbaren SAP Event Listener- und privaten Agent-Installationen hinweg verarbeitet.

Wenn die Verarbeitung eines tRFC- Operation fehlschlägt, kann der SAP Ereignislistener dennoch andere tRFC-IDocs von SAP empfangen und der private Agent kann den Vorgang abschließen.

Der SAP Event Listener stellt jederzeit sicher, dass fehlgeschlagene tRFC-IDocs in SAP gespeichert werden.

Wenn der SAP -Event-Listener auf mehreren privaten Agenten in einer privaten Agentengruppe konfiguriert ist und SAP ein tRFC-IDoc an eine beliebige registrierte Programm-ID sendet, empfängt nur eine der SAP -Event-Listener-Instanzen das IDoc.

Wenn beispielsweise fünf tRFC-IDocs von SAP gepusht werden, können alle fünf IDocs vom selben SAP Event-Listener empfangen werden, oder die fünf IDocs können auf mehrere SAP Event-Listener-Instanzen verteilt werden.