Dado un servidor y un nombre de archivo, indica el acceso del usuario actual a la base de datos.

Nota Si utilizó la función @UserAccess en la Versión 4, la Versión 5 o posteriores la convertirán automáticamente a @V4UserAccess para asegurar el buen funcionamiento de sus fórmulas. Si cambia estas fórmulas para que utilicen la función @UserAccess, asegúrese de volver a compilarlas en la Versión 5. Si utiliza @UserAccess en la Versión 5, las bases de datos creadas con la Versión 4 no reconocerán la fórmula hasta que actualice dichas bases de datos a la Versión 5. Si la fórmula va a ser evaluada en la Versión 4, use @V4UserAccess.

Nota La opción de palabra clave privilegio-de-acceso es una novedad de la Versión 6.

Sintaxis

@UserAccess( servidor : archivo ; [ privilegio-de-acceso ] )

Parámetros

servidor

Texto. El nombre del servidor. Si se trata de un equipo local, utilice una cadena vacía ("").

Texto. La ruta de acceso y el nombre de archivo de la base de datos. Utilice el formato apropiado para su sistema operativo.

Palabra clave. Opcional. Especifique una de las palabras clave siguientes si desea obtener el nivel de acceso de un usuario o comprobar si dispone de un privilegio de acceso determinado para una base de datos, en lugar de obtener una lista con toda la información sobre el acceso del usuario:
• [ACCESSLEVEL] da como resultado un número del 1 al 6 que indica el acceso del usuario a la base de datos.

  nivel	Nivel de acceso
  1	Depositante
  2	Lector
  3	Autor
  4	Editor
  5	Diseñador
  6	Gerente

Las siguientes palabras clave dan como resultado 1 (Verdadero) si el usuario tiene el privilegio de acceso especificado y 0 (Falso) en caso contrario. Estos privilegios de acceso se asignan en la LCA de la base de datos.
• [CREATEDOCUMENTS]
• [DELETEDOCUMENTS]
• [CREATEPERSONALAGENTS]
• [CREATEPERSONALFOLDERSANDVIEWS]
• [CREATELOTUSSCRIPTJAVAAGENTS]
• [CREATESHAREDFOLDERSANDVIEWS]
• [READPUBLICDOCUMENTS]
• [WRITEPUBLICDOCUMENTS]
• [REPLICATEORCOPYDOCUMENTS]

Si especifica una o más palabras, da como resultado un valor de texto o una lista de texto con los siguientes valores:

• La palabra clave [AccessLevel] da como resultado un valor del 1 al 6.
• Las demás palabras clave dan como resultado un valor de 1 o de 0.

• [AccessLevel] : [CreateDocuments] : [DeleteDocuments] : [CreatePersonalAgents] : [CreatePersonalFoldersAndViews] : [CreateSharedFoldersAndViews] : [CreateLotusScriptJavaAgents] : [ReadPublicDocuments] : [WritePublicDocuments]

  @UserAccess no comprueba el acceso al privilegio ReplicateOrCopyDocuments de forma predeterminada.

  Consejo Si el separador de valores múltiples del campo que contiene la fórmula es un punto y coma, los valores de la lista de texto del resultado estarán separados por el signo de punto y coma, no por el de dos puntos.

En una base de datos local que no tenga activada la opción Forzar la misma Lista de control de acceso para todas las réplicas, @UserAccess sin el segundo parámetro siempre da como resultado 6; 1; 1; 1; 1; 1; 1; 1; 1. . Si el usuario actual no tiene acceso a la base de datos, Lotus Notes/Domino muestra un mensaje indicándole que no está autorizado a realizar esa operación.

No funciona en fórmulas de columna ni en fórmulas de selección; asimismo, tampoco funciona en agentes que se ejecutan en un servidor (agentes programados o agentes que se activan al recibir documentos por correo). A partir de ahora, no funciona con la sentencia Evaluate.

Equivalencias en otros lenguajes

Método QueryAccess de la clase NotesDatabase de LotusScript

Propiedad CurrentAccessLevel de la clase NotesDatabase de LotusScript

Método queryAccess de la clase Database de Java

Propiedad CurrentAccessLevel de la clase Database de Java

Ejemplo
Véase también

@V4UserAccess
Accessing the user environment