Monitor für verarbeitete XML-Messages 

Verwendung

Über den Monitor für verarbeitete XML-Messages können Sie Informationen zu persistierten XML-Messages anzeigen, die Sie zuvor nach bestimmten Kriterien auswählen.

Aus der Liste der ermittelten Messages können Sie einzelne Messages anzeigen und vorhandene Versionen miteinander vergleichen.

Voraussetzungen

Um Informationen zu Messages anzeigen zu können, müssen die Messages zuvor protokolliert worden sein. Messages werden während ihrer Verarbeitung protokolliert, wenn

●      es sich um asynchrone Messages handelt (diese werden implizit persistiert)

●      das Logging für die zugrunde liegende Pipeline eingeschaltet ist (generelles Logging aller Pipeline-Schritte oder gezieltes Logging einzelner Pipeline-Schritte)

Für jede Message existiert dann die Original-Message sowie vorhandene Versionen.

Versionen zu einer Original-Message gibt es nur dann, wenn die Message-Verarbeitung mit eingeschaltetem Logging durchgeführt wird, oder wenn die Message nach einem bestimmten Pipeline-Schritt implizit persistiert wird.

●      Ist das Logging auf Pipeline-Ebene eingeschaltet, wird nach jedem Aufruf eines Pipeline-Service eine neue Version der Message gespeichert.

●      Ist das Logging auf Pipeline-Service-Ebene eingeschaltet, wird nach der Bearbeitung durch den betreffenden Pipeline-Service eine neue Version der Message gespeichert.

Auf diese Weise lassen sich die durch die Pipeline-Services an den Messages hervorgerufenen Änderungen verfolgen. Je nach Konfiguration des Logging können Sie entweder alle Services oder nur kritische Services überwachen.

Aktivitäten

Der Monitor für verarbeitete XML-Messages bietet Ihnen zwei unterschiedliche Sichten auf verarbeitete Messages:

●      Die Standard-Sicht (Voreinstellung)

Diese Sicht zeigt alle Messages an, die den gewählten Selektionskriterien entsprechen.

●      Die prozessbezogene Sicht

Diese Sicht zeigt nur Messages an, an deren Verarbeitung die Business Process Engine beteiligt war. Die angezeigten Messages sind nach den beteiligten Prozessinstanzen gruppiert.

Für beide Sichten haben Sie drei verschiedene Möglichkeiten, verarbeitete Messages auszuwählen:

●      Sie können nach allen verarbeiteten Messages suchen.

Die Felder Statusgruppe und Status müssen hierbei leer bleiben.

●      Sie können nach Messages suchen, die einer bestimmten Statusgruppe angehören.

Dies ermöglicht Ihnen beispielsweise einen schnellen Zugriff auf alle Messages, bei deren Verarbeitung ein Fehler auftrat.

●      Sie können nach Messages suchen, die einen bestimmten Status aufweisen.

Über den Status einer Message können Sie zum Beispiel die Menge der Messages weiter einschränken, die zu einer bestimmten Statusgruppe gehören. Zum Beispiel haben Sie einen schnellen Zugriff auf alle fehlerhaften Messages, die wieder neu gestartet werden können.

Sie können wählen, welche Suchkriterien Sie verwenden möchten:

●      Standardsuche

Wenn Sie Messages anhand Datum und Uhrzeit der Ausführung, Sender oder Empfänger suchen möchten, wählen Sie die Registerkarte Standardselektionskriterien und benutzen die Standardsuche. Bei der Suche nach Sender und Empfänger können Sie auswählen, ob Sie nach Partner, Service, Interface-Name oder Interface-Namensraum suchen möchten.

●      Erweiterte Suche

Wählen Sie die Registerkarte Erweiterte Selektionskritierien, wenn Sie anhand der folgenden Parameter nach Messages suchen wollen: Message-ID, Message-Typ, Ausgangs- und Eingangsdatum, logische Pipeline-ID, Fehler-ID, Fehlerkategorie, Mandant, Benutzer, technischer Eingang oder Ausgang, Status am Ausgang, Queue-ID oder Message mit Acknowledgement-Message.

●      Attributsuche

Wählen Sie die Registerkarte Benutzerdefinierte Selektionskriterien, wenn Sie die Suche anhand benutzerdefinierter Attribute aus der Main-Payload einer Message ausführen möchten.

Sie können nur Attribute auswählen, wenn Sie diese zuvor als zur Message-Suche verwendbare Attribute definiert haben. Weitere Informationen: Configuring the User-Defined Message Search

Sie können die Suche für ein Attribut oder für mehrere Attribute ausführen.

○       Sie suchen nach einem Attribut, wenn die Attributliste aus nur einem Attribut besteht und Sie nach allen Messages suchen möchten, in denen dieses Attribut mit einem von Ihnen angegebenen Wert vorkommt. Sie können auch nach einem Attribut suchen, wenn die Attributliste aus mehreren Attributen besteht und Sie nach allen Messages suchen möchten, in denen mindestens eines dieser Attribute mit einem von Ihnen angegebenen Wert vorkommt.

○       Sie können nach allen Attributen suchen, wenn die Attributliste aus mehreren Attributen besteht und Sie nach allen Messages suchen möchten, in denen alle diese Attribute mit dem von Ihnen angegebenen Wert vorkommen.

 

Das System zeigt dann eine Liste der persistierten Messages an. Sie können die Länge dieser Liste einschränken.

Wenn Sie keine Administratorberechtigung (S_XMB_ADM) besitzen, werden Ihnen nur die Messages des aktuellen Mandanten angezeigt.