Action: Scope

The Scope control allows grouping actions within a specific container/block in the Action Builder, that enables the encapsulation of actions in a set of actions, and specifies which actions should be executed based on the result of the action execution (IsSuccessful, HasFailed). Scope control helps to organize actions, manage the action execution. The main advantage of the Scope control is the handling of the errors within the scope: you can easily set up error handling within the scope in the HasFailed block. That helps to consolidate all errors in one and eliminate the need to set up error handling for each of the actions.

Scope control is available for Modern Forms, List Actions, Automation Actions and Scheduled/Triggered actions as well.

Example of Scope control configuration on the current site

Ein Bild, das Text, Screenshot, Software, Zahl enthält.

KI-generierte Inhalte können fehlerhaft sein.

For more information about Action Builder read Action Builder introduction article.

To configure the Scope control you need to add action/actions in the appropriate blocks:

Configuration

*Property*	*Required*	*Type*	*Description*
Scope action block	no		Block of actions will be executed within the scope.
Is successfull	no		Block of actions will be executed when actions in the Scope block executed successfully
Has failed	no		Block of actions will be executed when actions in the Scope block failed

Availability

*Modern Forms*	*List Actions*	*Scheduled/Triggered Actions*
✓	✓	✓

Output*

*Output Parameter*	*Type*	*Description*
IsSuccessful	Boolean	The output of this action returns true of false depends on the action execution was successfull or not
HasFailed	Boolean	The output of this action returns true of false
ErrorMessage	String	Returns error message in a case the one of the actions in a Scope action block fails
WarningMessages	String	Returns a list of warning messages in case actions within Scope action are successfully finished but with warnings (Scheduled/Triggered Actions)

* You can use outputs of the Scope inside the Scope in Is Successful and Has Failed blocks and also outside the Scope control.