Messages editieren
Verwendung
Typischerweise editieren Sie eine Message, wenn es bei der Verarbeitung dieser Message zu Fehlern kam, die Message aber erneut gestartet werden kann.
Zum Editieren einer Message verwenden Sie den Message-Editor. Mit dem Message-Editor können Sie, je nach Berechtigung, die Header-Daten und/oder die Payload einer Message editieren. Geänderte Messages können Sie abspeichern und anschließend erneut verarbeiten.
Nach dem Editieren einer Message, wird immer auch das Mapping dieser Message neu bestimmt:
■ Wenn Sie die Header-Daten der Message ändern, kann sich das Mapping aus einer anderen Interface-Ermittlung ergeben. Wurde zu den geänderten Header-Daten keine Interface-Ermittlung konfiguriert, findet auch kein Mapping statt. Daher sollte für eine geänderte Message immer auch eine sinnvolle Konfiguration vorliegen.
■ Auch Änderungen an der Payload können beeinflussen, welches Mapping verwendet wird, da die Ermittlung des Mappings von Bedingungen abhängen kann.
Voraussetzungen
Um den Message-Editor verwenden zu können, benötigen Sie folgende Berechtigungen:
● Java-seitig benötigen Sie zum Editieren des Message-Headers die Berechtigungen der Rolle edit_header. Verfügen Sie über diese Rolle, werden Ihnen beim Aufruf des Message-Editors die Header-Daten der Message angezeigt, die Sie dann editieren können.
● Zum Editieren der Message-Payload benötigen Sie die Berechtigungen der Rolle edit_payload. Verfügen Sie über diese Rolle, wird Ihnen beim Aufruf des Message-Editors die Payload der Message angezeigt, die Sie dann editieren können.
● Verfügen Sie über beide Rollen, werden Ihnen die kompletten Message-Daten zum Editieren angezeigt. Verfügen Sie über keine der beiden Rollen, können Sie den Message-Editor nicht aufrufen.
● ABAP-seitig benötigen Sie die Rollen SAP_XI_MESSAGE_MODIFY und SAP_XI_BPE_MONITOR_ABAP. Beide sind Teil der Sammelrolle SAP_XI_MONITOR_ENHANCED.
Vorgehensweise
Mit dem Message-Editor können Sie folgende Daten editieren:
● Die Header-Daten
Wenn Sie die Header-Daten einer Message ändern, beachten Sie, dass sich dadurch die gesamte Message-Verarbeitung ändert.
Sie können adapterspezifische Message-Attribute anlegen und bereits vorhandene Attribute ändern oder löschen.
Die Header-Daten von Messages auf der Adapter Engine und der Business Process Engine können nicht geändert werden.
● Die Message-Payload
Die Payload einer Message wird standardmäßig mit der Zeichendarstellung AUTO geladen. AUTO bedeutet, dass der Message-Editor die Zeichendarstellung der Payload automatisch erkennt, sie beim Laden der Message ausgibt, und die Payload entsprechend darstellt.
Möchten Sie die Payload in einer anderen Zeichendarstellung laden, müssen Sie diese zuvor im Feld Zeichendarstellung auswählen. Die Zeichendarstellung NONE lädt die Payload als einfachen Byte-Stream.
Während Sie eine Message editieren, ist die Message für andere Benutzer gesperrt. Entsprechende Sperreinträge können Sie von der Datenbank löschen.
Nachdem Sie eine Message editiert und gesichert haben, wird die Message automatisch erneut in den Message-Editor geladen.
Editierte Messages werden nicht gelöscht und müssen daher archiviert werden.
Header-Daten editieren
Zum Editieren der Header-Daten, verfahren Sie wie folgt:
...
1. Ändern Sie die gewünschten Header-Daten oder Message-Attribute (falls vorhanden) in den entsprechenden Eingabefeldern.
2. Ergänzen oder löschen Sie die Message-Attribute, falls gewünscht und vorhanden.
3. Sichern Sie die Message mit den geänderten Daten.
Payload editieren
Die Payload der Message wird unter Angabe der Zeichendarstellung, des MIME-Typs und der Payload-Größe angezeigt. Zum Editieren der Payload, verfahren Sie wie folgt:
...
1. Editieren Sie die Payload im Fenster Payloaddes Message-Editors oder laden Sie die Payload in einen separaten Editor (siehe unten).
2. Wenn Sie die Payload in einer anderen Zeichendarstellung abspeichern wollen, wählen Sie vor dem Sichern der Message die gewünschte Zeichendarstellung aus.
3. Sichern Sie die Message.
Wenn Sie eine andere Zeichendarstellung gewählt haben, wird die Payload beim Sichern der Message entsprechend konvertiert.
Sie können zum Editieren der Payload auch einen separaten Editor verwenden. Dies ist typischerweise der Fall, wenn
● die Payload für den Message-Editor zu groß ist
● die Zeichendarstellung der Payload nicht unterstützt wird
● die Payload keine darstellbaren Zeichen enthält
● Sie aus Benutzersicht einen anderen Editor bevorzugen
Verfahren Sie wie folgt:
...
1. Wählen Sie Herunterladen und anschließend Öffnen, um die Message-Payload in einen separaten Editor zu laden.
2. Editieren Sie die Payload in dem ausgewählten Editor.
3. Speichern Sie die Payload in Ihrem Dateisystem ab.
4. Wählen Sie Browse im Message-Editor, um die geänderte Payload in Ihrem Dateisystem zu lokalisieren.
5. Wählen Sie Hochladen, um die geänderte Payload in den Message-Editor hoch zu laden.
6. Sichern Sie die Message.
Ergebnis
Nach dem Editieren der Payload können Sie, wenn gewünscht, den Message-Editor verlassen und Ihre Message neu starten.
Wählen Sie Abmelden, um den Message-Editor zu verlassen. Die Message ist dann für andere Benutzer sofort zugänglich. Wenn Sie einfach nur das Browser-Fenster schließen, wird die Message erst zugänglich, wenn Ihre Sitzung vom zentralen Monitoring Server beendet wird.
Im Message-Monitoring können Sie nach editierten Messages suchen und die gefundenen Messages anzeigen. Verwenden Sie hierzu das Filterkriterium Editiert und nehmen Sie die gleichnamige Spalte in das Layout Ihrer Message-Anzeige auf.