Return (-RETURN)

Use the Return adapter command (-RETURN) to return a single scalar value from the response message. In many cases, a map only has interest in a single value. This option simplifies mapping in these types of cases. This command can only be used if the value of the element is a scalar value.

This command is incompatible with the -HDR command.

This is an optional command. The default is a null reply.

-RETURN element
Option
Description
element
Specify the path and the element to be returned using XPath syntax.

XPath is a language for addressing parts of an XML document. For more information on the XPath language, go to www.w3.org/TR/xpath.

For example, to specify /cat/dog as the XML element to be returned:

-RETURN /cat/dog

See Source Options Behavior for more information on the behavior of the SOAP Adapter and its combinations of available options.