Messages editieren

Wenn es bei der Verarbeitung einer Message zu Fehlern kam, können Sie die Message im Message-Editor bearbeiten. Ja nach Art der Message können Sie diesen Editor wie folgt verwenden:

Wenn Sie ihn für asynchrone Messages auf der Registerkarte Datenbank mit einem bestimmten Status verwenden, können Sie den Header, die Attribute und die Payload der Message bearbeiten.
Wenn Sie ihn für Messages auf der Registerkarte Archiv verwenden, können Sie nur die Message-Details anzeigen.
Möglicherweise haben Sie eine integrierte Konfiguration mit aktivierter Message-Protokollierung, und gleichzeitig ist auch der Parameter messaging.syncMessageRemover.removeBody des Service XPI Service: Messaging System aktiviert. In einer solchen Situation können Sie nicht die Payload und Attachments für Messages für diese Konfiguration anzeigen.
Bei einer asynchronen Message für eine integrierte Konfiguration, bei der die Verwendung von Message-Protokollierung und von Message-Staging konfiguriert ist, können Sie im Editor beide Versionen dieser Message anzeigen, die Staging-Version und die protokollierte Version. Staging-Versionen sind an ihrer Nummer erkennbar, und protokollierte Versionen an ihrer Ablage, die in der Spalte Version angezeigt wird.

Wenn Sie eine Message zur Bearbeitung öffnen, können Sie ihre Header-Daten ändern, adapterspezifische Message-Attribute anlegen sowie vorhandene Attribute ändern oder löschen, die Payload der Message ändern, und die Attachments herunterladen. 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.

Hinweis Hinweis

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

Ende des Hinweises.

Voraussetzungen

Sie haben im Message-Monitor eine Suche nach Messages durchgeführt, eine Message ausgewählt und geöffnet.
Beachten Sie, dass Sie die ausgewählte Message nur dann im Editor bearbeiten können, wenn alle folgenden Kriterien zutreffen:
- Asynchron
- Nicht archiviert
- Mit dem XI-Protokoll gesendet
- In einem Fehlerstatus
Wenn für die ausgewählte Message keine dieser Kriterien zutrifft, können Sie nur ihre Details anzeigen.

Weitere Informationen zur Auswahl einer Message finden Sie unter Messages überwachen und Suchergebnisse überprüfen.
Das von Ihnen verwendete Benutzerkonto sollte einer Rolle des PI-Monitoring zugewiesen sein. Beachten Sie, dass Sie zum Anzeigen und Herunterladen von Attachments einer Message die Berechtigung zum Anzeigen der Payload der Message benötigen. Weitere Informationen darüber, mit welchen Rollen Sie Messages anzeigen und ändern können, finden Sie unter Monitoring-Rollen.

Vorgehensweise

Wählen Sie die Staging-Version (nicht die protokollierte Version) einer Message mit Status Nicht zugestellt aus, um ihre Details anzuzeigen.
Wenn Sie die Details bearbeiten müssen, wählen Sie Bearbeiten.
Wählen Sie die Registerkarte Message-Header, wenn Sie die Daten des Message-Header bearbeiten möchten.
Hinweis
- Die Bearbeitung des Message-Header verändert die gesamte Message-Verarbeitung.
- Die Header-Daten von Messages auf der Business Process Engine können nicht geändert werden.
Ende des Hinweises.
Wählen Sie die Registerkarte Message-Attribute, wenn Sie die Message-Attribute bearbeiten möchten.
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.
Wählen Sie die Registerkarte Payload und verwenden Sie eine der folgenden Methoden zum Anzeigen oder Bearbeiten der Payload:
- Bearbeiten Sie die Payload lokal in Ihrem Editor.
  Das Zeichenformat der Payload wird erkannt. Die Payload wird in einem vordefinierten Format in den Editor geladen, wo Sie sie nach Bedarf bearbeiten können.
- 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 Payload Zeichen enthält, die im Message-Editor nicht dargestellt werden können
  - 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.
Wählen Sie die Registerkarte Attachments, um die Attachments für die ausgewählte Message-Version anzuzeigen und herunterzuladen.
Sichern Sie die Message.

Ergebnis

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

Nach dem Bearbeiten einer Message, wird 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.

Weitere Informationen

Weitere Informationen zu Message-Versionen finden Sie unter Message-Versionen auf der Advanced Adapter Engine speichern.