Parallel For

The parallelFor step lets you iterate over a bunch of steps

Last published at: February 19th, 2025

parallelFor

Description:

The parallelFor step allows you to iterate over multiple steps; the workflow will dynamically expand at runtime based on the keys provided within the step configuration. Steps must be placed between the parallelFor step and the parallelForEnd step, as shown below.

The parallelFor step lets you define the start marker step.

 

Inputs

  • varKeys – list of keys comma separated ex: 1,2,3
  • varName – name of the variable to hold the key ex: variable.key
 

 

Returns

  • True – step executed successfully
  • False - step failed to execute
 

 

The parallelForEnd step lets you define the end marker step.

 

Inputs

  • None
 

 

Returns

  • None
 

 

 

Usage:

 

 

Example:

Let’s build and execute the “parallelFor-parallelForEndDef” example.          

  • Create a new definition called “parallelFor-parallelForEndDef” and open the definition in designer mode. 
  • Drag the “parallelFor, parallelForEnd, Synchronize, Placeholder, and Decision steps” step to the canvas. 
  • Connect the dots between the “Start” step and other steps, as shown above.
  • Define a variable or a global to store the key value.
  • Click the "parallelFor" step to configure its "Required" properties. Provide a name to the step. Provide a list of key values as below. The keys are comma-separated (as in 1,2,3 in this example), and the steps are iterated three times. A variable reference can also initialize the keys (which may contain 7, 3, 10), and the steps are iterated 3 times. The keys are always comma-separated by design. E.g., key-value 3 iterates only once, not three times.  Provide the variable or global reference to hold the key value. Click the Save button. Note: Click the "AI Predict" button for the Copilot to add new process steps that match your process description. 

 

  • Click the "decision" step to configure its "Required" properties. Provide a name for the step. Provide the condition to evaluate. Click the Save button. Note: Click the "AI Predict" button for the Copilot to add new process steps that match your process description. 

 

  • Click the "parallelForEnd" step to configure its "Required" properties. Provide a name for the step. Click the Save button. Note: Click the "AI Predict" button for the Copilot to add new process steps that match your process description. 

 

  • Save the process definition, create a new instance, and then execute it. Render the process instance. Once executed, the workflow will automatically grow to have the number of paths based on the number of keys, as shown below.

 

Definition Sample:

You may download the sample definition(s) from the link here and later import them (drag-and-drop) to your FlowWright Process Definition (XML file) or Form Definition (HTML file) page.

Note: Please verify and complete the process steps for any missing configurations, such as file path references and database connections, after import. Then, save the definition to confirm the changes.

Click here to download the sample file.