Zum Inhalt springen

Jitterbit Design Studio SAP Event Listener

Übersicht

Der Jitterbit SAP Event Listener ist eine lokal installierte Anwendung, die auf IDocs lauscht, die von SAP ausgehen. Die Konfiguration erfordert die Verwendung des SAP-Connectors für Jitterbit Design Studio, um ein SAP IDoc Event als Teil eines Design Studio-Vorgangs zu konfigurieren. Nach der vollständigen Konfiguration des SAP Event Listener lösen die empfangenen IDocs den Design Studio-Vorgang aus.

Voraussetzungen

Um den SAP Event Listener zu verwenden, müssen alle Voraussetzungen des SAP-Connectors erfüllt sein, wie unter Voraussetzungen im SAP-Connector beschrieben.

Falls man unserer Empfehlung folgt und den SAP Event Listener auf einem privaten Agent installiert, müssen alle Voraussetzungen eines privaten Agents erfüllt sein, wie unter Systemanforderungen für private Agents beschrieben.

Diese spezifischen Voraussetzungen für den SAP Event Listener müssen ebenfalls erfüllt sein:

  • Das SAP-System muss konfiguriert werden mit einem RFC-Ziel, einem transaktionalen RFC-Port (tRFC) und einem Partnerprofil zur Verwendung durch den Jitterbit SAP Event Listener.
  • Der SAP Event Listener muss installiert werden auf einem Computer, der diese Anforderungen erfüllt:
  • Der SAP Event Listener muss konfiguriert werden, um einen privaten Agent zu verwenden. Es wird empfohlen, den SAP Event Listener auf demselben Computer wie einen privaten Agent zu installieren.
  • Damit der SAP Event Listener hochverfügbar ist, muss bei mehr als einem privaten Agent in einer privaten Agent-Gruppe eine Instanz des SAP Event Listener auf genau die gleiche Weise auf jedem Agent in der Gruppe installiert und konfiguriert werden.
  • Bei Verwendung von SAP S/4HANA Single-Tenant ist SAP Event Listener Version 8.29.2.3 oder später erforderlich. (SAP ECC wird ohne Mindestversion unterstützt.)
  • Design Studio Version 8.29.2.8 oder später ist erforderlich, um den SAP Event Listener zu konfigurieren und zu verwenden.

Erste Schritte

Der Leitfaden für die ersten Schritte mit dem SAP Event Listener bietet eine Zusammenfassung und empfohlene Reihenfolge der Installations- und Konfigurationsschritte für die Verwendung des SAP Event Listener sowie eine Beschreibung, wie Harmony und der SAP Event Listener IDoc-Events verarbeiten.

Unterstützte RFC-Protokolle

Der SAP Event Listener unterstützt die transaktionalen RFC (tRFC) und Queued RFC (qRFC) Protokolle:

  • Transaktionale RFCs
    • Ein tRFC-Funktionsaufruf wird im Zielsystem genau einmal ausgeführt.
    • Das System prüft, ob eine TID (eindeutige Transaktionskennung) bereits verarbeitet wurde. Falls ja, wird der tRFC-Funktionsaufruf ignoriert.
    • Wenn das Zielsystem zum Zeitpunkt des Aufrufs nicht verfügbar ist, versucht der SAP-Connector weiterhin, die Transaktion zu verarbeiten. Der SAP-Connector verarbeitet auch weiterhin andere tRFC-Funktionsaufrufe.
    • Die Reihenfolge, in der die tRFC-Funktionsaufrufe verarbeitet werden, ist nicht garantiert.
  • Queued RFCs
    • Jeder qRFC-Funktionsaufruf wird in eine Ausgangswarteschlange eingefügt, die in einer bestimmten Reihenfolge verarbeitet wird.
    • Ein qRFC-Funktionsaufruf kann nicht ausgeführt werden, bis alle seine Vorgänger in der Warteschlange verarbeitet wurden. Ein qRFC-Funktionsaufruf wird nur übertragen, wenn er keine Vorgänger in der beteiligten Warteschlange hat.
    • Nach der Ausführung eines qRFC-Funktionsaufrufs versucht das System, die nächste qRFC-Transaktion in der Reihenfolge aus der Warteschlange zu starten.
    • Ein Warteschlangennamen und ein Warteschlangenzähler sind für jede qRFC-Transaktion zur Warteschlangenverwaltung erforderlich. Jeder qRFC-Aufruf, der chronologisch verarbeitet werden soll, wird einem Warteschlangennamen zugewiesen.

Bekanntes Problem

Die neueste Version des SAP Event Listener weist folgendes bekanntes Problem auf:

  • SAP Event Listener: Die Windows-Konfigurationsoberfläche kann nicht geöffnet werden

    • Zusammenfassung: Beim Versuch, die Windows SAP Event Listener-Konfiguration über die Benutzeroberfläche zu öffnen, tritt eine Ausnahme auf.

    • Zusätzliche Informationen: Dieses Problem tritt auf, wenn eine zuvor gespeicherte Konfiguration, die die erforderlichen äußeren Tags <events> und </events> im Feld Event Details enthält, später versehentlich ohne diese Tags gespeichert wurde.

    • Behebung: Bearbeiten Sie die Konfigurationsdatei unter C:\ProgramData\JitterbitSAPEventListener\conf\sapeventconfig.xml manuell, um die erforderlichen äußeren Tags zu ersetzen. Die Windows-Konfigurationsoberfläche kann nun wieder geöffnet werden.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in folgendem Abschnitt im Design Studio-Fehlerbehebungsleitfaden: