Action: Scope

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.


    • Related Articles

    • Secure Azure Function with Microsoft Entra ID for calling from Modern Forms and Automation Actions

      This article will provide an example how to secure your Azure Function with Microsoft Entra ID to make secure calls from Modern Forms and Automation Actions using Start Power Automate / Azure Function action Secure Azure Function with Microsoft ...
    • Action Builder Introduction

      The Teamsware Studio Action Builder is a tool that allows you to specify actions which are executed in consecutive order. You can build powerful workflows triggered from a form button, on form load, from a list view, scheduled or event triggered on a ...
    • Action: Send Mail in Rich Forms and Action Links

      Send Mail action allows dynamically sending emails from your SharePoint site to any email address. Example: * Configurations are available for actions that use the Microsoft Graph Send Mail API. Note: In order to use the Send Mail action in Rich ...
    • Action: Condition

      Condition action identifies which block of actions to execute based on the evaluation of a condition. Example of Condition action configuration For more information about Action Builder read Action Builder introduction article. To configure the ...
    • Action: Delete meeting

      Delete meeting action will delete online meeting from the calendar in Microsoft Teams and in Outlook as well. It allows to delete both a single meeting and a series of meetings. Example of Delete meeting action configuration on the current site For ...