Decision Operator

The Decision operator lets Creators configure dynamic, logical decisions based on specific conditions or rules, directing the process to different paths depending on end-user input or data. After evaluating conditions, the operator determines which actions or steps to take next. Doing so lets the Data Workflow adapt to various scenarios, ensuring that end-users only see relevant steps and that business rules are consistently followed, improving both efficiency and end-user experience.

To configure a Decision operator, use the Info window and define a condition. This condition uses comparison symbols, like <, >, =, >=, or <=, to evaluate incoming data. For example, to determine whether an end-user's income is greater than 100,000, your condition might look like the following: A > 100000. The A represents the incoming value, and 100000 is the threshold.

For more advanced logic, you can use an OR statement. For example, OR(A="a", A="b", A="c"). This configuration returns true if the input value matches "a", "b", or "c". All other values return false.

The Decision operator evaluates conditions and routes data based on the result. It passes data through one output port at a time. The port that does not receive data displays as _BLOCKED, and any steps connected to that port do not execute.

Using Arguments in Conditions

You can configure a Decision operator to evaluate a condition using an argument from another operator. After connecting an operator to the Decision operator’s argument port (top), you’ll enter _arg in the Condition field of the Decision operator’s Info window.

The argument must return a string or Boolean value. Your condition should use a standard comparison format, like <, >, =, >=, or <=. The condition must be either TRUE or FALSE.

You'll find the Decisions operator under the Gateways group to the left of the Data Workflow canvas.

About the Info Window

Here's a breakdown of each setting in the Info window:

Adding a Decision Operator

In this example, you’ll create a module that collects an end-user’s income. Then, you’ll use a Data Workflow to recommend a financial adviser to the end-user based on the income entered.

Configure the Columns Component

First, configure a Columns component that acts as a container for the components that follow.

1. In the Module Builder, drag and drop a Columns component onto your canvas.

2. In the Property ID field, enter colAdviser.

3. Click Save Component.

Configure the Number Component

Next, configure a Number component to collect the income of your end-user.

1. Drag and drop a Number component onto your canvas, placing it inside the left column of the colAdviser Columns component.

2. In the Property ID field, enter income.

3. In the Label Text field, enter Current Household Income.

4. Set Show Thousands Separator to (ON).

5. Set Currency to (ON).

   

6. Click Save Component.

Configure the Text Field Component

Next, add a Text Field component to display the output of your Data Workflow. This field displays the recommended financial adviser to the end-user. Because the end-user does not need to enter any information in this field, set it to read-only.

1. Drag and drop a Text Field component onto your canvas, placing it inside the right column of the colAdviser Columns component.

2. In the Property ID field, enter financialAdviser.

3. In the Label Text field, enter Recommended Financial Adviser.

4. From the Input Behavior drop-down, select Read Only - Accessible (New).

   

5. Click Save Component.

Configure the Data Workflow Component

Lastly, set up the Data Workflow with an Input operator that brings in your end-user's income. Then, use a Decision operator to determine which financial adviser to recommend. Add Console operators to help you view how the data passes to each step.

1. Drag and drop a Data Workflow onto your canvas, placing it below your colAdviser Columns component.

2. In the Property ID and Canvas Label Text fields, enter dwfFinancialAdviser.

3. From the Trigger Type drop-down, select Watch.

Configure the Input Operator

1. Drag and drop an Input operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Setting	Value
   Category	Input
   Component	income
   Required	Yes
   Source	Default

Configure the Decision Operator

1. Drag and drop a Decision operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Setting	Value
   Category	Decision
   Input List	income
   Preserve Argument Type	(unchecked)
   Condition	A > 100000

3. Connect the output port (right) of the Input operator to the input port (left) of the Decision operator.

Configure the First Create Value Operator

1. Drag and drop a Create Value operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Setting	Value
   Category	Create Value
   Label	Decision True
   Preserve Argument Type	(unchecked)
   Expression/Value	"Andrea Matthews"

3. Connect the upper output port (right) of the Decision operator to the argument port (top) of the Decision True Create Value operator.

Configure the First Output Operator

1. Drag and drop an Output operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Setting	Value
   Category	Output
   Component	financialAdviser
   Action	value

3. Connect the output port (right) of the Decision True Create Value operator to the input port (left) of the financialAdviser Output operator.

Configure the First Console Operator

1. Drag and drop a Console operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Setting	Value
   Category	Console
   Label	Console Decision True

3. Connect the upper output port (right) of the Decision operator to the input port (left) of the Console Decision True Console operator.

Configure the Second Create Value Operator

1. Drag and drop a second Create Value operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Setting	Value
   Category	Create Value
   Label	Decision False
   Preserve Argument Type	(unchecked)
   Expression/Value	"Rachel Moose"

3. Connect the lower output port (right) of the Decision operator to the argument port (top) of the Decision False Create Value operator.

Configure the Second Output Operator

1. Drag and drop a second Output operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Setting	Value
   Category	Output
   Component	financialAdviser
   Action	value

3. Connect the output port (right) of the Decision False Create Value operator to the input port (left) of the financialAdviser Output operator.

Configure the Second Console Operator

1. Drag and drop a second Console operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Setting	Value
   Category	Console
   Label	Console Decision False

3. Connect the lower output port (right) of the Decision operator to the input port (left) of the Console Decision False Console operator.

4. Click Save Component.

5. Save your module.

Here's how the completed example looks in the Module Builder:

Preview your module in Express View and open the DevTools Console. Enter a value in your Current Household Income field, and you'll see the Recommended Financial Adviser update in real-time.

You'll see one of two scenarios:

• When the income is less than 100,000, the TRUE condition is _BLOCKED, and the FALSE condition displays the value.

• When the income is greater than 100,000, the FALSE condition is _BLOCKED, and the TRUE condition displays the value.