⚠ This page requires javascript enabled in browser
Automation / aclEZ Automation


Tag: ShowEffectiveAccess

The action ShowEffectiveAccess will emulate selecting the option 'Effective Access…' found in the Tools menu of aclEZ and the option 'Show Effective Access…' in the context menu of the main grid.

Note A grid selection is mandatory before running an Effective Access calculation.

<ShowEffectiveAccess RemoveAll="True">
<SetParam Field="Added" Value="John Admin/ACME"/>

Tag Attributes

Attribute NameAttribute ValueValue DescriptionComment
RemoveAllTrue/FalseDetermines if the new instance initiated by the script block will remove the preloaded names from the grid selectionNot Mandatory—If not used, operation will default to "False".

SetParam Options

Field NameCompatible Field ValuesValue DescriptionComment
AddedUser definableCanonical name of user to check effective access forNot Mandatory – *See detailed description

Detailed Description

A grid selection is mandatory before running an Effective Access calculation.
If the current grid selection is sufficient for the effective access calculation you want to perform, no additional names need to be added via SetParam actions.
In these cases, only the following is needed: <ShowEffectiveAccess/

Example Script

<?xml version="1.0" encoding="UTF-8"?>
<ytriaAutomation Application="aclEZ" ApplicationVersion="16.5">
<Load Server="ACME01/ACME"/>
<Select target="tree" database="mail/aglen.nsf"/>
<Select Lines="ByValue">
<SetParam ColumnID="ACL1" Value="Aaron Glen/ACME"/>
<SetParam Field="Added" Value="John Admin/ACME"/>
<SetParam Field="Added" Value="Dorothee Parker/ACME"/>

In the script above, the server "ACME01/ACME" will be loaded in aclEZ, and the database "aglen.nsf" will be selected in the selection tree. A grid selection in the main grid is made using the value "Aaron Glen/ACME" found in the column with the ID "ACL1" (this is the 'Name' column). The ShowEffectiveAccess action block will then trigger the Effective Access calculation for the selected name while also adding in the names "John Admin/ACME" and "Dorothee Parker/ACME". The results of the calculation will be shown in the 'Effective Access' panel.