Queue

Overview

The Queue node enables you to temporarily hold a task until you are ready to process it. It is commonly used when tasks require manual intervention, such as when an employee needs to perform certain actions to process an order, such as contacting a client or preparing an order for shipment.
A workflow involving the Queue node consists of two Processes:

• Includes the Queue node, which accumulates and holds all incoming tasks until they are ready for processing.
• Involves the Get from Queue node, which is used to retrieve tasks when you are prepared to process them.

Settings

The Queue node has the following parameters:

1. (Optional) Title and Description: Name and details of the node.

2. Additional Parameters:

   • Key: Key to specify variables; use a unique name. When updating existing variables, use their original names as a key.
   • 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.
   • Type of data:
     • String (S)
     • Number (N)
     • Boolean (B)
     • Array (A)
     • Object (O)
   • Code editor: Shows the JSON format of the entered key and value. You can write and include additional code, which will be executed when a task enters the node.
   • To add a key-value, click + Add “key-value” below the Key field.
   • To delete the key-value line, click the trash icon on the right side of the key-value line.

   

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

Using Queue and Get from Queue nodes together
In the example below, you can see how the Queue node in one Process and the Get from Queue node in another Process work together. The parameter specified in the Queue node is not added to the tasks until after they pass through that node. Two parameters are added to a task when it is released from the Get from Queue node:

• queue_task_id: Contains the task ID of the stored task and is useful for tracking and identifying individual tasks as they are retrieved from the Queue node.
• queue_task_data: Contains the task parameters of the stored task that include the data that the task originally had, as well as any additional parameters that were specified in the Queue node.

Error handling & troubleshooting

When an error occurs during the task processing, you may see the following error parameter names in the task.