Route

You can use the Route processor function to apply different conditions to the data handling based on its value. It is recommended that the configuration be completed before connecting other processors or forwarders. The order in which each condition is added is the order in which each condition is applied to the input.

When multiple conditions are added to the Route function, you can re-order any condition by drag and drop method using the icon on the Condition box.

The Route function has the the following settings:

Setting	Description

Setting

Description

Field

The input from the function preceding the Route function in the stream. You can select the field from the drop-down list or type the field into the Add field box and click the + button.

Expression

The mathematical conditions to compare values and expressions. The available conditions are:

Less than
Equal to
Not equal to
Greater than
List lesser than
List equal to
List greater than
Regexp

Value

The value that you want to enter for the condition.

You must generate a preview to enable the Route function to import the data from the preceding function(s) connected to it.

To generate a preview, configure the condition(s) by following these steps:

The Field drop-down list is populated with the input from the function preceding the Route function in your stream. Select one of the options in the drop-down list.
In the Expression field, specify the condition or if you select Regexp, enter the regular expression that you want to apply in Value. Standard regular expressions are supported.
In the Value field, specify the value or the regular expression depending on the function preceding the Route function.
To add a new condition, click the +New Condition button.

Note!

Data is checked for matching against each condition only in the order in which the conditions are arranged in the configuration. For example, if the data matches the first condition, it is sent via the Output that you enter for that condition. If the data does not match with the first condition, it is checked to match against the second condition or the third condition, and so on.
If the data checked for matching in two or more conditions overlap, then the condition that is first in order is considered.

Some examples of using the Regexp option in Expression:

Examples - Using regexp

If you have the following input:

shipment cost 
cost of shipment 
Shipment cost: 
SHIPMENT

When you enter shipment, the result is:

shipment cost => true
cost of shipment => true
Shipment cost: => false
SHIPMENT => false

When you enter [Ss]hipment, the result is:

shipment => true
Shipment => true
Shipment cost: => true
SHIPMENT => false

[a-zA-Z] - Matches all lowercase and uppercase letters

\w+ - Matches any word character (alphanumerical or underscore) with at least one length

The Route function also enables you to handle data that is not matched with any of the conditions that you might have configured. In Handling of unmatched records, the available options are:

Discard: Discards the unmatched data
Create new output: Creates a new output with the name default and adds it to the Route Function in the stream editor.