Introducción
En el editor del App Designer, el control Búsqueda en Colecciones le permite personalizar cómo los usuarios buscan e interactúan con la información en su app. En este artículo se explica cómo agregar el control a una página y cómo configurarlo según sus necesidades.
Agregar el control
Para agregar el control Búsqueda en Colecciones a una página, vaya a Controles > Colecciones > Búsqueda en Colecciones y arrástrelo a la sección deseada de la página.
Opciones de configuración
El control Búsqueda en Colecciones ofrece las siguientes opciones de configuración:
Opciones de Administración
Esta sección le permite definir la fuente de datos del control. Siga los pasos que se indican a continuación según si utiliza contenido estático o dinámico.
Contenido estático
Siga estos pasos de configuración al trabajar con varios controles de Colección fijos.
1. Haga clic en el control Búsqueda de colecciones y seleccione la opción Administrar. Establezca el tipo de origen como Fijo.
2. Seleccione la ubicación de la página donde se encuentran los controles de Colección deseados en la lista desplegable.
3. Haga clic en las casillas de verificación junto a los controles de Colección que desea incluir. Si desea incluir varios controles de Colección, puede hacer clic en la opción Seleccionar todo.
Haga clic en Siguiente.
4. Elija los atributos que se usarán como criterios de búsqueda. Estos serán visibles para las Personas y determinarán cómo se realiza las búsqueda. Asegúrese de que estos atributos existan en todos los controles de Colección seleccionados.
Haga clic en Siguiente.
5. Opcionalmente, habilite la categorización para permitir el filtrado por categoría. Las opciones del menú desplegable se basan en un atributo común a todas las Colecciones incluidas. Solo estarán disponibles los atributos presentes en cada control de Colección.
Haga clic en Siguiente.
6. Personalice el texto dle placeholder, la etiqueta del botón, el ícono y el color del ícono.
Haga clic en Listo para completar la configuración.
Contenido dinámico
Siga estos pasos de configuración al trabajar con varios controles de Colección dinámicos.
1. Haga clic en el control de Búsqueda de colecciones y seleccione la opción Administrar. Establezca el tipo de origen como Dinámico.
2. Seleccione la ubicación de la página donde se encuentran los controles de Colección deseados en la lista desplegable.
3. Haga clic en el control de Colección que desea incluir.
Haga clic en Siguiente.
4. Seleccione los campos que se utilizarán como criterios de búsqueda. Estos pueden configurarse como:
•Criterio fijo: defina hasta cinco atributos desde el control Colección. La búsqueda solo utilizará los atributos seleccionados, que permanecerán fijos para los usuarios de la app. Esta sección también muestra la cantidad de atributos seleccionados hasta el momento, lo que le ayudará a controlar el límite al trabajar con listas de atributos extensas.
Cuando alcance el límite de cinco atributos, las casillas de verificación restantes se desactivarán.
•Criterios variables: Seleccione varios atributos para incluir en la búsqueda (no hay límite en la cantidad que puede agregar). Use el botón Seleccionar todo para elegir rápidamente todos los atributos. Estos atributos aparecerán en una lista desplegable en la app publicada. Los usuarios de la app pueden hacer consultas en todos los atributos habilitados (hasta cinco a la vez) en una sola búsqueda.
Puede cambiar el nombre de los atributos para mejorar la legibilidad en la app publicada. De forma predeterminada, los atributos usan sus nombres XPath (por ejemplo, Customer.FullName), pero estos se pueden modificar. Las nuevas etiquetas solo afectan a la app publicada y a la lista desplegable, no a los datos subyacentes.
Para cambiar el nombre de un atributo, pase el cursor sobre él. Aparecerá un icono de lápiz junto a su nombre XPath; haga clic en el icono para editarlo.
Ingrese una nueva etiqueta y haga clic en Aplicar.
Se muestra una vista previa del control de Búsqueda en Colecciones para revisar los atributos seleccionados y el comportamiento del menú desplegable antes de finalizar la configuración.
Haga clic en Siguiente.
5. En el paso Estilos, puede personalizar el placeholder de búsqueda, la etiqueta del botón de búsqueda, la etiqueta de categoría y el icono.
Haga clic en Finalizar para completar la configuración.
Comportamiento en la app publicada
Cuando se configura con una fuente de datos Dinámica y Criterios variables, los usuarios de la app verán el siguiente comportamiento del control de Búsqueda en Colecciones en la app publicada:
•Una lista desplegable con los campos de búsqueda seleccionados.
•Los campos seleccionados se muestran en la lista desplegable. El usuario puede seleccionar hasta cinco campos.
•Una etiqueta Buscar por cuando no se ha preseleccionado ningún campo.
•Etiquetas de campo personalizadas, según lo definido en la configuración.
Opciones de diseño
Esta sección permite personalizar la apariencia del control Búsqueda en Colecciones.
•Estilo: ajuste la alineación (izquierda, centrado o derecha), el ancho, el tamaño del borde y el estilo del borde.
•Colores: defina los colores del fondo, los botones, el ícono y el borde.
•Borde: modifique el radio del borde.
|
•El botón Reiniciar en la pante inferior del panel de diseño le permite restaurar los ajustes por defecto del control. •Las propiedades con valores heredados muestran un punto azul junto a su título. Este indicador le permite realizar ajustes específicos sin afectar otras configuraciones. Al colocar el cursor sobre el punto azul, se muestra el origen del valor heredado, lo que proporciona un mayor control sobre la apariencia del control de texto. •Al modificar una propiedad marcada con un punto azul, aparece su botón Restablecer. Al hacer clic en este botón, la propiedad recupera su configuración predeterminada heredada. |
Opciones de visibilidad
Indique qué Personas pueden ver el control Búsqueda en Colecciones.
Seleccione Todas para que sea visible para todas las Personas, o elija Personas específicas.
Consideraciones
Tenga en cuenta lo siguiente al usar el control de Búsqueda en Colecciones:
•Las búsquedas se combinan con los filtros existentes aplicados a los controles de Colección. Estos filtros utilizan tanto la lógica Y (AND) como la lógica O (OR).
•Las búsquedas se integran de forma flexible con los filtros y la opción Agrupar por:
oLos filtros predefinidos (establecidos por el diseñador) admiten combinaciones de lógica Y (AND)/O (OR) configurables.
oLos filtros de usuario (aplicados en tiempo de ejecución) siempre se combinan con Y (AND).
oLa opción Agrupar por (configurada por el diseñador) se aplica al final, como agregación. Tanto la lógica Y (AND) como la lógica O (OR) se pueden combinar libremente.
Ejemplo
Suponga que el diseñador de la app habilita Teléfono, Correo electrónico y Nombre como atributos de búsqueda, configura un filtro predefinido (Estado = Activo O (OR) Estado = Pendiente) y agrega la opción Agrupar por Región. Luego, en tiempo de ejecución, un usuario de la app aplica filtros (País = EE. UU. Y (AND) Departamento = Ventas).
La consulta resultante es:
(Teléfono O Correo electrónico O Nombre) AND (Estado = Activo O Estado = Pendiente) AND (País = EE. UU. AND Departamento = Ventas) → Agrupado por Región
Cambios en Colecciones y advertencias
Si se modifica un control Colección vinculado al control Búsqueda en Colecciones, especialmente su fuente de datos, aparecerá un mensaje de advertencia para ayudar a prevenir problemas de compatibilidad.
Proceso de actualización de la fuente de datos
Cuando se actualiza un control Colección o se cambia su tipo de fuente, aparece un cuadro de confirmación:
•Cerrar: mantiene la fuente de datos y la configuración actuales.
•Aplicar: desvincula el control y lo restablece a su configuración predeterminada.
Este proceso garantiza transparencia y le brinda control sobre cómo se aplican los cambios.
Last Updated 11/19/2025 12:05:26 AM