El widget Buscar le permite configurar una herramienta de búsqueda para buscar entidades, registros o ubicaciones basadas en capas y localizadores específicos y definir la forma de visualizar los resultados de búsqueda. Si agrega varias fuentes de búsqueda al widget, los usuarios pueden elegir en cuáles buscar. Realizar la búsqueda usando un origen de capa afecta a los datos de la aplicación, por lo que los demás widgets que usen la misma capa se filtrarán para mostrar los resultados de búsqueda correspondientes. Si desea seleccionar los resultados de la búsqueda, puede establecer una acción. Para que el widget seleccione entidades sin filtrar los datos, cree una vista de datos para la fuente de datos que puede utilizar como origen de capa. Realizar una búsqueda mediante una fuente de localizador genera una fuente de datos de salida que pueden usar otros widgets.
Para buscar, los usuarios escriben una palabra o una frase en el cuadro de búsqueda y pulsan Intro, hacen clic en el botón de búsqueda o eligen una opción de una lista de sugerencias que aparecen en función de los registros coincidentes. (La lista de sugerencias muestra cada valor coincidente como elemento, de modo que si un registro tiene dos campos que coinciden con la frase de búsqueda, ese registro aparece como dos sugerencias). Los usuarios pueden usar las teclas de flecha arriba y abajo para navegar por la lista de sugerencias. Al hacer clic en una sugerencia, se reemplaza la expresión de búsqueda con el contenido del elemento sugerido para aplicar la búsqueda utilizando el nuevo valor, que devuelve los datos correspondientes en un panel de resultados. Para simplificarlo, existe una configuración que puede activar para seleccionar automáticamente el primer resultado de búsqueda. También puede configurar el widget para abrir otra página en su aplicación y mostrar el resultado en otro widget.
Ejemplos
Use este widget para apoyar los requisitos de diseño de la aplicación como por ejemplo los siguientes:
- Quiere configurar una opción de búsqueda en su aplicación que ofrezca más flexibilidad que la herramienta de búsqueda incluida en los widgets Mapa, Lista y Tabla. En particular, desea buscar campos limitados para capas específicas en el mapa, proporcionar texto de sugerencia único en el cuadro de búsqueda y visualizar los valores de determinados campos de datos en el panel de resultados.
- Desea que los usuarios encuentren información de varias fuentes al realizar una búsqueda.
- Desea mostrar los resultados de la búsqueda en otros widgets en otra página de la aplicación.
Notas de uso
El widget Buscar admite dos tipos de fuentes de búsqueda: capas y localizadores. Cuando agrega un widget Buscar, los localizadores especificados en la configuración de su organización se agregan como fuentes de localizador de forma predeterminada. (Si no ve el ArcGIS World Geocoding Service predeterminado, es posible que su administrador lo haya eliminado de la configuración de la organización). Para usar otra fuente de localizador, agregue una URL para el servicio de localizador. Para buscar capas, seleccione entre las capas de entidades y las capas de escena que se agregan como datos a su aplicación.
Puede definir acciones para que un widget Buscar interactúe con otros widgets de su aplicación, como acercar un mapa al resultado seleccionado o mostrar resultados de búsqueda (de un origen de localizador) en un mapa.
Configuración
El widget Tabla incluye estos ajustes:
- Nueva fuente de búsqueda: si lo desea, agregue fuentes para buscar contenido que no sea el predeterminado. Elija Origen de capa o Fuente de localizador y especifique la siguiente configuración para cada uno:
- Datos: si procede, seleccione la fuente de datos de la capa de entidades que desea que busquen los usuarios. En la configuración de la vista de datos, puede filtrar los datos para limitar el ámbito de la búsqueda u ordenar los datos para mostrar los resultados de búsqueda en un orden concreto.
- URL de localizador: si corresponde, proporcione la URL del servicio de localizador (que empieza por https://). El widget utiliza automáticamente los localizadores especificados en la configuración de su organización.
- Etiqueta: introduzca el nombre de la hoja. Este nombre aparece en el menú de búsqueda, en la lista de sugerencias y en el panel de resultados.
- Icono: seleccione un icono para el origen. Este icono se muestra en la lista de sugerencias y en el panel de resultados de la búsqueda. Puede elegir iconos de las galerías General y Flechas, o agregar su propio icono desde un archivo. Haga clic en el botón Eliminar para quitar iconos cargados no utilizados.
Nota:
Puede cargar los siguientes formatos de imagen: PNG, GIF, JPG, JPEG y BMP. Para mantener un rendimiento óptimo, hay un límite de tamaño de 10 MB para cada carga.
- Opciones de búsqueda: personalice el texto de sugerencia que aparece en el cuadro de búsqueda cuando los usuarios eligen buscar solo este origen. En Origen de capa, puede definir las siguientes opciones adicionales:
- Seleccionar los campos de búsqueda: elija uno o más campos de búsqueda.
- Coincidencia exacta: limite los resultados de búsqueda a solo registros que coincidan con la frase de búsqueda.
- Campos de visualización: elija uno o varios campos para mostrar en el panel de resultados de búsqueda. También puede arrastrar las capas para reordenarlas.
- Opciones de búsqueda generales
- Sugerencia para varias fuentes de búsqueda: personalice el texto de sugerencia que aparece en el cuadro de búsqueda cuando los usuarios optan por buscar en varias fuentes.
- Sugerencia de búsqueda: defina el número máximo de sugerencias que aparecen para cada fuente de búsqueda. Puede configurar los siguientes ajustes:
- Usar ubicación actual: incluye una opción de sugerencia para buscar en función de la ubicación actual del usuario.
- Búsquedas recientes: muestra el historial de búsqueda en el cuadro de sugerencias basadas en un número máximo especificado de búsquedas recientes. (Los usuarios pueden borrar el historial de búsquedas).
Sugerencia:
Para deshabilitar las sugerencias de búsqueda de fuente, establezca Sugerencias máximas por fuente en 0.
- Resultado de búsqueda: elija mostrar un panel de resultados de búsqueda o un vínculo a una página de su aplicación para mostrar los resultados en otro widget.
- Panel de resultados: se muestran los resultados de la búsqueda en un panel que aparece debajo del cuadro de búsqueda. Puede definir el número máximo de resultados para visualizar por origen de búsqueda y elegir seleccionar automáticamente el primer resultado.
- Establecer vínculo: se abre una página concreta de la aplicación para mostrar los resultados de búsqueda pertinentes en el widget correspondiente.
Opciones de interacción
Al configurar acciones de mensaje para el widget Buscar, puede elegir entre los siguientes desencadenadores dependiendo de la fuente de búsqueda.
| Desencadenador | Origen de capa | Fuente de localizador |
|---|---|---|
Cambios de selección de registros |
|
|
Registros creados |
| |
Cambios de filtrado de datos |
|
Cuando se configura con una fuente de localizador, el widget Buscar genera una fuente de datos de salida que se puede usar en otros widgets. La interacción con widgets adicionales utilizando la misma fuente de datos de salida se logra al agregar acciones. Por ejemplo, el mapa puede mostrar automáticamente los resultados de la consulta y acercar las entidades. En la configuración del widget Consulta, en la pestaña Acción, agregue el desencadenador Registros creados, seleccione el mapa de destino y agregue acciones para Mostrar en el mapa y Acercar a.
Para seleccionar una entidad en un mapa que se corresponda con un resultado de búsqueda seleccionado, agregue el desencadenador Registro de cambios de selección para el widget Buscar (cuando se configuró para usar el panel de resultados). Seleccione el marco de destino, agregue la acción Seleccionar registros de datos y configúrela con la capa de entidades del mapa y los campos que vinculan la conexión entre el desencadenador y los datos de la acción. Además, puede agregar la acción Acercar a para acercar el mapa a la entidad seleccionada.
Cuando se configura con un origen de capa, si desea que el mapa se acerque o se desplace al resultado de búsqueda seleccionado, agregue el desencadenador Cambios de filtrado de datos, seleccione el mapa de destino y agregue las accionesDesplazarse panorámicamente a y Acercar a.
Si desea ajustar el nivel de zoom de la acción Acercar a, cambie Escala de zoom a Personalizada e indique la escala deseada.
Sugerencia:
Para que el widget Buscar seleccione la entidad en un mapa sin filtrar los datos, cree una vista de datos para la fuente de datos que puede utilizar como origen de capa.