Choose Nodes


Note		You cannot use a Choose node in an XML Pipeline for which you plan to generate C# code.

A Choose node uses XPath expressions to evaluate one or more conditions based on its input to direct the flow of XML pipeline processing. The Choose node uses XPath 2.0 to evaulate the XPath expressions defined for it.

Figure 489. Choose Node in retrieveData.pipeline

Input Ports

The Choose node can have one or more input ports; by default, it has a single input port, named Input #0. You use the XPath # property to express a "true" condition - that is, a condition that must be met in order for processing to continue. The Choose node in retrieveData.pipeline, for example, uses the XPath expression . castable as xs:double to check whether or not the user ID it is given as its input is numeric.

The initial context node for each XPath # expression is the data input from Input #0. For additional input ports (Input #1, Input #2, and so on), data is available to the XPath expression as $var1, $var2, and so on.

The Choose node evaulates XPath#0. If XPath#0 is true, it sends data from Input #0 to Output #0. If XPath#0 is false, it evaluates XPath#1. If XPath#1 is true, it sends data from Input #0 to Output #1, and so on. If none of the XPath # expressions is true, the data from Input #0 is sent to Output `no match' port.

Adding Input Ports

To add an input port to a Choose node:

1. Display the Properties window if it is not already open (View > Properties).

2. Click the Choose node in the XML pipeline diagram.

3. Change the value for the Number of inputs property.

A new input port is added, named Input #1.

4. Optionally, add an output port for the new input port.

Output Ports

By default, a Choose node has two output ports:

l Output#0, which is enabled when the condition defined by the corresponding property, XPath #0, is met (the "true" condition)

l Output `no match', the default "else" condition, which is enabled if an input evaluates to "false"

You can add additional output ports, which you might want to do if you have added an input port. The output port that corresponds to the "true" condition always makes the first input available to its connecting pipe.

Each output port must have a value specified for it. You can

l Use the Copy to URL property to write the output to a file system

l Pipe the output to another node (for more processing if the condition evaluates to "true", or to a Stop node if the condition evaluates to "false", for example)

l Or both