Copy Task

Overview

The Copy Task node allows you to send a copy of a task to another Process. When you use the node, the task is essentially duplicated with one copy proceeding in the current Process and a new copy being passed to another Process. The two copies are independent of one another, but unlike the Call Process node, the Copy Task node does not wait for a response from the other Process.

Settings

The Copy Task node has the following parameters:

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

2. Basic settings:

   • Process to which you want to copy the task: You can select the needed Process by clicking the directory icon or by specifying its Process ID or Alias.
   • (Optional) Reference of the task copy: An identifier for the copied task.
   • Copy all task parameters to the new task:
     • The checkbox is selected: All current task parameters will be sent along with any parameters specified in the node.
     • The checkbox is cleared: Only the parameters specified in the node will be sent.

3. 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.

4. 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

Duplicating a task and adding a new parameter to the task copy

Description: Below, you can see the example where the Copy Task node is used to duplicate a task from the Original Process to the Destination Process.

Precondition:

1. Add the Copy Task node to your Original Process.
2. In Basic settings of the Copy Task node details panel, add:
   1. The Destination Process you want to copy a task from.
   2. The my_reference reference.
3. Select the Copy all task parameters to the new task checkbox.
4. In Parameters, add:
   1. The Origin parameter.
   2. The Hey, I’m from Copy value.

Flow: After adding a task to the Original Process, you can see that the Copy Task node not only duplicates the original task parameters but also adds some new ones. These system parameters are automatically generated by the Copy Task node and help trace the relationship between the original and copied tasks:

• copy_conv_id: Stores the ID of the Process (Original Process) from which the task was copied.
• copy_node_id: Indicates the ID of the Copy Task node that created the copied task.
• copy_ref_id: Stores the ID of the initial task from which the copy was created.

The task in the Original Process does not include the parameter that was defined within the Copy Task node but has the conveyor_copy_task_result parameter to keep track of whether the duplication was successful.

Error handling & troubleshooting

When an error occurs in the Copy Task node, a task goes to the auxiliary Condition output node that is used for storing error parameters.

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