For Each

for each action performs an action (or a set of actions) included within foreach border foreach action enables you to step through lists and iterate through the data and process each information (row) individually the elements of a list can be referenced in the action(s) within the border by creating and using a local variable (iterator) to show how foreach works, let's create a process that goes through each element of a list (list of contacts and email addresses) and sends emails out to each and one of them how to configure the for each action? go to the process designers section and open a new or an existing process actions configuration can be performed once they are dragged and dropped on canvas step 1 drag the for each action from toolbar and drop it on canvas step 2 from the process variables (x) panel, create a new process variable, called inputdata inputdata with the following specs type clientdetails clientdetails (data model with 3 attributes email, name, body type string) ; list set as input step 3 for each properties panel configuration select the list to iterate through, i e inputdata in list represents the list of items you want to iterate through select from the process variables selector a list type variable select the inputdata inputdata list from the selector 2\ set the iterator name (you can name it iterator iterator or row or entry etc) for each item represents the item in the list used for each iteration you can create a local variable by manually entering a name for it this local variable will be further used in the actions within foreach we will name it now "iterator" 2\ action timeout you can set the maximum number of seconds this action and its enclosing actions are allowed to run for; when time expires, the next iteration will stop the action setting the value to 0 means there is no timeout at all, allowing the action to run for an unlimited number of iterations step 4 after releasing the for each action on canvas (step 1), you will notice that it expands by default (becoming a bordered area) all the actions inside this border will be executed for each item in list within the border, you can add any type of action from toolbar like in any process flow, except for start and stop there is already a start icon indication from where the for each action flow starts processing; you have to connect the first action to the start icon and you cannot delete it the drag\&drop of a "stop" action within a foreach loop is currently prohibited, as it would prematurely terminate the entire process after a single iteration however, a forthcoming action called "exit foreach" is being developed specifically to address this need by allowing for a controlled exit from a foreach loop now you can start adding actions within the border drag an action from toolbar and connect it to the start icon within the border step 5 add the send email action within the border click on it and the corresponding properties panel of the action will open in send email action configuration, use the iterator variable iterator variable created to reference each element of the list to reference each element of the list step 6 save , validate and run the process give values to the list run the process the for each action iterates through each of the values specified in the list variable and will send separate emails to each element in the list tips & tricks in order to add more actions, you need to resize the border by dragging the bottom right corner of the border add new actions from toolbar within the border ensure the border is wide enough to accommodate the actions you want to drag within its area ensure there is enough space on the canvas to expand the foreach border you can move the actions placed on the canvas in order to create space to expand the border