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.