Monitor for Processed XML Messages 

Use

You use the monitor for processed XML messages to display information about persisted XML messages. You select the messages beforehand using particular criteria.

You can display individual messages from the list and compare existing versions with each other.

Prerequisites

To display information about messages, the messages must first have been logged. A message is logged when it is processed if:

·        It is an asynchronous message (persisted implicitly)

·        Logging for the underlying pipeline is activated (general logging of all pipeline steps or logging of particular pipeline steps)

The original message and any versions then exist for each message.

Versions of an original message only exist if message processing was executed with activated logging, or the message was implicitly persisted following a particular pipeline step.

·        If logging is activated at pipeline level, a new version of the message is saved each time a pipeline service is called.

·        If logging is activated at pipeline service level, a new version of the message is saved following processing by the pipeline service concerned.

In this way, changes to messages by pipeline services can be monitored. You can monitor all services or only the critical services, depending on the logging configuration.

Activities

The monitor for processed XML messages offers you two different views of processed messages:

·        The default view (default setting)

This view displays all messages that meet the chosen selection criteria.

·        The process view

This view only displays messages that were processed using the Business Process Engine. The displayed messages are grouped according to the process instances involved.

Both views give you three different options for selecting processed messages:

·        Search for all processed messages

Leave the Status Group and Status fields empty.

·        Search for messages that belong to a particular status group

This enables you to access all messages where errors occurred during processing, for example.

·        Search for messages that have a particular status

For example, you can use the message status to further restrict the number of messages belonging to a particular status group. This enables you to access all messages with errors that can be restarted, for example.

You can choose what search criteria you want to use:

·        Standard search

When you want to find message by date and time of execution, by sender, or by receiver you can choose the Standard Selection Criteria tab and use the standard search. For sender and receiver search you can choose to search by party, service, interface name, and interface namespace.

·        Advanced search

Choose the Advanced Selection Criteria tab when you need to find messages by one of the following parameters: message ID, message type, sent from and to date, logical pipeline ID, error ID, error category, client, user, technical inbound or outbound channel, outbound status, queue ID, or message with acknowledgement message

·        Search by attribute

Choose the User-Defined Selection Criteria tab when you need to perform search by user-defined attributes from the main payload of a message.

You can only select attributes if you have already defined them as attributes that can be used for message searches. More information: Configuring the User-Defined Message Search

You can perform a search for an attribute, or for all attributes:

¡        You search for an attribute when the attribute list consists of only one attribute and you want to search for all messages in which this attribute appears with one of the values you have specified. You can also search for an attribute when the attribute list consists of multiple attributes and you want to search for all messages in which at least one of these attributes appears with one of the values you have specified.

¡        You can search for all attributes when the attribute list consists of multiple attributes and you want to search for all messages in which all those attributes with the value you have defined appear.

 

The system then displays a list of persisted messages. You can restrict the length of this list.

If you do not have administrator authorization (S_XMB_ADM), the system only displays messages of the current client.