Show TOC

Messages editierenLocate this document in the navigation structure

Verwendung

In case errors occurred during the processing of a message, you can edit it in the message editor. To do this, you can find the message in the message monitor and open it to edit the following data:

  • Wenn Sie die Header-Daten einer Message ändern, beachten Sie, dass sich dadurch die gesamte Message-Verarbeitung ändert.

    Beachten Sie, dass die Header-Daten von Messages in der Business Process Engine nicht geändert werden können.

  • Sie können adapterspezifische Message-Attribute anlegen und bereits vorhandene Attribute ändern oder löschen.

    Sie können dies auch mit dem Integration Builder tun.

  • Sie können die Message-Payload ändern.

    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.

    Beachten Sie, dass Sie nur die Payload von XI-Messages editieren können, nicht die von Web-Service-Messages.

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. Weitere Informationen finden Sie unter Technische Daten zur Adapter Engine anzeigen .

Nachdem Sie eine Message editiert und gesichert haben, wird die Message automatisch erneut in den Message-Editor geladen. Sie können dann die Message erneut verarbeiten.

Hinweis

Editierte Messages werden nicht gelöscht und müssen daher archiviert werden. Weitere Informationen finden Sie unter Verarbeitung im Hintergrund durchführen .

Voraussetzungen

  • Sie haben im Message-Monitor eine Suche nach Messages durchgeführt, eine Message ausgewählt und geöffnet. Weitere Informationen finden Sie unter Messages überwachen und Suchergebnisse überprüfen .

  • Das von Ihnen verwendete Benutzerkonto sollte einer Rolle des PI-Monitoring zugewiesen sein. Weitere Informationen darüber, mit welchen Rollen Sie Messages anzeigen und ändern können, finden Sie unter Monitoring-Rollen .

Vorgehensweise

Header-Daten und Message-Attribute bearbeiten

  1. Wählen Sie die gewünschte Message-Version aus und wählen Sie Bearbeiten .

  2. Wählen Sie die Registerkarte Message-Header oder Message-Attribute .

  3. Bearbeiten Sie die Header-Daten oder Message-Attribute nach Bedarf.

  4. Sichern Sie die Message.

Payload im Message-Editor editieren

Die Payload der Message wird mit Informationen zur Zeichendarstellung, zum Content-Type und zur Payload-Größe angezeigt. Zum Editieren der Payload, verfahren Sie wie folgt:

  1. Wählen Sie die gewünschte Message-Version aus.

  2. Wählen Sie Bearbeiten und dann die Registerkarte Payload .

  3. Bearbeiten Sie die Payload oder laden Sie die Payload in einen separaten Editor (wie unten beschrieben).

  4. Wenn Sie die Payload in einer anderen Zeichendarstellung abspeichern wollen, wählen Sie vor dem Sichern der Message die gewünschte Zeichendarstellung aus.

  5. Sichern Sie die Message.

    Wenn Sie eine andere Zeichendarstellung gewählt haben, wird die Payload beim Sichern der Message entsprechend konvertiert.

Payload in separatem Editor editieren

Sie können zum Editieren der Payload auch einen separaten Editor verwenden. Dies ist zum Beispiel 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

Gehen Sie wie folgt vor:

  1. Um die Message-Payload in einen separaten Editor zu laden, wählen Sie Herunterladen .

  2. Editieren Sie die Payload in dem ausgewählten Editor und sichern Sie sie als Datei.

  3. Wählen Sie Durchsuchen im Message-Editor, um die geänderte Payload in Ihrem Dateisystem zu lokalisieren.

  4. Wählen Sie Hochladen , um die geänderte Payload in den Message-Editor hochzuladen.

  5. Sichern Sie die Message.

Ergebnis

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.