Alert in Integrationsprozess auslösen 

Verwendung

In der Definition eines Integrationsprozesses können Sie festlegen, dass zur Laufzeit beim Eintreten einer bestimmten Situation ein Alert über das Alert Management ausgelöst wird. Dazu fügen Sie an der gewünschten Stelle im Prozess einen Steuerungsschritt ein.

Löst der Steuerungsschritt zur Laufzeit den Alert aus, stellt das Alert Management dem entsprechenden Benutzer den Alert zu. Der Prozess wird nicht abgebrochen, sondern nach dem Steuerungsschritt fortgesetzt. Der über den Alert informierte Benutzer muss entscheiden, ob und wie er in den Prozess eingreift.

Für einen Überblick über das Alert Management siehe Alert Management.

Vorgehensweise

Alert-Kategorie definieren oder auswählen

Ein Alert hat zwei Texte: einen Kurztext und einen Langtext. Der Kurztext des Alerts zeigt zur Laufzeit automatisch die ID der Prozessinstanz. Den Langtext können Sie in der Alert-Kategorie oder im Steuerungsschritt festlegen.

       1.      Wählen Sie die Transaktion ALRTCATDEF.

       2.      Prüfen Sie, ob Sie eine bestehende Alert-Kategorie verwenden können oder definieren Sie eine neue.

Siehe auch: Defining Alert Categories

       3.      Entscheiden Sie, ob Sie den Langtext für den Alert in der Alert-Kategorie oder im Steuerungsschritt festlegen möchten.

Wenn Sie den Langtext im Steuerungsschritt angeben möchten, müssen Sie in der Definition der Alert-Kategorie das Feld Dynamischer Text markieren.

       4.      Merken Sie sich den Namen der Kategorie, da Sie diesen später im Prozess-Editor eingeben müssen. 

E-Mail-Adressen definieren

...

Wenn das Alert Management den Alert per E-Mail zustellen soll, müssen Sie auf dem Integration Server die E-Mail-Adressen für Sender und Empfänger definieren:

       1.      Öffnen Sie auf dem Integration Server die Benutzerpflege (Transaktion SU01).

Siehe auch: Benutzerstammsätze anlegen und pflegen

       2.      Definieren Sie als E-Mail-Adresse des Senders die E-Mail-Adresse des Workflow-Hintergrundbenutzers. Dies ist in der Regel WF-BATCH.

       3.      Definieren Sie die E-Mail-Adresses des Empfängers.

Steuerungsschritt für Alert definieren

...

       1.       Öffnen Sie den Integrationsprozess, der den Alert auslösen soll, im Prozess-Editor.

       2.      Fügen Sie an der gewünschten Stelle im Integrationsprozess einen Steuerungsschritt ein.

       3.      Wählen Sie für die Eigenschaft Aktion den Eintrag Alert auslösen.

       4.      Geben Sie für die Eigenschaft Alert-Kategorie die gewünschte Alert-Kategorie aus dem Alert Management an.

       5.      Möchten Sie den Text, der als Alert ausgegeben wird, im Steuerungsschritt festlegen, geben Sie für die Eigenschaft Alert-Nachricht den gewünschten Text ein.

Voraussetzung für die Anzeige dieses Textes ist, dass Sie in der Definition der Alert-Kategorie das Feld Dynamischer Text markiert haben.

Variablen im Alert-Text verwenden

Um den Langtext für den Alert aussagekräftiger zu gestalten, können Sie im Alert-Text Variablen verwenden. Diese können Sie z. B. mit Werten aus der Message-Payload füllen.

...

       1.      Definieren Sie das Containerelement, das den Wert für die Variable liefert, im Prozesscontainer.

Geben Sie für das Containerelement einen einfachen xsd-Datentyp an. Sie können keine Tabellen in Alerts einbinden.

       2.      Definieren Sie eine Containeroperation, die den Wert der Variablen setzt.

Siehe auch: Containeroperation

       3.      Geben Sie Variable im Alert-Text des Steuerungsschritts gemäß folgender Syntax an:

Für Containerelemente: &variable& 

Für Werte aus der Message-Payload geben Sie den Pfad zu dem gewünschten Feld an:  &message.PAYLOAD.attribute&

Beispiel

Folgendes Beispiel zeigt einen Alert-Text mit zwei Variablen:

●     Definition des Alert-Texts im Steuerungsschritt:

Anzahl &price& übersteigt Obergrenze von &limit&

price und limit sind im Prozesscontainer definiert.

●     Anzeige des Alert-Texts zur Laufzeit:

Anzahl 5000 übersteigt Obergrenze von 2000

Folgendes Beispiel zeigt einen Alert-Text mit einer Variable für einen Wert aus der Message-Payload:

●     Definition des Alert-Texts im Steuerungsschritt:

Prüfen Sie Bestellung mit Bestellnummer &MyMessage.PAYLOAD.OrderNumber&.

MyMessage ist im Prozesscontainer definiert. OrderNumber ist das gewünschte Feld in der Payload.

●     Anzeige des Alert-Texts zur Laufzeit:

Prüfen Sie Bestellung mit Bestellnummer ABC123456789.