Anlegen von Event-Handlern 

Verwendung

Sie verwenden Event-Handler, um Objekte oder Prozesse verfolgen und bewerten zu können, die Sie als Supply-Chain-Event-Management-relevant bestimmt haben.

In SAP Event Management werden Event-Handler auf verschiedene Weise angelegt:

●      Die Anwendungsschnittstelle legt zu Applikationsobjekten Event-Handler an.

●      Das Senden einer Ereignisnachricht legt einen Event-Handler an.

●      Das Applikationssystem ruft ein Business Application Programming Interface (BAPI) auf. Dieses stößt das Anlegen eines Event-Handlers in SAP Event Management an.

Zur Kontrolle der Bearbeitung von Ereignisnachrichten für einen Event-Handler benötigt das System die dem Event-Handler zugehörigen erwarteten Ereignisse und das dem Event-Handler zugehörige Regelwerk, entsprechend den Einstellungen aus dem Customizing in SAP Event Management.

Wenn Sie zu reinen Testzwecken Funktionen in SAP Event Management testen und kein zugehöriges Applikationssystem einstellen möchten, steht Ihnen die Transaktion /SAP/TRX/EH_CREATE zur Verfügung.

Weitere Informationen über das manuelle Anlegen von Event-Handlern zu Testzwecken finden Sie auf dem SAP Service Marketplace unter http://service.sap.com/scm → Supply Chain Event Management → Detailed Information.

Integration

Sie können abhängig von den Objekten, die Sie verfolgen möchten und den daran beteiligten Partnern, unterschiedliche Event-Handler durch die Anwendungsschnittstelle anlegen.

Zum Beispiel können Sie die erwarteten Ereignisse nach der Zuliefererqualität definieren. Der Event-Handler für einen unzuverlässigen Zulieferer hat eine umfangreichere Liste von erwarteten Ereignissen, die der Zulieferer melden muss, als der Event-Handler eines zuverlässigeren Zulieferers (siehe auch Verarbeitung von Ereignisnachrichten).

Datenkommunikation für das Anlegen von Event-Handlern

Folgende Daten werden aus dem Applikationssystem über die Anwendungsschnittstelle an SAP Event Management für das Anlegen eines Event-Handlers übergeben:

●      Hauptidentifikationen für das Applikationsobjekt (Applikationssystem, Applikationsobjektart, Applikationsobjekt-ID)

●      Parametersatz

○       Kontrollparameter

○       Tracking-IDs

○       Infoparameter

○       Erwartete Ereignisse

○       Abfrage-IDs

○       Messdaten

Voraussetzungen

●      Sie haben im Applikationssystem Folgendes festgelegt

○       die Applikationsobjektarten

○       die Bedingung für die Bestimmung der Applikationsobjektart

○       die Funktion zur Bestimmung der erwarteten Ereignisse

○       die Kontrol-, System- und Infoparameter (siehe Parameter)

●      Sie haben in SAP Event Management Folgendes festgelegt

○       die Event-Handler-Arten

○       die Bedingung für die Bestimmung der Event-Handler-Art

¡        das Profil der erwarteten Ereignisse

○       das Profil der Parameter

○       das Profil der Statusattribute

○       das Regelwerk

●      Sie haben das Customizing für die Anwendungsschnittstelle eingestellt und den entsprechenden Visibility-Prozess für die Prozesstransparenz im Applikationssystem installiert oder einen eigenen Prozess definiert. Der VisibilityProzess ermöglicht Ihnen die Anbindung an Ihre Business-Objekte im Applikationssystem.

●      Sie haben die RFC-Verbindungen eingestellt, die die Verbindung zwischen dem Applikationssystem und SAP Event Management herstellen.

●      Sie haben Folgendes für das Anlegen eines Event-Handlers durch eine Ereignisnachricht definiert:

○       die Kriterien

○       die Plug-In-Funktionsbausteine

Weitere Informationen über die Definition der Kriterien und Plug-In-Funktionsbausteine finden Sie im Customizing für SAP Event Managements unter Ereignisnachrichten, Statusabfragen und Webschnittstelle → Kriterien für Ereignisnachrichtenverarbeitung definieren.

Aktivitäten

Das Anlegen eines Event-Handlers beginnt, sobald Sie einen Beleg im Applikationssystem sichern.

Die Schritte zum Anlegen eines Event-Handlers sind zwischen dem Applikationssystem und SAP Event Management aufgeteilt.

...

       1.      Sie sichern Ihren Beleg im Applikationssystem.

       2.      Das Applikationssystem führt Folgendes aus:

...

                            a.      Es extrahiert den Datencontainer des Business-Objekts, sodass SAP Event Management einen Event-Handler mit der dazugehörigen Event-Handler-Art anlegen kann.

                            b.      Es bestimmt das zuständige SAP Event Management für die Applikationsobjektart. (Ein Applikationssystem kann gleichzeitig mit mehreren SAP Event Management zusammenarbeiten.)

                            c.      Es bestimmt die Geschäftsprozessart (GPA) des Business-Objekts.

                            d.      Es holt die Applikationsobjektarten für die GPA aus dem Applikationssystem und bestimmt, ob sie Supply-Chain-Event-Management-relevant (SCEM-relevant) sind.

                            e.      Es erstellt die Kontrollparameter für alle Applikationsobjekte, die SCEM-relevant sind.

                              f.      Es überprüft, ob SAP Event Management einen oder mehrere Event-Handler anlegen kann.

       3.      SAP Event Management führt Folgendes aus:

...

                            a.      Es generalisiert die aus dem Applikationssystem gesendeten Kontrollparameter, sodass es sie verarbeiten kann.

                            b.      Es überprüft, ob bereits passende Event-Handler vorhanden sind.

Wenn es keinen passenden findet, fährt es mit der Überprüfung für die Erzeugung eines Event-Handlers fort.

Wenn es einen passenden findet, verwendet es diesen und führt eine Event-Handler-Aktualisierung durch.

                            c.      Es überprüft, ob es den Event-Handler erzeugen kann.

                            d.      Es sendet das Ergebnis der Überprüfung an das Applikationssystem.

       4.      Das Applikationssystem fährt mit der Bearbeitung für bestätigte Applikationsobjekte fort.

       5.      Das Applikationssystem führt im weiteren Prozessverlauf Folgendes aus:

...

                            a.      Es sammelt alle Daten aus den Parametercontainern (Kontroll-, Informationsparameter, erwartete Ereignisse, Tracking-IDs, Abfrage-IDs, Business-Objekt-Schlüssel).

                            b.      Es sendet die Vormerkung zum Senden der gesammelten Daten an SAP Event Management. (Das Applikationssystem sendet die Daten erst, wenn es den Sicherungsprozess fortführt. Siehe auch Schritt 5e)

                            c.      Es merkt die Statusfortschreibung für offene Kommunikationsprozesse in der Statustabelle vor. (Das Applikationssystem führt die Statusfortführung erst aus, wenn es den Sicherungsprozess fortführt. Siehe auch Schritt 5e)

                            d.      Es merkt die Fortschreibung des Applikationsprotokolls vor. (Das Applikationssystem führt die Fortschreibung des Applikationsprotokolls erst aus, wenn es den Sicherungsprozess fortführt. Siehe Schritt 5e)

                            e.      Es kehrt zum Sichern des Business-Objekts zurück. Alle Vormerkungen im Applikationssystem werden ausgeführt.

       6.      Gleichzeitig bestimmt SAP Event Management die Event-Handler-Art und legt einen Event-Handler mit den dazugehörigen erwarteten Ereignissen und Statusattributen an. Dafür führt SAP Event Management Folgendes aus:

○       Es generalisiert die Daten aus den Parametercontainern des Applikationssystems (siehe Schritt 5a), sodass es sie verarbeiten kann.

○       Es ruft die Aktivitäten zur Prozessaktualisierung auf.

○       Es sendet die Bestätigung für beendete Transaktionen an das Applikationssystem.

Anlegen eines Event-Handlers durch eine Ereignisnachricht

●      Das Anlegen eines Event-Handlers beginnt, sobald Sie eine Ereignisnachricht an SAP Event Management senden. Die Ereignisnachricht muss dafür den vordefinierten Kriterien entsprechen.

●      Das Plug-In-Funktionsmodul legt einen Event-Handler an und SAP Event Management verarbeitet die Ereignisnachricht.

Sie geben in der Ereignisnachricht folgende Daten an, damit der Plug-In-Funktionsbaustein den Event-Handler anlegen kann

●      das Applikationssystem

●      die Applikationsobjektart

●      die Kontrollparameter

●      die Infoparameter

●      die Tracking-IDs

●      die Daten der Meilensteine aus der Ereignisnachricht für die erwarteten Ereignisse