FORMULA LANGUAGE
Given a server and file name, indicates the current user's level of access to the database.
Note If you used @UserAccess in Release 4, it is automatically converted to @V4UserAccess in Release 5 or later to preserve the functionality of your formulas. If you change those formulas to use @UserAccess, be sure to recompile them under Release 5. If you use @UserAccess in Release 5, a database created in Release 4 will not recognize the formula until you upgrade that database to Release 5. If the formula will be evaluated in Release 4, use @V4UserAccess.
Note The AccessPrivilege keyword option is new with Release 6.
Syntax
@UserAccess( server : file ; [ accessPrivilege ] )
Parameters
server
If you specify one or more keywords, returns a text value or a text list containing the following values:
@UserAccess does not test for access to the ReplicateOrCopyDocuments privilege by default.
Tip If the multi-value separator for the field containing the formula is a semicolon, the values in the returned text list are separated by semicolons instead of colons.
On a local database without "Enforce a consistent Access Control List," @UserAccess without the second parameter always returns 6; 1; 1; 1; 1; 1; 1; 1; 1. If the current user has No Access to the database, Lotus Notes/Domino displays a message: "You are not authorized to perform that operation."
This function does not work in column or selection formulas, or in agents that run on a server (mail and scheduled agents). Hence it does not work with the Evaluate statement.
Language cross-reference
QueryAccess method of LotusScript NotesDatabase class
CurrentAccessLevel property of LotusScript NotesDatabase class
queryAccess method of Java Database class
CurrentAccessLevel property of Java Database class
Example See Also