Retrieve Attribute from Message

Contents

Overview

The Retrieve from Message filter uses XPath expressions to extract the value of an XML element or attribute from the message and set it to an internal message attribute. It is also possible for the XPath expression to return a NodeList, and for the NodeList to be set to the specified message attribute.

Configuration

The following fields are available on the Retrieve from Message filter configuration screen:

Name:
Enter a name for this filter here.

Attribute Location:
Configure an XPath expression to retrieve the desired content.

Click the Add button to add an XPath expression. Existing expressions can be added and removed by clicking the Edit and Remove buttons respectively.

Extract the Content of the Node:
If this option is selected the content of the XML element or attribute in the message will be extracted and set to the selected message attribute.

Serialize All Nodes in the NodeList:
Use this option to select a NodeList to set to the message attribute. This option is useful for extracting <Signature>, <Security>, and <UsernameToken> blocks, as well as proprietary blocks of XML from messages.

Attribute ID:
The Enterprise Gateway will set the value of the message attribute selected here to the value extracted from the message. It is possible to enter a user-defined message attribute here as well.