Editing Messages

Use

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:

If you change the header data of a message, note that this changes the entire message processing.

Consider that you cannot change the header data of messages in the Business Process Engine.
You can create adapter-specific message attributes and change or delete existing attributes.

You can also do this in the Integration Builder.
You can change the message payload.

The payload of a message is loaded with the character format AUTO as standard. AUTO means that the message editor automatically recognizes the character format, then uses this character format to load the message, and then displays the payload accordingly. If you want to load the payload in another character format, you must select this beforehand in the Character Format field. The character format NONE loads the payload as a simple byte stream.

Consider that you can only edit the payload of XI messages and not of Web service messages.

The system locks the message for other users while you are editing it. You can delete the corresponding lock entries from the database. For more information, see Displaying Technical Data for the Adapter Engine .

Once you have edited and saved the message, it is automatically reloaded in the message editor. Then you can process the message again.

Note

Edited messages are not deleted and must therefore be archived. For more information, see Performing Background Processing .

Prerequisites

You have performed a search for messages in the message monitor, selected a message, and opened it. For more information, see Monitoring Messages and Reviewing Search Results .
The user account you use should be assigned to one of the Process Integration monitoring roles. For more information about which roles allow you to view and modify messages, see Monitoring Roles .

Procedure

Editing Header Data and Message Attributes

Select the required message version and choose Edit .
Choose the Message Header or Message Header tab.
Edit the header data or message attributes as necessary.
Save the message.

Editing the Payload in the Message Editor

The payload of the message is displayed with information about its character format, the content type, and the payload size. To edit the payload, proceed as follows:

Select the required message version.
Choose Edit and then the Payload tab.
Edit the payload on the page or load the payload into a separate editor (as described below).
If you want to save the payload in another character format, select the required character format before you save the message.
Save the message.

If you have selected another character format, the payload is converted accordingly when the message is saved.

Editing the Payload in a Separate Editor

You can also use a separate editor to edit the payload. This is the case, for example, when one or more of the following applies:

The payload is too large for the message editor.
The character format of the payload is not supported.
The payload does not contain any displayable characters.
You prefer the user view of another editor.

Proceed as follows:

To load the message payload in a separate editor, choose Download .
Edit the payload in the selected editor and save it as a file.
To localize the changed payload in your file system, choose Browse in the message editor.
To upload the payload to the message editor, choose Upload .
Save the message.

Result

Once you have edited a message, the mapping of this message is determined again:

If you change the header data of the message, the mapping can result from another interface determination. If no interface determination has been configured for the changed header data, there is no mapping. Therefore, a changed message should always have a configuration.
Changes to the payload can also influence which mapping is used, since the determination of the mapping can depend on conditions.