Widget Buscar

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. Para utilizar una fuente de localizador, agregue un servicio de localizador. Puede usar los localizadores especificados en la configuración de su organización o los agregados por usted en el panel Seleccionar utilidad. Para buscar capas, seleccione entre las capas de entidades y las capas de escena que se agregan como datos a su aplicación.

Si configura varias fuentes de búsqueda, los usuarios en tiempo de ejecución pueden utilizar el menú desplegable para activar y desactivar fuentes individuales o utilizar la casilla de verificación Todo para activar o desactivar todas las fuentes.

Con las fuentes de localizador, puede introducir los siguientes tipos de términos de búsqueda:

• Nombres de lugares
• Puntos de interés
• Direcciones
• Coordenadas en UTM
• Coordenadas en un sistema de coordenadas que se especifica con un ID conocido (WKID).

  El formato para esto es x, y: WKID. Ejemplo: -13046165.52, 4036389.847: 102100

Si conecta un widget Buscar y un widget Mapa a la misma capa de entidades y activa Mostrar elemento emergente al seleccionar la entidad en la configuración del widget Mapa, aparecerán elementos emergentes al seleccionar registros de los resultados de la búsqueda.

Métodos de búsqueda

El widget Buscar utiliza diferentes métodos para recuperar sugerencias de búsqueda y resultados de búsqueda.

El widget utiliza búsqueda de texto completo para recuperar sugerencias de fuentes de capas. Búsqueda de texto completo es un método de búsqueda eficiente que utiliza índices de campo de texto completo que dividen registros en unidades pequeñas, como por ejemplo palabras individuales. Por ejemplo, imagine que tiene una capa de ubicaciones de oficinas de correos de Estados Unidos con un campo de nombre que contiene los nombres de cada ubicación de oficina postal. El índice divide el nombre Highland Station Baltimore Post Office en cinco palabras que pueden buscarse individualmente: Highland, Station, Baltimore, Post y Office. Si introduce una frase de búsqueda compuesta por cualquier combinación de dichas palabras (o solo por la primera parte de ellas) como por ejemplo Baltimore Office, Highland Baltimore o Stat Balt Office, obtiene esa oficina en las sugerencias de búsqueda.

Se generan automáticamente índices de campo de texto completo para capas de entidades alojadas cuando las selecciona como campos de búsqueda para el widget Buscar, Lista o Tabla si es el propietario de la capa de entidades alojada o un administrador de la organización. También puede agregar manualmente índices a campos de atributo en la página de detalles de elemento de capas. Si tiene capas sin índices y no tiene permiso para editar las capas, el widget Buscar busca sugerencias utilizando START WITH abc%, lo que significa que el widget busca registros que empiezan con la frase de búsqueda. Este es un método de búsqueda menos eficiente.

Para recuperar resultados de búsqueda, el widget utiliza CONTAIN %abc%, lo que significa que la frase de búsqueda puede estar en cualquier lugar del registro. Por ejemplo, puede buscar alt para obtener Baltimore, Salt Lake City y Alton en los resultados de búsqueda.

Precaución:

La búsqueda de texto completo es nueva con la versión de octubre de 2023 de Experience Builder y es un cambio innovador. Antes de esta versión, el widget utilizaba CONTAIN %abc% para recuperar sugerencias y resultados. A diferencia de las consultas CONTAIN %abc%, la búsqueda de texto completo no puede encontrar frases de búsqueda situadas en la mitad de las palabras. En el ejemplo anterior, la búsqueda de altimor o ighlan no devolverá la oficina de correos esperada en sugerencias de búsqueda. Obtenga más información sobre la búsqueda de entidades en mapas y aplicaciones.

Configuración

El widget Buscar incluye estos ajustes:

• Nueva fuente de búsqueda: agregue fuentes para buscar contenido. 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: conecte un servicio de utilidades de localizador. El panel Seleccionar utilidad muestra los localizadores especificados en la configuración de su organización o agregados por usted en el panel Servicio de utilidades.
  • 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: puede definir estas opciones adicionales:
    • Seleccionar campos de búsqueda (solo orígenes de capa): elija uno o varios campos para buscar en la capa.
    • Coincidencia exacta (solo orígenes de capa): 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.
    • Sugerencia: personalice el texto de sugerencia que aparece en el cuadro de búsqueda cuando los usuarios eligen buscar solo en este origen.
• Habilitar el filtrado durante la búsqueda de fuentes de capas: si este ajuste está activado, cuando el usuario realice una búsqueda, el widget filtra las fuentes de capas conectadas según los criterios de búsqueda.
• Opciones de búsqueda general: puede configurar las siguientes opciones de búsqueda general:
  • 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.
  • Definir vínculo: agregue un vínculo para abrir una página, ventana o vista de sección específicas en la aplicación, o desplácese a un bloque concreto o a la parte superior de la página para mostrar los resultados de búsqueda pertinentes en un widget correspondiente. Esta configuración aparece cuando el panel Resultados está desactivado.
  • Estilo: elija un estilo de interfaz para el panel de resultados, ya sea Clásico o Compacto. Compacto tiene un botón Contraer más pequeño, que aparece en la parte inferior del panel.
• Estilo de disposición: elija una interfaz de usuario para el widget, ya sea Cuadrada, Curva o Lineal.

Opciones de interacción

Al configurar acciones de mensajes 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.

Para ajustar el nivel de zoom de la acción Acercar a, cambie la 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.

Parámetros de la URL

Las siguientes subsecciones describen parámetros URL relacionados con la búsqueda. Puede utilizar la configuración de Gestionar estado URL para que estos parámetros aparezcan en la URL cuando el usuario realice una búsqueda. Los parámetros del widget Buscar siguen las marcas de almohadilla (#).

Mostrar la entrada de la búsqueda

El parámetro searchText muestra el texto que el usuario ha introducido para realizar una búsqueda. A continuación, se muestra una URL de ejemplo con el parámetro searchText:

https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%7D

Mostrar el origen de la búsqueda

Cuando el usuario realiza una búsqueda utilizando solo algunos de los orígenes de búsqueda disponibles, en la URL aparece uno de los dos parámetros siguientes:

• Si al menos un origen de búsqueda está desmarcado en el menú desplegable del widget en tiempo de ejecución, aparece el parámetro serviceEnabledList y define qué orígenes de búsqueda se van a comprobar. Este parámetro se oculta cuando se comprueban todos los orígenes de búsqueda. A continuación se muestra un ejemplo de URL codificada:

  https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"serviceEnabledList"%3A%5B"<SourceID1>"%2C"<SourceID2>"%5D%7D

• Si el usuario hace clic en una sugerencia de búsqueda para aplicar una búsqueda, aparece el parámetro "status":{"configId":"<SourceID>"} y define el origen de búsqueda único que se está utilizando en la búsqueda actual. Tanto la entrada como el origen de la búsqueda aparecen en la URL. A continuación se muestra un ejemplo de URL codificada:

  https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%2C"status"%3A%7B"configId"%3A"<SourceID>"%7D%7D

Si el usuario hace clic en una sugerencia de búsqueda procedente de un origen localizador, la URL muestra la magicKey asociada a la sugerencia. magicKey es un Id. único que vincula una sugerencia a una dirección o lugar concretos. A continuación se muestra un ejemplo de propiedades y parámetros de búsqueda escritos en formato JSON:

{
	"searchText": "<text>",
	"status":{
		"configId": "<SourceID>",
		"magicKey": "<key>"
	}
}

A continuación se muestra un ejemplo de las mismas propiedades y parámetros anteriores escritos en una URL codificada:

https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%2C"status"%3A%7B"configId"%3A"<SourceID>"%2C"magicKey"%3A"<key>"%7D%7D