XML Select Single Node Set Value

This XML tool evaluates the XPath expression and changes the node value of the first node that satisfies the pattern. This is a convenience tool that simplifies the use of XML as structured data. It basically wraps a call to XML Select Single Node and XML Set Node Value into one tool.

Please consult description of XML Set Node Value tool for a description of the semantics of the value, in particular in conjunction with data types.

Inputs

Context

Context from which to start evaluating the XPath pattern

Pattern

XPath pattern to evaluate in the context

New Node Value

Value to set as the new nodes value. Must match the data type, if data type is defined for node.

New Data Type

Integer value corresponding to the new data type to be set before setting the value. See the XML Get Node Info tool for the list of valid data types. If a type is not specified, the type will not be changed.

Outputs

Matching Node

Node whose value has been changed. NULL if no node satisfies the pattern.

Exit Paths

Success

This path is taken if a node matched the XPath query and the value has been successfully changed. the child nodes were successfully retrieved.

No Match

This path is taken if no Node matches the XPath query.

Failure

This path is taken if the operation fails, for example if the value does not agree with the data type of the node.