What are Exclusion Groups?
Exclusion Groups are used to group Actionflows and limit their ability to run at the same time.
Where multiple Actionflows have the same exclusion group, only one Actionflow will be able to run at any one time. Attempting to run a second Actionflow, with the same exclusion group, will return a warning message and the Actionflow will not run. This applies whether the Actionflow is run manually or automatically using a schedule.
Exclusion groups are evaluated before any Actionflows are started. When an Actionflow with an exclusion group is triggered, if no other Actionflow with the same exclusion group is already running then the Actionflow will continue. The action will be considered to be using this exclusion group from this point until the Actionflow has completed.
Setting Exclusion Groups
- Open an Actionflow and open its Properties
- Under Basic Settings, populate the Exclusion Group field with any text to indicate the group
- This field is case insensitive and can take any free text
- Repeat this with other Actionflows to add them to the same Exclusion Group
Worked Example
Here's a worked example using the Company Data (available from the Learning Centre).
In this example, we are using:
- A Company Orders screen containing two grids of the Orders and OrderLines data - this screen was created using the Multi-tile template
If you are completing this chapter as part of the Actionflow course and using a training instance, the data and screens have already been pre-loaded into the Actionflow Advanced Application. For this example, we'll be working on the Company Orders screen.
Example: Setting an Exclusion Group
In this example, we'll add two Actionflows to the same exclusion group to see the warning that appears when triggering both Actionflows at the same time. This example is just for demonstration purposes.
Actionflow Setup
- Open the Company Orders screen
- Open the Actionflow on the Edit button and open the Properties
- Under Basic Settings, populate the Exclusion Group field with any text, e.g.
Orders
- Repeat these steps with the Actionflow on the Add button on the Company Orders screen
- On the Actionflow on the Add button, create a Calculate action with an Output Attribute:
- Name:
Delay
- Type:
Integer
- Expression:
sleep(20)
- This will add a delay into the Actionflow for demonstration purposes. See sleep
- Name:
- Insert the Delay Calculate action onto the connector between the input and Open Screen
Testing
- Open the Company Orders screen
- Click Add then immediately click Edit
- The warning message will appear
- After 20 seconds, the Order Form will open