Execute Actions on Entity List

Audience: Citizen Developer
Skill Prerequisites: Using Form Builder

This action will execute the specified actions for each item that belongs to the entity collection named in the EntityName parameter. To access field values from the currently iterated entity in the specified actions, use this token syntax:[EntityName:EntityFieldName].

Typical Use Cases

  • Use the Send Email action to send individual emails to a list of people in an entity.
  • Use the Run SQL Query action to insert the records in an entity to a table in the database.

Don't use it to

  • Run actions on data not loaded into an entity. Just run the actions normally.

Related Actions

Action NameDescription
Create EntityCreates an entity in the current context to which you can load values from the current context. Use this to create the entity that will be processed with this action.
Load Entities (CSV File)Creates an entity in the current context from the content of a provided CSV file. Use this to create the entity that will be processed with this action.
Load Entities (CSV)Creates an entity in the current context from a CSV list. Use this to create the entity that will be processed with this action.
Load Entities (Excel File) XSLXCreates an entity in the current context from the content of a provided Excel(XLSX) file. Use this to create the entity that will be processed with this action.
Load Entities (JSON)Creates an entity in the current context from the provided JSON model. Use this to create the entity that will be processed with this action.
Load Entities (SQL)Creates an entity in the current context from the result of the provided SQL Query. Use this to create the entity that will be processed with this action.

Input Parameter Reference

The parameters unique to this action are listed below. Review the common parameters for all actions here.

ParameterDescriptionSupports TokensDefaultRequired
Entity NameName of the entity list on which the specified actions will execute.Yesempty stringYes
FiltersSpecify one or more Field and Value pairs to filter the items from the entity on which the action will execute.YesNone SpecifiedNo
Context BehaviorDepending on how you use this action, you might want to change the scope of the generated tokens.
  • The Update all tokens in the original context option will copy all the tokens generated in each iteration to the original context that was before this action
  • The Don't save the iteration tokens option will NOT keep any tokens generated in this action, not even from one iteration to the other.
  • The Update the tokens in the initial context option will allow you to save the tokens in the original context (before this action) and from one iteration to another, IF the tokens exist in the original context, meaning that you have to initialize them before this action.
NoNone SelectedNo
Action ListSpecify the actions that will be executed on each item in the entity list. Refer to the fields of the loaded entity using the [EntityName:EntityFieldName] token syntax.YesNone SpecifiedNo
Continue on errorContinues to the next iteration even if the current one failed to execute.NofalseNo
On ErrorSpecify the Actions that will be executed if an error is caught in one iteration. If Continue On Error is checked, final actions like Display Message/Error won't be executed.YesNone SpecifiedNo
Last updated on by Patrick Anderson