› Workflow › Business processes › Design a basic process › Add an activity › Activity types › Common activities › Loop activity › Configure a Loop activity

Configure a Loop activity

Use the following procedure to configure a Loop activity.

  1. Add an activity to the map.

    By default, the Configuration tab is open in the properties panel of the activity.

  2. Change the default Name of the activity to something meaningful.
  3. On the Type list, select Common > Loop.
  4. On the Complex variable list, select a Process or Server variable. If the required variable is not available, you can create a new variable directly from the activity properties panel. See Create a process variable while configuring activity properties.
  5. To set the index in which data will be retrieved, select a variable for the Current index. It is usually the same variable that is used for the updated index.
  6. To map the updated index count (the row+1), select a variable for the Updated index. It is usually the same as the current index.
  7. To check whether a row is found, select a variable for Row found.

    • When a row is found at runtime, all process variables mapped to variable member columns are updated with the contents of the columns from the row indicated. For example, if complex variable data has a few rows with email IDs for resources when the row is found, the email ID value is set to the process variable member, and the email ID is used to send an email.

    • When a row is not found, all process variables display the same values they had prior to calling the node.

    If you try to access a column that does not exist, the job is suspended, and a message appears.

  8. To specify whether the list field as a whole or its columns should be available for mapping in the Variable members list, select either option for Return:

    • Top level: The list field is displayed.

    • Child level: The corresponding columns of the list field are displayed.

  9. Map all columns or the columns that you need to a variable of the required type in the Mappings box.

    If the required variable is not available for the Current index, Updated index, Row found, and Columns within Variable members, you can create a new variable directly from the activity properties panel. See Create a process variable while configuring activity properties.

  10. Save the process map.