Loop Over Items

The Loop Over Items node helps you loop through data.

The node saves the original incoming data, and with each iteration, returns a predefined amount of data through the loop output.

When the node execution completes, it combines all the data and returns it through the done output.

Node reference

• Batch Size: the number of items to return with each call.
• Options:
  • Reset: if set to true, the node will reset.

Check if you need this node

Ensemble automatically processes incoming items. You may not need the Loop Over Items node in your workflow. To learn more about how Ensemble handles multiple items, refer to the documentation on Looping in Ensemble.

Example usage: Read RSS feed from two different sources

This Pathway allows you to read an RSS feed from two different sources using the Loop Over Items node. You need the Loop Over Items node in the Pathway as the RSS Feed Read node only processes the first item it receives.

1. Add the manual trigger.
2. Add the Code node.
3. Copy this code into the Code node:

   return [
   {
   json: {
   url: 'https://medium.com/feed/ensemble-io',
   }
   },
   {
   json: {
   url: 'https://dev.to/feed/ensemble',
   }
   }
   ];
   

4. Add the Loop Over Items node.
5. Configure Loop Over Items: set the batch size to 1 in the Batch Size field.
6. Add the RSS Feed Read node.
7. Select Execute Workflow. This runs the Pathway to load data into the RSS Feed Read node.
8. Configure RSS Feed Read: map url from the input to the URL field. You can do this by dragging and dropping from the INPUT panel, or using this expression: {{ $json.url }}.
9. Select Execute Workflow to run the Pathway and see the resulting data.

Check that the node has processed all items

To check if the node still has items to process, use the following expression: {{$node["Loop Over Items"].context["noItemsLeft"]}}. This expression returns a boolean value. If the node still has data to process, the expression returns false, otherwise it returns true.

Get the current running index of the node

To get the current running index of the node, use the following expression: {{$node["Loop Over Items"].context["currentRunIndex"];}}.