The Loop on Items component enables a workflow to repeatedly execute one or more actions for each item in a collection. Instead of creating separate workflow branches for similar tasks, the component processes each item sequentially within a single loop, simplifying workflow design and improving maintainability.
Use the Loop on Items component when the same workflow actions must be performed for multiple records. The component automatically iterates through each item in the collection and executes the configured workflow steps until all items are processed.
The Loop component repeatedly executes the configured workflow actions for each item in the provided input collection.
Figure: Loop an Item component
User Persona: Administrator
Benefits
Automates repetitive tasks
Reduces workflow complexity
Improves consistency
Key Features
Executes the configured workflow steps for each item in a collection, one item at a time.
Eliminates the need to create duplicate workflow branches for repetitive tasks.
Ensures the loop has valid incoming, body, and Done connections before the workflow can be saved
Simplifies workflow design by centralizing repetitive processing within a single component.
How It Works
Example
A hardware replacement workflow retrieves a list of laptops that require operating system updates. The Loop on Items component processes each laptop one at a time, updates the asset record, creates a maintenance task, and then proceeds to the next laptop. After every laptop has been processed, the workflow continues to the notification step.
Configure Loop on Items
To configure Loop on Items, perform the following steps:
From the Workflow canvas, drag and drop the Loop on Items component in the Workflow canvas.
The Loop on Items component in the Workflow Canvas is displayed.
Figure: Loop on ItemsNotes
The Loop component requires an array or object collection as input. Select the input by referencing the output of a previous workflow component. The actions within the Loop component execute sequentially for each item in the input collection.
Workflow nodes within a Loop can connect only to other nodes inside the same Loop. Connections to nodes outside the Loop are not supported.
Configure the Start component to pass an input array. The Loop on Items component iterates through each item and continues the workflow through the Done connection when processing is complete.
Right-click Loop on Items component and click Properties.
The Loop on Items properties page is displayed.
Figure: Loop on Items - PropertiesEnter the required details as described in the following table and click Save Changes.
Field
Description
Loop on Items name
Enter the Loop on Item name in the textbox to be viewed on the component.
LOOP CONFIGURATION
Maximum Loop Count
Enter or select the loop count. By default, 99 count is displayed.
Item Source
Specify the array to iterate through:
Select a workflow variable to use an array passed during workflow execution.
Alternatively, provide a static array.
Variable Reference
Select the variable from the list. The listed values are displayed based on selected Item Source.
Drag the required workflow components (for example, Custom Code or Notification) inside the Loop on Items container.
Configure the Custom Code or Notification components and connect the nodes in the Loop on Items.
Click Save.