Show TOC

Editing MessagesLocate this document in the navigation structure

Use

You usually edit a message when errors occurred during its processing and it is possible to restart the message.

You use the message editor to edit a message. If you have the required authorization, you can use the message editor to edit the header data or the payload of a message, or both. You can save changed messages and process them again.

Note

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.

Prerequisites

You need the following authorizations to use the message editor:

  • On the Java side, you need the authorizations of the edit_header role to edit the message header. If you have this role, the header data of the message that you can edit is displayed when you call the message editor.

  • To edit the message payload, you need the authorizations of the edit_payload role. If you have this role, the payload of the message that you can edit is displayed when you call the message editor.

  • If you have both roles, all the message data for editing is displayed. If you do not have either role, you cannot call the message editor.

  • On the ABAP side, you need the SAP_XI_MESSAGE_MODIFY and SAP_XI_BPE_MONITOR_ABAP roles. Both are part of the SAP_XI_MONITOR_ENHANCED composite role.

Procedure

You can use the message editor to edit the following data:

  • Header data

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

    You can create adapter-specific message attributes and change or delete existing attributes.

    Note

    You cannot change the header data of messages in the Business Process Engine.

  • 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.

The message is locked for other users while you are editing it. You can delete the corresponding lock entries from the database.

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

Note

Edited messages are not deleted and must therefore be archived .

Edit Header Data

To edit the header data, proceed as follows:

  1. Change the required header data or message attributes (if any exist) in the corresponding input fields.

  2. Add to or delete the available message attributes, if required.

  3. Save the message with the changed data.

Editing the Payload in the Message Editor

The payload of the message is displayed with specifications on its character format, the MIME type, and the payload size. To edit the payload, proceed as follows:

  1. Edit the payload in the Payload window of the message editor, or load the payload in a separate editor (as described below).

  2. If you want to save the payload in another character format, select the required character format before you save the message.

  3. 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, if:

  • 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:

  1. To load the message payload in a separate editor, choose Download and then Open .

  2. Edit the payload in the selected editor.

  3. Save the payload in your file system.

  4. To localize the changed payload in your file system, choose Browse in the message editor.

  5. To upload the payload to the message editor, choose Upload .

  6. Save the message.

Result

Once you have edited the payload, you can exit the message editor and restart your message, if required.

Recommendation

Choose Log Off to exit the message editor. The message is then immediately available to other users. If you only close the browser window, the message only becomes accessible when you close your session in the central monitor server.

In message monitoring you can search for and display edited messages. Use the filter criterion Edited and take the column of the same name into the layout of your message display .