Insert excerpt
_security_icon _security_icon nopanel true

 Security and Permissions

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.

Image Removed

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

Image Removed

Security can be applied to Actionflows so that only those with sufficient permissions can run the Actionflow. In addition, if an Actionflow is assigned to a button and the user does not have permission to run the Actionflow, the button will not be displayed on a screen. 

Permissions can also be set on form fields, table attributes and screens. For example, if a user does not have permission to view the form fields but runs an Actionflow that uses these fields, the Actionflow will show an error. 

Access Permissions 

For some items, you can specify a user group, e.g. Managers, or set of user groups, where only users in this group(s) have permission to see the item.

Image Added

Image Added

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 Merger Pop up screen containing:
  • two manual drop down fields of the company name's of the companies to be merged
  • two string fields showing the company ID's of the companies to be merged
  • a button to initiate the Actionflow - this screen was created using the
  Multi-tile
  •  Tile no Buttons template

Limit Permission to Merge Companies

In this example, we'll create an Actionflow to import the AdditionalCompanies_Processed data and add the Status of New to each company on that table before adding it to the Companies table. We'll add this Actionflow to an Exclusion Group with other Actionflows on the same screen so that other processes cannot be triggered while the import is taking place.

Image Removed

Actionflow Setup

limit the users/user groups that can run the Actionflow that merges two companies together.

Image Added

Prerequisites

For this example, we'll limit permission to run an Actionflow that merges two companies together. This Actionflow was created in 3.02 Bulk Update Action Configuration. If you have not completed this chapter, expand the section below and follow the steps to create the Actionflows.

Alternatively, you can follow the instructions below to limit access to any Actionflow in your application.

Create Limited Access User

1. In the 

   Insert excerpt
   _

   tables

   repository _

   tables

   repository name

   icon

   full nopanel true

    icon
   1. Drag across the AdditionalCompanies_Processed table from the Repository to the Analysis action properties

   Connect the Calculate action to the Analysis action and map across the attribute

   Expand
   title Checkpoint
   Image Removed

Table Attributes Setup

1. On the Analysis Model, Actionflow Advanced Data, click on the table, AdditionalCompanies_Processed
2. Double-click on the attribute, Status, and change the Expression to _context.Status
   1. This is then referring to the attribute setup on the Calculate action
3. Save the Analysis Model

Combine Data & Display 

1. On the Actionflow, create a , expand the 

   Insert excerpt
   _user _user nopanel true

    section 
2. Click 

   Insert excerpt
   _actionadd_viewicon _actionadd_viewicon nopanel true

    action with the Primary Table, AdditionalCompanies_Processed, and connect the Analysis action to the View action
3. In its Properties, in the Data Retrieval Options section, set the Data Range to Latest
   1. This will ensure that this data isn't continuously added if the Actionflow is run repeatedly
For the Output Attributes section, click the  to create a new user who will not have access to run the acquisition
1. Login: limitedaccess
2. First Name: Limited
3. Surname: Access
4. Password: Phixflow123!
5. Enabled: 

   Insert excerpt
   _attributestoggle_iconon _attributestoggle_iconon nopanel true

    icon and drag across all attributes
Create a 
2. Insert excerpt

_action

1. _save

_action

1. _save nopanel true

 action to save the data to the Companies table
1.  the user
2. In its Properties, in the Basic Settings section, set the Type to Insert and the User Groups section, click the 

   Insert excerpt
   _toggleuser_ongroup _toggle_onuser_group name icon nopanel true

    toggle on Auto Save Attributes
Connect the View to the Save action and map across all attributes

Image Removed

Expand
title Checkpoint
Image Removed

1. 1. icon
      1. Drag across the User Groups, Actionflow Advanced Application and Users into the User Groups section of the Limited Access user
         1. There will be two Actionflow Advanced Application user groups. Ensure the one ending _Admin is not chosen

   2. Insert excerpt
      _finish _finish nopanel true

       all tabs

Image AddedImage Added

Change Actionflow Permissions

1. Open the Company Merger Pop up screen and open the Actionflow on the Run Acquisition button
2. Open the Actionflow 

   Insert excerpt
   _property_settings _property_settings nopanel true

    
   1. Under Basic Settings, populate the Exclusion Group field with any text, e.g. Import
   2. Image Removed

   Add the same Actionflow to the Import button the Company Management screen

   Expand

   title	How?

   On the ImportCompanies Actionflow, open the 
3. Click on the 

   Insert excerpt
   _property_tabs _property_tabs name security nopanel true

4. Disable 

   Insert excerpt
   _

   property

   toggle_

   settings

   off _

   property

   toggle_

   settings

   off nopanel true

   , hover over  All Users can Run Action
5. Click the 

   Insert excerpt
   _

   more

   user_

   options

   group _

   more

   user_

   options

   group name icon nopanel true

    icon and choose drag across the User Group, Actionflow Advanced Application_Admin into the User Groups section of the 

   Insert excerpt
   _

   repository

   property_

   find

   tabs _

   repository_find

   property_tabs name security nopanel true

6. Open the Company Management screen and drag the highlighted Actionflow from the Repository onto the Import button
   1. This will create another instance of the same Actionflow

Testing

Image Removed

1.  
   1. This limits the permission to run this Actionflow to just this User Group

Image Added

Testing

1. Log out and login as the user, Limited Access
   1. You should not be able to see the Run Acquisition button on the Company Merger Pop up screen

Image Modified