Versionen von XML-Messages anzeigen 

Verwendung

Sie können einzelne XML-Messages aus einer Liste von verarbeiteten oder archivierten XML-Messages zu Auswertungszwecken anzeigen und vorhandene Versionen miteinander vergleichen.

Beim Vergleichen einzelner Versionen einer XML-Message können Sie nachvollziehen, welche Änderungen an der XML-Message von den einzelnen Verarbeitungsschritte einer Pipeline vorgenommen wurden. Hierbei können Sie sowohl die kompletten XML-Messages vergleichen wie auch einzelne Teile einer Message.

Die Anzeige der Message-Inhalte ist durch das Berechtigungsobjekt S_XMB_DSP geschützt, da sie individuell gesteuert werden muss. Standardmäßig werden nur XML-Messages des aktuellen Mandanten zur Anzeige gebracht, es sei denn der Benutzer ist durch die Berechtigung S_XMB_ADM als Administrator ausgewiesen.

Voraussetzungen

Sie haben eine der entsprechenden Optionen im Menü Monitoring gewählt und befinden sich nun in einem Bild mit einer Liste von verarbeiteten oder archivierten XML-Messages.

Vorgehensweise

...

Klicken Sie auf die Message-ID der XML-Message, deren Versionen Sie anzeigen möchten, oder markieren Sie die entsprechende Zeile und wählen Sie Anzeigen bzw. Archivierte Versionen anzeigen ().

Das Bild XML-Message-Versionen anzeigen bzw. Archivierte XML-Message-Versionen anzeigen erscheint.

Das Bild Archivierte XML-Message-Versionen anzeigen enthält im Navigationsbereich eine Auflistung der vorhandenen Message-Versionen einschließlich Status.

Das Bild XML-Message-Versionen anzeigen besitzt einen zweigeteilten Navigationsbereich. Im oberen Bereich werden die gewählte Message sowie alle mit dieser Message in Beziehung stehenden Messages einschließlich Status hierarchisch aufgelistet. Im unteren Bereich sehen Sie die Versionen zu der im oberen Bereich markierten Message.

Zur Anzeige der einzelnen Status einer Message wählen Sie Legende (). Weitere Informationen finden Sie unter Status der Verarbeitung.

In beiden Bildern befindet sich im zweigeteilten Anzeigebereich die aktuellste Message-Version. Im oberen Bereich (Fenster 1) wird Message-Header und Message-Body angezeigt, im unteren Bereich (Fenster 2) die Message-Payload (bzw. der Error-Header bei fehlerhaften Messages).

Ist die Payload für die Anzeige zu groß, bleibt der untere Anzeigebereich leer und es erscheint eine entsprechende Meldung.

Im Fenster 1 werden die einzelnen Teile der XML-Message zusammengefasst und als Gesamtdokument angezeigt. Dabei wird <SOAP:Envelope> als umschließendes Tag hinzugefügt. Dies dient lediglich dazu, ein syntaktisch korrektes XML-Dokument auszugeben, und ist nicht Bestandteil der eigentlichen XML-Message.

Je nachdem, ob es sich um die Anzeige der Original-Message oder einer Message-Version handelt, wird Eingangs-Message oder die Bezeichnung des die Version erzeugenden Verarbeitungsschritts der Pipeline als Kommentar in die XML-Message eingeblendet. Diese Informationen sind ebenfalls kein Bestandteil der eigentlichen XML-Message.

Die Eingangs-Message identifiziert an dieser Stelle den ersten Verarbeitungsschritt in der jeweiligen Integration Engine.

●      Wenn Sie komplette XML-Messages vergleichen möchten, markieren Sie die Zeile Eingangs-Message bzw. den Namen des jeweiligen Verarbeitungsschritts, zum Beispiel Antwort, und geben Sie pro Selektion an, ob die Message im oberen Anzeigebereich (Inhalt in Fenster 1 anzeigen) oder im unteren Anzeigebereich (Inhalt in Fenster 2 anzeigen) angezeigt werden soll.

Die Anzeigen je Anzeigebereich sind beliebig austauschbar, d.h. es können auch Message-Teile in die Anzeigebereiche geladen werden, die von ihrer Art her nicht vergleichbar sind.

●      Wenn Sie Header, Body oder Payload einer Message vergleichen möchten, machen Sie im Navigationsbereich einen Doppelklick auf die entsprechende Zeile unter SOAP-Header, SOAP-Body oder Payloads, oder markieren Sie die Zeile und wählen Inhalt in Fenster 1 anzeigen bzw. Inhalt in Fenster 2 anzeigen, je nachdem, ob die Anzeige im oberen oder im unteren Anzeigebereich erfolgen soll.

●      Wenn Sie wieder die komplette XML-Message anzeigen möchten, machen Sie im Navigationsbereich einen Doppelklick auf die entsprechende Zeile oder markieren Sie die Zeile und wählen Inhalt in Fenster 1 anzeigen bzw. Inhalt in Fenster 2 anzeigen ().

●      Wenn Sie den Inhalt eines Fensters sichern möchten, wählen Sie Download Fenster 1 bzw. Download Fenster 2 (), um ihn als Datei in Ihrem lokalen Dateisystem zu speichern.

Über die Option View Source im Kontextmenü können Sie den Inhalt eines Fensters auch als unformatiertes XML in Ihrem Notepad anzeigen.

●      Wenn Sie die komplette Message-Version (inklusive der Payloads) in Ihrem lokalen Dateisystem sichern möchten, wählen Sie Message-Version komplett sichern ().

●      Wenn Sie bei fehlerhaften XML-Messages den entsprechenden Fehlertext anzeigen möchten, wählen Sie Zusatzinformationen zum Fehler ().

Diese Option steht nur bei fehlerhaften XML-Messages zur Verfügung.

Die folgenden Optionen stehen nur bei fehlerhaften asynchronen XML-Messages zur Verfügung:

●      Wenn Sie eine fehlerhafte Message zur Behebung des Fehlers bearbeiten möchten, wählen Sie im Navigationsbereich den Teil des Header oder Body aus, den Sie korrigieren möchten, und wählen anschließend Message-Teil bearbeiten ().

Sie gelangen in einen Editor, in dem Sie die Message bearbeiten und sichern können.

Bei diesem Editor handelt es sich um einen reinen Text-Editor, mit dem Sie nur diese spezielle Message ändern können. Prinzipiell sollten Sie Fehler primär dort korrigieren, wo sie ursächlich auftreten (zum Beispiel im Integration Directory).

●      Wenn Sie eine fehlerhafte Message nach dem Beheben des Fehlers wieder ausführen möchten, wählen Sie XML-Message nach Fehler wieder einplanen ().

Bei einem Neustart wird automatisch die letzte produktive Version einer Message neu eingeplant. Abhängig davon werden möglicherweise nicht alle Verarbeitungsschritte neu durchlaufen.

●      Wenn Sie die weitere Verarbeitung einer fehlerhaften XML-Message beenden möchten, wählen Sie das Symbol . Die Message kann somit archiviert oder gelöscht werden.