Selección múltiple

La selección múltiple permite a los usuarios seleccionar varios elementos a la vez en una lista de elementos.

Enlace de datos

Defina o modifique el enlace de datos para el control en la pestaña de propiedades Generales. El control se puede vincular a un tipo ANY (Lista).

Propiedades de configuración

Puede definir o modificar las propiedades de configuración del control, como por ejemplo las propiedades de aspecto y comportamiento, en la pestaña de propiedades de Configuración.

Tamaño de pantalla: Una propiedad de configuración que tenga el icono Tamaños de pantalla además del nombre de propiedad, puede tener distintos valores para cada tamaño de pantalla. Si no define un valor, el tamaño de la pantalla hereda el valor del siguiente tamaño de pantalla más grande como su valor predeterminado. Si está utilizando el editor de escritorio de Process Designer (en desuso), está estableciendo el valor para el tamaño de pantalla grande. Los otros tamaños de pantalla heredan este valor.

Definiciones de temas: Las definiciones de temas especifican los colores y estilos de un control y determinan el aspecto del control. Puede obtener una vista previa del aspecto de los controles en el editor de temas. Consulte Temas.

En la tabla siguiente se muestran las propiedades de configuración del aspecto para el control Selección múltiple:

Tabla 1. Propiedades de configuración de aspecto para la selección múltiple
Propiedad de configuración del aspecto	Descripción	Tipo de datos
Anchura	La anchura del control. Puede especificar la anchura en px (píxeles), % (porcentaje) o en unidades em. Por ejemplo, 50px, 20%, o 0.4em. Si no se especifica ningún tipo de unidad, se presupone px.	`String`
Tamaño	El tamaño del texto del control, el tamaño del texto de etiqueta y la cantidad de relleno alrededor del texto. Por ejemplo, para que el texto y la etiqueta sean más legibles en los teléfonos inteligentes, puede establecer esta opción de configuración en `Grande` para compensar el tamaño pequeño de la pantalla.	`String`
Colocación de etiqueta	Las ubicaciones de colocación etiqueta para el control.	`String`

En la tabla siguiente se muestran las propiedades de configuración del comportamiento para el control Selección múltiple:

Tabla 2. Propiedades de configuración de comportamiento para la selección múltiple
Propiedad de configuración del comportamiento	Descripción	Tipo de datos
Índice de pestañas	El índice de secuencia de pestañas. Los índices de separadores empiezan en 1 y se pueden establecer de forma dispersa. Por ejemplo, puede utilizar 1, 5, 10.	`Integer`

En la tabla siguiente se muestran las propiedades de configuración de elementos para el control Selección múltiple:

Tabla 3. Propiedades de configuración de elementos para la selección múltiple
Propiedad de configuración de elementos	Descripción	Tipo de datos
Modalidad de búsqueda de elementos	El método utilizado para rellenar la lista de elementos entre los que el usuario puede seleccionar. Nota: Asegúrese de seleccionar la opción correcta, de lo contrario, la lista no se rellenará correctamente. Inicio vacío Puede llenar mediante programación la lista de selección utilizando el método `appendItem(value, displayText)`. Elementos de servicio La lista de selección se llena a partir del servicio que se especifique en la opción Servicio de lista de elementos. Elementos de lista estática La lista de selección se llena a partir de las propiedades que se especifiquen en la opción Lista estática. Elementos de opción de configuración La lista de selección se llena a partir del objeto de negocio que se especifique en la opción Datos de entrada de elemento.	`String`
Servicio de lista de elementos	El servicio utilizado para llenar la lista de elementos que aparecen en la lista de selección. El servicio se utiliza cuando la modalidad de búsqueda de elementos es Elementos de servicio. El servicio es un flujo de servicios con el acceso a Ajax adecuado que proporciona la lista de selección en base a los datos proporcionados por el objeto de negocio Datos de entrada de servicio. Puede utilizar esta opción como alternativa a enlazar el control a un objeto de lista.	Flujo de servicios
Datos de entrada de servicio	Un objeto de negocio que proporciona los datos de entrada que se pasan al flujo de servicios con el que se llena la lista de selección. Esta opción se utiliza cuando la modalidad de búsqueda de elementos es Elementos de servicio.	ANY
Datos de entrada de elemento	Una lista de objetos de negocio que llena la lista de selección. Esta propiedad solo se utiliza cuando la modalidad de búsqueda de elementos es Elementos de opción de configuración.	ANY[]
Datos de selección de elemento	En el campo Propiedad de visualización, establezca la propiedad de objeto de negocio para mostrar en la lista de selección. Si no se especifica ningún valor para las propiedades de correlación de datos, los valores predeterminados son `name` para Propiedad de valor y `value` para Propiedad de visualización.	`SelectDataMapping`
Datos de negocio de salida	Cuando el control está vinculado a un tipo complejo, la propiedad que selecciona dicho usuario se pasa a la propiedad especificada en Propiedad de visualización y en la propiedad que está vinculada al control.	`SelectDataMapping`
Lista estática	Una lista estática de elementos para rellenar la lista de selección. Utilice esta opción únicamente para una lista estática. No especifique una variable para esta opción. Para una lista de variables, utilice la modalidad de búsqueda Elementos de opción de configuración.	NameValuePair[]

Ejemplo: elementos de una lista estática

Suponga que tiene el control Selección múltiple con la etiqueta Lista de la compra y la Modalidad de búsqueda de elementos que ha seleccionado es Elementos de lista estática. En la Lista estática, ha definido los siguientes pares nombre-valor.

Tabla 4. Lista estática
Nombre	Valor
1	Leche
2	Pan
3	Plátanos
4	Arroz

Verá el resultado siguiente:

Ejemplo: Rellenar elementos utilizando un objeto de negocio

En este ejemplo se utiliza un objeto de negocio Cliente para rellenar una lista de nombres de persona en la lista de selección. Cuando el usuario selecciona varios nombres, se muestra el registro correspondiente en una tabla.

El objeto de negocio Cliente tiene la siguiente estructura:

Un parámetro ID de tipo String.
Un parámetro firstName de tipo String.
Un parámetro lastName de tipo String.

El objeto de negocio Cliente tiene los siguientes valores predeterminados:

var autoObject = [];
autoObject[0] = {};
autoObject[0].ID = "000";
autoObject[0].firstName = "Pierre";
autoObject[0].lastName = "de Fermat";
autoObject[1] = {};
autoObject[1].ID = "001";
autoObject[1].firstName = "Isaac";
autoObject[1].lastName = "Newton";
autoObject[2] = {};
autoObject[2].ID = "002";
autoObject[2].firstName = "John";
autoObject[2].lastName = "Venn";
autoObject

El servicio de usuario del lado del cliente tiene un variable privada outputList de tipo Output[]. El tipo de salida tiene dos parámetros de serie, value1 y value2. El control Selección múltiple está enlazado a outputList, que contiene los datos de salida del control.

El coach tiene un control Selección múltiple con las propiedades siguientes:

Bajo General, establezca Enlace en outputList.
Bajo Configuración > Elementos, establezca Modalidad de búsqueda de elemento en Elementos de opción de configuración.
Bajo Configuración > Elementos, establezca Datos de entrada de elemento en Customer[].
Bajo Configuración > Elementos > Datos de selección de elemento:
- Para Propiedad de valor, especifique ID.
- Para Propiedad de visualización, especifique firstName.
Bajo Configuración > Elementos > Datos de negocio de salida:
- Para Propiedad de valor, especifique value1.
- Para Propiedad de visualización, especifique value2.

El control Tabla tiene las siguientes propiedades:

Dos columnas con el título Value1 y Value2
Bajo General, Etiqueta se establece en Lista de salida.
Bajo General, Enlaces se establece en outputList[].

Consejo: Para crear la tabla rápidamente, arrastre la variable outputList hasta el coach.

Este es el resultado que se obtiene cuando se ejecuta el coach:

Imagen que muestra una lista seleccionable y una tabla con dos columnas tituladas Value1 y Value2

Este es el resultado después de realizar varias selecciones:

Imagen que muestra una lista seleccionable y una tabla con dos columnas con el título Value1 y Value2

Los valores que seleccione se muestran en la columna Value2, que es la propiedad que se especifica en la opción Propiedad de visualización bajo Datos de negocio de salida. La propiedad se pasa por valor. Si especifica Value1 como la Propiedad de visualización, los nombres que ha seleccionado aparecen en la columna Value1.

Sucesos

Establezca o modifique los manejadores de sucesos para el control en la pestaña Sucesos. Puede definir que los sucesos se desencadenen mediante programación o cuando el usuario interactúa con el control. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario. El control Selección múltiple tiene los siguientes tipos de manejadores de sucesos:

Al cargar: Se activa cuando se carga la página. Por ejemplo:
console.log(me.getItemCount());
Al cambiar: Se activa cuando se modifican los datos enlazados. Por ejemplo:
${MultiSelect2}.reloadServiceItems(me.getSelectedIndices());
En los elementos de servicio: Se activa cuando el flujo de servicios devuelve una lista de elementos. Solo se activa se Modalidad de búsqueda de elementos está establecida en Elementos de servicio.
console.log("MultiSelect1 item service retrieved items successfully");
En error de servicio: Se activa cuando el flujo de servicios devuelve un error de servicio. Solo se activa se Modalidad de búsqueda de elementos está establecida en Elementos de servicio.
me.clearItems();

Según el suceso específico, puede utilizar lógica de JavaScript para modificar los efectos del control. Puede obtener más información sobre la utilización de sucesos con controles en el tema Sucesos definidos por el usuario.

Métodos

Si desea información detallada sobre los métodos disponibles para la selección múltiple, consulte la API JavaScript Selección múltiple.

Recursos adicionales

Para obtener información sobre cómo crear un coach, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidad y Atributos HTML), consulte Propiedades de vista de coach.