For a database on a server or a local replicated database, returns a list of roles that the current user has. Roles are defined in a database's access control list.

Syntax

@UserRoles

Return value

roles

Text list. Each item in the list is the name of a role that the current user has in the current database. The role names are enclosed in brackets. Returns an empty string ("") if the current database is local and not a replication.

This function does not work in column, selection, mail agent, or scheduled agent formulas.

Only roles explicitly assigned to the current user are returned. Roles assigned to a group which includes the current user are not returned.

@UserRoles appends $$WebClient to the list of roles when a Web user opens a database.

@UserRoles returns a subset of the information returned by @UserNamesList.

Language cross-reference

Roles property of LotusScript NotesACLEntry class

Roles property of Java ACLEntry class

Example
See Also

Accessing the user environment
"Taking your Domino applications to the Web" on the Lotus Developer Domain
"Creating field help for your Domino applications (Part 2)" on the Lotus Developer Domain
"Simplifying your LotusScript with the Evaluate statement" on the Lotus Developer Domain
"Using a database to store Web site graphics" on the Lotus Developer Domain
"New Web design features in Notes Designer" on the Lotus Developer Domain

Glossary