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 PermissionGranted to return the user's security permission status.

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.