Create a Conditional Node

There are two steps to add a conditional node to a recipe graph: create the node with conditions, then connect the node to other nodes in the graph.

Create the conditional node and conditions

1. On the Recipes page, select your recipe, then select the variation to open the graphical view.
2. Click Add Condition above the graph.

3. In the Add Condition dialog, select the type of condition evaluation you want to define.

   • True/False Result: Define a logic statement that can produce a true or false result, then define the node processing conditions for both outcomes.

     This evaluation is less error-prone because you write statements with an either/or result.

   • Multi-Value Cases: Define logic statements against a variable, then define the node processing that should occur for a true result from each of those statements.

     This type of evaluation requires great care in accounting for all possible results.

True/False Result

If you selected True/False Result, complete the Configure Condition dialog:

1. Enter a name for the node.
2. Optional. Enter a description.
3. Select a variable from the list. Type a name in the field to search for a specific variable. Variables available are those already defined in the recipe, variation, or kitchen.
4. In the next field, select an operator (==, >, >=, <, <=) from the drop-down list.
5. For Value, select another variable or enter a static value. The system compares this variable or value to the current value of the variable set in step 3.
6. Select the type of value for the variable from step 3. This selection tells the platform to evaluate the variable as a specific data type.
7. Select the nodes the system will execute if the logic statement result is true. Options include all outgoing nodes, no outgoing nodes, or one or more specific nodes.
8. Select the nodes the system will execute if the logic statement result is false. Options include all outgoing nodes, no outgoing nodes, or one or more specific nodes.

9. Click Add Condition.

   Note

   The system prevents duplicate conditions. A condition cannot execute the same node for more than one result of its evaluation. For example, selecting "All outgoing nodes" for one result prevents selecting any node or nodes for the other result.

10. Select Add notes for changelog , describe the changes, then click Update.

Once saved, the conditional node appears on the variation graph with connections (i.e. edges) between itself and any nodes selected in steps 7 and/or 8. These edges will appear blue.

Multi-Value Cases

If you selected Multi-Value Cases, complete the Configure Condition dialog:

1. Enter a name for the node.
2. Optional. Enter a description.
3. Select a variable from the list. Type a name in the field to search for a specific variable. Variables available are those already defined in the recipe, variation, or kitchen.
4. Select the data type used to evaluate the value this variable stores in Type Conversion.
5. If variable logic statement: Select an operator (==, >, >=, <, <=) from the drop-down list.
6. For Value, select another variable or enter a static value. The system compares this variable or value to the current value for the variable set in step 3.
7. Select the nodes to execute when the comparison is true.
8. Optional. Click Add Case to create additional logic statements. Repeat steps 5 to 7.
9. Click Add Condition.
10. Select Add notes for changelog , describe the changes, then click Update.

Once saved, the conditional node appears on the variation graph with connections (i.e. edges) between itself and any nodes selected in step 7. These edges will appear blue.

Connect the node with edges

Create an incoming edge

To connect any source node in the graph to the newly created conditional node:

1. Click Add Edge.
2. Select a node in the graph as the source node for the edge.
3. Select the new conditional node as the target node.

Outgoing conditional edge logic

The nodes that will (or will not) be processed based on the outcome of the condition evaluation are defined when creating the conditional node. In the graph, these nodes are connected to the conditional node by blue edges when the graph is saved.

To change the connected nodes, select the conditional node in the graph, then select Edit Condition. Make changes to what nodes should execute.

Create an outgoing non-conditional edge

To connect the conditional node to any other node in the graph, without using a condition:

1. Click Add Edge.
2. Select the conditional node to set it as the source node for the edge.
3. Select the node you want to be subject to the condition.

Because this edge was not created through the Configure Condition dialogue, there is no condition on it, and the path will always be executed. This edge will appear gray when the graph is saved.

Visual example in Automation

An example of the Configure Condition dialog for True/False Result conditional node creation.

An example of the Configuration Condition dialog for Multi-Value Cases conditional node creation.