Muestra un cuadro de diálogo con uno de los dos elementos siguientes:

• La vista especificada, desde la cual el usuario puede seleccionar uno o varios documentos. @PickList da como resultado el valor de una columna del documento o de los documentos seleccionados.
• Un cuadro de diálogo que muestra información de todos los directorios de Domino disponibles. El usuario puede seleccionar una o varias personas, grupos, servidores, salas o nombres de recursos y @PickList da como resultado los nombres seleccionados.

@PickList( [CUSTOM] : [SINGLE] ; servidor : archivo ; vista ; título ; mensaje ; columna ; categoría )

@PickList( [NAME] : [SINGLE] )

@PickList( [ROOM] )

@PickList( [RESOURCE] )

@PickList( [FOLDERS] : [SINGLE] ; servidor:base-de-datos )

@PickList( [FOLDERS] : [SHARED] ; servidor:base-de-datos )

@PickList( [FOLDERS] : [PRIVATE] ; servidor:base-de-datos )

@PickList( [FOLDERS] : [NODESKTOP] ; servidor:base-de-datos )

Parámetros

[CUSTOM]

Palabra clave. Utilícela cuando desee que en el cuadro de diálogo aparezca una vista.

Palabra clave. Abre un cuadro de diálogo para seleccionar uno o varios nombres.

[SINGLE]

Palabra clave. Opcional. Limita la selección a un único nombre.

Palabra clave. Abre un cuadro de diálogo para seleccionar una sala.

Palabra clave. Abre un cuadro de diálogo para seleccionar recursos.

Palabra clave. Da como resultado una lista de texto, que permite múltiples selecciones, de todos los nombres de carpetas tanto de la base de datos como del área de trabajo. Las siguientes palabras clave pueden combinarse con [Folders]:

[SINGLE]

Palabra clave. Opcional. Limita la selección a una única carpeta.

[SHARED]

Palabra clave. Opcional. Limita la selección exclusivamente a las carpetas compartidas.

[PRIVATE]

Palabra clave. Opcional. Limita la selección exclusivamente a las carpetas privadas (tanto de la base de datos como del área de trabajo).

[SHARED]:[PRIVATE]

Palabra clave. Opcional. Incluye en la selección todas las carpetas privadas y compartidas.

[NODESKTOP]

Palabra clave. Opcional. Excluye las carpetas del área de trabajo de la selección.

Lista de texto. El servidor es el nombre del servidor en el que se encuentra la base de datos. El archivo es la ruta de acceso y el nombre de archivo de la base de datos que se desea abrir. Especifique el nombre y la ubicación de la base de datos usando el formato adecuado para el sistema operativo.

Se puede utilizar un ID de réplica en lugar de un nombre de servidor y de archivo como único parámetro para acompañar a la palabra clave [custom]. El ID de réplica debe de ser texto y debe incluir los dos puntos entre los dos grupos de ocho dígitos hexadecimales. Por ejemplo:

@PickList([CUSTOM]; "852564A0:006B7872"; "Por categoría"; "Prueba de ID de réplica"; "Mensaje de prueba"; 3)

Para especificar la base de datos que se encuentra abierta, utilice ("").

Texto. El nombre de la vista que desea abrir en la base de datos.

Texto. El título del cuadro de diálogo.

Texto. El mensaje que debe aparecer en el cuadro de diálogo. Sólo se muestra una línea de texto. Las líneas de mayor longitud se truncan.

Número. Un número que indica la columna cuyo valor debe dar como resultado @PickList. Utilice 1 para indicar la primera columna, 2 para indicar la segunda, y así sucesivamente. Al contrario que en @DbColumn y @DbLookup, @PickList cuenta todas las columnas, independientemente del tipo de fórmula que éstas contienen.

Nota Este parámetro es una novedad de la Versión 5.

Texto. Opcional. Muestra la categoría especificada en la vista. La vista debería ser categorizada para poder utilizar este parámetro.

contenido-columna

Lista de texto. El valor o valores que aparecen en la columna especificada para los documentos seleccionados.

@PickList le resultará de gran utilidad en fórmulas de botón, de agente manual, de agente que se activa al pegar documentos, de acción de formulario y de acción de vista. No funciona en fórmulas de columna, de selección, de agente que se activa al recibir documentos por correo, de agente programado, de ocultación, de título de ventana ni de formulario.

Aunque @PickList([CUSTOM]) opera de forma similar a @DbColumn y @DbLookup, su uso es más recomendable debido a que:

• Almacena más cantidad de datos
• Realiza la búsqueda con mayor rapidez
• Permite localizar el documento deseado escribiendo los primeros caracteres

En una vista de agenda, @PickList muestra dos días comenzando con la fecha actual, sin franjas horarias. El usuario puede hacer clic en el selector de fechas para desplazarse a otros días.

No es posible utilizar esta función en las aplicaciones para Web.

@PickList puede dar como resultado un máximo de 64 kB de datos. Use las ecuaciones siguientes para determinar la cantidad de datos que pueden obtenerse con @PickList.

Para búsquedas que dan como resultado texto:

2 + (2 * número de entradas obtenidas) + tamaño total del texto de todas las entradas

Para búsquedas que dan como resultado números o fechas:

(10 * número de entradas obtenidas) + 6

No obstante, @PickList puede acceder a una vista de cualquier tamaño, de manera que no hay límites en el número de opciones que puede presentar. Sólo el resultado tiene limitaciones de tamaño.

Equivalencias en otros lenguajes

Método PickListStrings de la clase NotesUIWorkspace de LotusScript

Ejemplo
Véase también

@DbColumn (origen de datos Domino)
@DbColumn (origen de datos ODBC)
@DbLookup (origen de datos Domino)
@DbLookup (origen de datos ODBC)
@DialogBox
Getting user input with @Prompt and @PickList
@Prompt
Ejemplo de código de lista de recogida de LotusScript Versión 4 de Sandbox en Lotus Developer Domain
"Taking your Domino applications to the Web" en Lotus Developer Domain