Alert in Integrationsprozess auslösen

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.

Weitere Informationen: Alert Management

Alert-Kategorie

Bevor Sie einen Alert auslösen können, müssen Sie eine entsprechende Alert-Kategorie definieren. In der Alert-Kategorie definieren Sie Texte, Verfallsdatum usw. Sie haben folgende Möglichkeiten, Alert-Kategorien zu definieren:

• Alert-Kategorie im Enterprise Services Builder (ES Builder) definieren

  Sie können eine Alert-Kategorie direkt im ES Builder definieren. Das hat den Vorteil, dass Sie einen Alert-Container definieren können. Im Alert-Container können Sie festlegen, welche Daten aus dem Integrationsprozess der Benutzer im Kurztext des Alerts sehen kann.

• Alert-Kategorien auf Alert-Server definieren

  Sie können Alert-Kategorien auch auf dem Alert-Server definieren. Dabei können Sie jedoch nur Elemente des Prozesscontainers als Variablen in Langtexten von Alerts verwenden. Wenn Sie neue Alert-Kategorien für Alerts in Integrationsprozessen benötigen, sollten Sie diese im Enterprise Services Builder definieren. Sie können jedoch Alert-Kategorien, die bereits auf dem Alert Server definiert sind, weiterverwenden.

Als Alert Server verwenden Sie den Integration Server.

Alert-Kategorie definieren

1. Legen Sie eine Alert-Kategorie an.

   Weitere Informationen: Anlegen eines Objektes

2. Definieren Sie die Grunddaten des Alerts, wie beispielsweise die Priorität.

   Dazu gehen Sie wie bei der Definition eines Alerts auf dem Alert Server vor.

   Weitere Informationen: Defining Alert Categories

3. Definieren Sie Kurz- und Langtext des Alerts.
   1. Um die Texte des Alerts aussagekräftiger zu gestalten, können Sie Containerelemente als Platzhalter verwenden. Zur Laufzeit zeigen die Containerelemente dann die aus dem Integrationsprozess ermittelten Werte.
      1. Definieren Sie die gewünschten Containerelemente.

         Im Alert-Container können Sie Containerelemente mit einfachen xsd-Datentypen verwenden.

      2. Fügen Sie die Containerelemente als Platzhalter an den gewünschten Stellen im Kurz- oder Langtext ein.

         Den Datenfluss zu diesen Containerelementen legen Sie später im Steuerungsschritt zum Auslösen des Alerts fest.

   Sie können Alert-Texte in unterschiedlichen Sprachen definieren.

   Weitere Informationen: Sprachabhängige Texte bearbeiten

   Nach Aktivieren der Änderungsliste wird die Alert-Kategorie auf den Alert Sever deployed. Sie können Sie dort über die Transaktion ALRTCATDEF anzeigen, jedoch nicht ändern.

Steuerungsschritt zum Auslösen des Alerts definieren

1. Fügen Sie an der gewünschten Stelle im Integrationsprozess einen Steuerungsschritt ein.
2. Wählen Sie Alert auslösen im Feld Aktion.
3. Wählen Sie Integration Builder/Enterprise Services Builder im Feld Quelle.
4. Wählen Sie die gewünschte Alert-Kategorie.

   Der Eigenschaftenbereich zeigt alle Containerelemente, die für die ausgewählte Alert-Kategorie definiert sind.

5. Definieren Sie den Datenfluss, indem Sie festlegen, wie jedes Containerelement zur Laufzeit belegt wird.

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.

   Weitere Informationen: 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.

Steuerungsschritt zum Auslösen des Alerts 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. Wählen Sie Integration Server im Feld Quelle.
5. Geben Sie für die Eigenschaft Alert-Kategorie die gewünschte Alert-Kategorie aus dem Alert Management an.
6. 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.
   Hinweis

   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 oder einen Pfad für den Zugriff auf Werte in der Message-Payload angeben.

• Um eine Variable zu definieren, gehen Sie wie folgt vor:
  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.

     Weitere Informationen: Containeroperation

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

     &variable&

     Tipp

     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

• Um auf einen Werte in der Message-Payload zuzugreifen, geben Sie im Alert-Text es Steuerungsschritts den Pfad zu dem gewünschten Feld gemäß folgender Syntax an:

  &message.PAYLOAD.attribute&

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&.

  MyMes sage 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.

Sie können den Empfänger eines Alerts auf unterschiedliche Arten festlegen:

• Sie legen für eine Alert-Kategorie die Empfänger fest. Dazu verwenden Sie die Transaktion ALRTCATDEF, auch wenn Sie die Alert-Kategorie im Enterprise Services Builder definiert haben.
• Benutzer subskribieren sich auf eine bestimmte Alert-Kategorie. Die Berechtigung dazu vergeben Sie in der Transaktion ALRTCATDEF.

Weitere Informationen: Recipient Determination

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).

   Weitere Informationen: 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.