XML Select Nodes

This XML tool evaluates the given XPath pattern against the context as defined by the Context pattern and returns an iterator to the resulting list of nodes.

Note that the Context node only defines the current context. You can still navigate the whole document tree. Thus, the pattern "/" always returns the document node, even if the context is not the document node.

Note: Please be aware of the XPath rules for names with namespace prefixes. Element names in XPath expressions have to be qualified with a namespace prefix defined in the SelectionNamespace property, even if the element is in the scopre of a default namespace and has no prefix. For example, given the following XML document:

<A xmlns="uri:some-namespace">
<B>FOO</B>
</A>

The XPath query /A/B will not select element B! You will instead have to specify a prefix using the SelectionNamespaces property and use this prefix in the query.

Example:

SelectionNamespaces: "xmlns:x="uri:some-namespace"
XPath query:  "/x:A/x:B"

For some additional details, please consult the description of the SelectionNamespaces property in the XML Set Document Property tool.

Inputs

Context

Context from which to evaluate the XPath pattern.

Pattern

XPath pattern describing nodes to select.

Outputs

Node List

Iterator pointing to first item in the node list resulting from evaluating the given XPath expression against the context defined by the Context node.

Exit Paths

Success

This path is taken if the nodes were successfully selected.

No Match

This path is taken if no nodes match the given XPath query. XPath matches the context as defined in the Context input.

Failure

This path is taken if the operation fails.