Selection Nodes

A tree path selects a branch of the output tree to serve as the root of the output data. Once a path is selected, the nodes on the path are changed to the path icon. A single diamond icon represents non-selection nodes, and a diamond icon in a box border represents selection nodes.

A node is a selection node if there can be multiple instances of the node in the tree. For example, there can be one or more 'Employee' elements under a 'Personnel' node. This is indicated by a plus sign at the end of the node label. Therefore, the 'Employee' node is a selection node. On the other hand, there can be only one 'Personnel' node in the XML stream, so this is a non-selection node.

Apart from differences in their visual appearance on the schema tree, a selection node can also have a query condition attached to it. If a query condition is associated with a selection node, the condition is used to select a subset of the nodes based on the condition evaluation. (See Tree Node Filtering for more information). For non-selection nodes there can be only one instance of the node, so selection is never necessary.

If the tree path contains multiple selection nodes and each selection node selects multiple instances of the nodes on that tree level, the tree path will select more than one subtree. For example, if you select the 'personnel. employee.skill' subtree, because there is more than one employee, the result of the tree path selection could contain multiple 'Skill' subtrees. In this case, the subtrees are merged into one root node, with all subtrees as its children.

<< Selection Tree Path © 1996-2013 InetSoft Technology Corporation (v11.4) Tree Transformation Rules >>