Route
With this node you can route a job to one output depending on information in the workable, file or data.
It has the following configuration options:
- Value: here you can specify the information to compare (also called Parameter). Select the pencil to open Expression Builder.
- Value Type: here you can specify how to interpret the Parameter value before
comparing. Options:
- Use data without interpretation: if you select this option,the value
will be used as found. This means:
- If you enter the value to compare in the edit field, it will be used as text.
- If you receive the value from a variable, the data type will be the type of the contents of the variable.
- Text: if you select this option, the value will be converted to text.
This means:
- the data will be used without modifications if it is text already (for example when you enter it in the edit field), or
- it is converted to text if it is a number or true or false, or
- it will be converted to a JSON String if it is an JSON array or JSON object.
- Number: if you select this option, the value will be converted to a number. Note that the decimal separator must be a point.
- True or False: if you select this option, the value will be converted to true or false. This means that the string true ( regardless of upper, lower or mixed case) will be converted to true, numbers with a non-zero value will be converted to true, and all other data will be converted to false.
- JSON Data: if you select this option, the value will be interpreted as a JSON String, and converted to data will be used for comparison. This can be used to compare several values at once.
- Use data without interpretation: if you select this option,the value
will be used as found. This means:
- Test: here you can specify how to compare the Parameter with the selected value(s).
Options:
- Equal to: if you select this option, the parameter and the specified value must match exactly.
- Less than: if you select this option, the parameter must be less than the specified value.
- Less than or equal to: if you select this option, the parameter must be equal to or less than the specified value.
- Greater than: if you select this option, the parameter must be greater than the specified value.
- Greater than or equal to: if you select this option, the parameter must be equal to or greater than the specified value.
- Contains: if you select this option, the parameter must contain the specific value.
- Begins with: if you select this option, the parameter must begin with the specified value.
- Ends with: if you select this option, the parameter must end with the specified value.
- Routing
- Compare to: here you can specify the value to use when comparing with the Parameter.
- Label: here you can specify the output connector where the flow must go when the specified value matches up with the Parameter.
- Routing Value type: here you can specify how to interpret the compare
value(s) before comparing. Options:
- Use data without interpretation: if you select this
option,the value will be used as found. This means:
- If you enter the value to compare in the edit field, it will be used as text.
- If you receive the value from a variable, the data type will be the type of the contents of the variable.
- Text: if you select this option, the
value will be converted to text. This means:
- the data will be used without modifications if it is text already (for example when you enter it in the edit field), or
- it is converted to text if it is a number or true or false, or
- it will be converted to a JSON String if it is an JSON array or JSON object.
- Number: if you select this option, the value will be converted to a number. Note that the decimal separator must be a point.
- True or False: if you select this option, the value will be converted to true or false. This means that the string true ( regardless of upper, lower or mixed case) will be converted to true, numbers with a non-zero value will be converted to true, and all other data will be converted to false.
- JSON Data: if you select this option, the value will be interpreted as a JSON String, and converted to data will be used for comparison. This can be used to compare several values at once.
- Use data without interpretation: if you select this
option,the value will be used as found. This means:
- Compare Number Accuracy: here you can specify the possible rounding when comparing numbers. All numbers that do not differ more than the value specified here will match when compared for equality.
- Case Free String Compare: if you select this checkbox, strings must be compared case free.