Use Permission Areas

Once you defined the permission areas for your eSpace, Service Studio provides you a set of built-in actions and exceptions necessary to use these permission areas in your logic.

Permission Area Actions

Service Studio provides you a set of built-in actions that are available in the folder Permission Actions in the Tools tree and can be simply dropped it into your action flow (Collection of elements that graphically implements the behavior of an action. You can have assign and control elements, exception handlers or you can invoke other actions. The elements are linked through Connectors.). The Permission Actions folder is organized by Permission Area created for your eSpace.

For each Permission Area in your eSpace, Service Studio provides the following Permission Area actions:

CheckPermission: Checks whether a specific end-user has been granted access to a specific permission area. How
GrantPermission: Provides access for a specific end-user to a specific permission area. How

Not available for the Anonymous and Registered permission areas since either the end-user is registered or not.

RevokePermission: Denies access for a specific end-user to a specific permission area. How

Not available for the Anonymous and Registered permission areas since either the end-user is registered or not.

Permission Area Exceptions

For each Permission Area in your eSpace, Service Studio creates an exception with the following name not<Permission Area> raised when the user has not been granted permission to access that screen.

When the end-user tries to access a screen and does not have the rights to any Permission Area assigned to that screen, OutSystems Platform launches an exception. This exception corresponds to the first Permission Area that fails. The order by which the permission areas are evaluated is the order in which the permission areas were created, in Service Studio.

For example: if the end-user is not registered and is not an Administrator, and tries to access a screen that requires these permission areas, the exception raised is notRegistered.

Filtering Screens per Permission Area

Service Studio allows you to filter the screens associated to a specific Permission Area. Simply do one of the following:

Right-click on the permission area in the Permission Area folder, at the eSpace tree, and select Filter Screens or
use the Security Filter at the Toolbar of the Flow canvas.

The screens that are not associated with the selected permission area are displayed shaded.

To return to the normal view; i.e. all the screens with the same appearance, simply select the filter (none) in the Security Filter at the Toolbar of the Flow canvas.