Set State

Overview

The Set State node is designed to store tasks and control their flow through a State Diagram. It allows you to keep a task within the node until a certain condition is met and then direct it to move to the next node associated with that condition. In a way, the Set State node in a State Diagram combines the functionality of the Condition and Waiting for Callback nodes found in Processes.
In a State Diagram, you have the flexibility to manage tasks from outside the diagram by using:

• Modify Task node
• API Call node
• Manually created or imported tasks in the View mode

Settings

The Set State node has the following parameters:

1. (Optional) Title and Description: Name and details of the node.
2. + Add condition:

   1. Key: Key to specify variables; use curly brackets to enter the key. For example, {{age}}.

   2. Comparison operator: The way the key and the value have to be compared:

      • Equal to (==)
      • Not equal (!=)
      • More than (>)
      • More than or equal to (>=)
      • Less than (<)
      • Less than or equal to(<=)
      • Regular Expression (RegExp)).

   3. Value: The value you want to assign to the corresponding Key parameter. The value can be a constant, a variable reference, or a function applied to a variable.
      Note: For more information, go to Parameters and functions.

   4. Type of data :

      • String (S)
      • Number (N)
      • Boolean (B)
      • Array (A)
      • Object (O)
        Note: For more information, go to Data types.

3. Other:

   • Alert if the number of tasks in the node queue reaches the following number: Helps monitor whether the number of tasks in the node exceeds the specified threshold. When selecting the checkbox, you have to enter the needed number of tasks in the field that appears below.
   • Maximum interval, for which the task stays in the node before being forwarded: The amount of time a task is allowed to be in the node can be set in seconds, minutes, hours, and days.
     Note: The checkbox has a minimum value of 30 seconds. You can set a shorter interval by using the Unixtime function.

   

Examples

Storage
Description: In the example below, you can see how to safely store any values you might need to run your Processes, such as login and password, within the Set State node.

Precondition:

1. Create a State Diagram.
2. Add the Set State node.
3. Add tasks with sensitive parameters.

Flow: You can refer to sensitive parameters when you need to use them in other State Diagrams, without revealing their actual value.

Reacting to task parameters changes
Description: In the example below, you can see how the Set State node handles and modifies the received tasks.

Precondition:

1. Create a State Diagram.
2. Add the Set State node.
3. In the Condition block of the Set State node, add the Status key and the Inactive value.

Flow:

• The condition is met.
  

• The condition is not met.
  

Error handling & troubleshooting

When working with your State Diagram, you may encounter the following issues.