Widget Consultar

El widget Consultar le permite recuperar información de una fuente de datos ejecutando una consulta de filtro espacial o atributos. Los resultados de una consulta generan una fuente de datos de salida que pueden utilizar otros widgets.

Ejemplos

Use este widget para apoyar los requisitos de diseño de la aplicación como por ejemplo los siguientes:

• Desea permitir a los usuarios buscar entidades a partir de una expresión de consulta.
• Desea permitir a los usuarios dibujar una forma en un mapa y devolver entidades que se intersecan con la forma dibujada.
• Quiere permitir a los usuarios buscar entidades que tengan una relación espacial específica (como intersecar o superponer) con las formas de entidades seleccionadas de otros widgets.
• Desea utilizar los resultados de la consulta para crear entidades para otros widgets.

Notas de uso

El widget Consulta requiere que se defina una fuente de datos para cada consulta que agregue. Cada consulta funciona con una sola capa y puede definir varios filtros espaciales y de atributos. También puede crear varias consultas y utilizar capas de varias fuentes de datos. Una consulta se puede configurar con o sin un mapa. Para mostrar las entidades devueltas por una consulta en un widget Mapa, puede definir una acción para que se muestren automáticamente o usar una acción de datos que permita al usuario hacer clic en un botón. Actualmente, el uso de una capa de escena requiere agregar un desencadenador Cambios de selección de registros en su lugar, de modo que los usuarios pueden hacer clic en el resultado de una consulta para resaltarla en el mapa.

Precaución:

El intento de ejecutar una consulta espacial para una entidad que sea muy compleja (como una entidad poligonal con un elevado número de vértices) puede sobrecargar el widget y no devolver resultados. Si esto ocurre, puede probar a generalizar la entidad. Asegúrese de que está conforme con los límites máximos de recursos de su servidor.

Configuración

El widget Consultar incluye los siguientes ajustes:

• Nueva consulta: cree una consulta y especifique los siguientes ajustes en el panel Definir consulta:
  • Datos: seleccione los datos que quiere consultar. Solo puede seleccionar una fuente de datos por consulta. Se admiten capas de entidades, capas de entidades en escenas web y mapas web seleccionados, vistas de datos, fuente de datos de salida y URL de servicios de entidades.
  • Etiqueta: personalice el nombre de cada consulta. Si hay una sola consulta en un widget, puede desactivar la etiqueta de visualización para el estilo de disposición vertical e icono.
  • Icono: elija un icono para cada consulta que se muestre en el widget y la lista de consultas en el panel de contenido. Puede elegir iconos de las galerías General y Flechas o agregar un 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.

  • Filtro de atributo: cree expresiones SQL para especificar los criterios del filtro de atributo. El Generador de expresiones SQL que se abre ofrece varias opciones para crear consultas complejas e interactivas.
    • Etiqueta: personalice la etiqueta de la sección de filtro de atributo.
    • Descripción: proporcione instrucciones para un público específico, por ejemplo, nuevos usuarios, que aparece como texto emergente en un icono de información.
  • Filtro espacial: seleccione los filtros espaciales que estarán disponibles y, opcionalmente, elija un widget de mapa.
    • Etiqueta: personalice la etiqueta de la sección de filtro espacial.
    • Entidades seleccionadas de la fuente de datos: devuelva entidades que tengan una relación espacial con entidades de otra capa. Opcionalmente, se puede aplicar una distancia de búsqueda a las geometrías de las entidades de la capa relacionada.
      • Reglas de relación espacial: elija cuál de las siguientes relaciones espaciales proporcionar a los usuarios:
        • Intersecar: parte de una entidad de la capa de origen está contenida en una entidad de la capa de filtro.
        • Contener: la entidad de la capa de origen está completamente encerrada por la entidad de la capa de filtro.
        • Cruzar: la entidad de la capa de origen cruza una entidad de la capa de filtro.
        • Intersección de sobre: el sobre de la capa de origen se interseca con el sobre de la capa de filtro.
        • Intersección de índice: el sobre de la capa de consulta interseca la entrada de índice de la capa de destino.
        • Superponer: entidades de la capa de origen superpuestas a entidades de la capa de filtro.
        • Tocar: la entidad de la capa fuente toca el borde de una entidad de la capa de filtro.
        • Dentro: la entidad de la capa de filtro está completamente encerrada por la entidad de la capa de origen.
      • Habilitar zona de influencia: agrega una distancia de búsqueda. Puede definir la distancia y la unidad predeterminadas.
    • Geometrías de un mapa: devuelva entidades que están dentro de la extensión de mapa actual o que intersecan con una forma dibujada en el mapa. Puede activar y desactivar las herramientas de dibujo para controlar qué herramientas están disponibles en el widget.
    • Descripción: proporcione instrucciones para un público específico, por ejemplo, nuevos usuarios, que aparece como texto emergente en un icono de información.
  • Resultados: defina cómo muestra el widget los resultados de la consulta.
    • Etiqueta: personalice la etiqueta de la lista de resultados.
    • Modo de selección: elija cuántos registros pueden seleccionar los usuarios de la lista de resultados.
      • Uno: los usuarios pueden seleccionar un registro cada vez.
      • Varios: los usuarios pueden seleccionar varios registros.
    • Configurar cada registro: respete la configuración de los datos de origen o personalizar los resultados especificando los campos que se deben mostrar en la capa y proporcionando un encabezado significativo. Si elige Personalizar, solo se exportarán los campos que especifique como campos de visualización o que incluya en el encabezado cuando el usuario exporte a JSON, CSV, GeoJSON o elemento de ArcGIS.
    • Expandir de forma predeterminada: active esta casilla para expandir todos los nodos de resultados de forma predeterminada.
    • Ordenar: configure los campos a ordenar para la lista de resultados.
• Estilo de disposición: elija Vertical, Horizontal o Icono para personalizar el estilo para las consultas de un widget.
• Estilo de resultado: organice los resultados de la consulta horizontal o verticalmente y en una o varias páginas.
  • Número de registros por página (disponible cuando se elige Multipágina para Estilo de paginación): defina el número de registros que se muestran por página. Este número no puede ser menor que 10 ni mayor que 1000. En el tiempo de ejecución, los usuarios pueden elegir cuántos resultados se mostrarán por página utilizando un menú desplegable o escribiendo un número. El menú desplegable se rellena con valores iguales al 100 %, el 50 % y el 33 % del número que defina.

    Nota:

    El widget Consulta respeta cualquier limitación de recuento máximo de registros que haya definido para las capas de entidades en la pestaña Datos.

Opciones de interacción

El widget Consulta 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.

Los campos de consulta se muestran en una lista. Para seleccionar el elemento en la lista y la entidad correspondiente en el mapa, agregue el desencadenador Cambios de selección de registros para el widget Consulta. 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 acción. También puede agregar la acción Acercar a para acercar el mapa a la entidad seleccionada.