AX2371
GetSecurityInfo("PermissionGranted")
If "PermissionGranted" is specified as the first parameter, GetSecurityInfo returns whether the user has a specific security permission (TRUE/FALSE), given a permission name. Security permissions are defined on the Permissions tab of the Security dialog.
Syntax
GetSecurityInfo("PermissionGranted", "PermissionName", "UserName","Domain")
Parameter | Description |
---|---|
PermissionGranted |
Use the code |
PermissionName |
The name of the permission to check. See the following table for specific values. |
UserName |
Optional. The name of the user or role for which to return the security information. If omitted, the current user is assumed. |
Domain |
Optional. The Active Directory domain of the user. The domain property only applies to users that have been imported from Active Directory. Manually created users do not have a value for domain. You might be required to specify a domain to identify the correct user if users have been imported from multiple Active Directory domains and have the same user name. If all user names are unique across domains, then it is not necessary to specify the domain. |
The parameter PermissionName takes the following values:
Security Permission | Value To Use In GetSecurityInfo |
---|---|
Administer Announcements |
AdministerAnnouncements |
Administer Axiom Explorer |
AdministerRepository |
Administer Exports |
AdministerExports |
Administer File Groups |
AdministerFileGroups |
Administer Imports |
AdministerImports |
Administer Locked Items |
AdministerLockedItems |
Administer Picklists |
AdministerPicklists |
Administer Security |
AdministerSecurity |
Administer Tables |
AdministerTables |
Administer Task Panes |
AdministerTaskPanes |
Administer Updates |
AdministerUpdates |
Browse Audit History |
BrowseAuditHistory |
Remove Protection |
RemoveWorkbookProtection |
Scheduled Jobs User |
ScheduledJobsUser |
User Documents Folder Access |
HasUserDocumentsFolder |
Remarks
GetSecurityInfo is a volatile function.
Examples
=GetSecurityInfo("PermissionGranted","ScheduledJobsUser")
This example returns "TRUE" if the current user has the Scheduled Jobs User permission.
=GetSecurityInfo("PermissionGranted","ScheduledJobsUser","Jdoe")
This example returns "FALSE" if user Jdoe does not have the Scheduled Jobs User permission.
=GetSecurityInfo("PermissionGranted","ScheduledJobsUser","Jdoe","Corporate")
This example returns information for the user Jdoe who was imported from the Corporate domain. This would be necessary if another user named Jdoe was imported from a different Active Directory domain.