Widget Consultar—ArcGIS Web AppBuilder | Documentación de ArcGIS Enterprise

El widget Consulta le permite recuperar información de sus datos de origen ejecutando una consulta predefinida. Los orígenes de datos pueden ser alguno de los siguientes:

Capa de entidades en el mapa actual
Capa de entidades como un elemento del portal
Capa de entidades de un servicio REST de ArcGIS Server
Sugerencia:
Una capa de entidades puede proceder de un servicio de mapas o de un servicio de entidades.
Capa de imágenes de un servicio de imágenes
Tabla independiente

El widget Consulta sirve como generador de consultas durante la configuración, permitiéndole definir la consulta especificando los datos de origen y los filtros y mostrando campos en resultados de consulta. Cada consulta funciona como una capa única. Sin embargo, puede definir varias consultas para una única aplicación y las capas de datos pueden proceder de varias fuentes.

Configurar el widget Consultar

Este widget se puede configurar para que se abra automáticamente al iniciar una aplicación. Haga clic en el botón No abrir este widget al iniciar la aplicación en el widget para activar la opción que permite abrir el widget automáticamente. (para los widgets que debe agregar primero a la aplicación, puede realizar este ajuste después de configurar el widget).

Los pasos siguientes describen cómo configurar una consulta. Repita estos pasos si necesita definir varias consultas.

Pase el cursor por el widget y haga clic en el botón Configurar este widget para abrir la ventana de configuración.
Nota:
Si necesita agregar el widget primero a la aplicación, haga clic en un marcador de posición de widget en la pestaña Widget. En la ventana Seleccionar widget que se abre, haga clic en el widget y en Aceptar.
También puede hacer clic en cambiar icono de widget para reemplazar el icono predeterminado de este widget.
Aparece una ventana del explorador de archivos que permite ir a un archivo de imágenes local para usarlo como icono del widget.
Haga clic en + Nueva consulta.
Aparece la ventana Definir fuente de datos. De manera predeterminada, Mapa está seleccionado y todas las capas de entidades del mapa actual se muestran debajo.
Como alternativa, puede elegir entre Seleccionar en Portal o URL del servicio. Además de capas, puede consultar las tablas relacionadas.
Haga clic en la opción situada junto a una fuente de datos.
Seleccione una capa de la lista.
Haga clic en Aceptar para cerrar la ventana Definir fuente de datos y volver a la ventana de configuración de consulta.
De manera predeterminada, la pestaña Información está activa.
Especifique el título y el icono para la tarea de consulta.
Haga clic en la pestaña Filtros.
Haga clic en Establecer en Criterios de consulta para definir una cláusula WHERE para la consulta.
1. Haga clic en + Agregar expresión para mostrar el generador de expresiones.
  La expresión de filtro puede ser una operación basada en valores o una operación entre dos campos.
2. Seleccione un campo de datos y una expresión de consulta y proporcione datos de entrada en el cuadro de texto.
  Al consultar sobre atributos de campos de fecha, y especificar la opción la fecha para el valor, si lo desea, puede elegir la hora del día activando Mostrar hora. Esta opción le permite especificar la precisión horaria del campo para que aparezca en la aplicación, si este atributo y su precisión son aplicables.
  Nota:
  Debe elegir una fecha antes de configurar la hora.
  Puede elegir entre los niveles Hora, Minuto o Segundo para establecer la precisión horaria. Por ejemplo, si define previamente los valores Hora y Minuto, pero deja Segundo en blanco, no verá los valores de segundo de la selección en el tiempo de ejecución, ni tampoco podrá introducirlos, ni siquiera aunque la capa contenga atributos relativos a los segundos. Si activa la casilla Mostrar hora, pero deja en blanco los tres cuadros de texto de Hora, Minuto y Segundo, no verá la opción para especificar la hora en el tiempo de ejecución.
  Dispone de las siguientes opciones para Establecer tipo de entrada con el botón Establecer :
  - Valor: este filtro se basa en un valor específico. Puede establecer un valor predefinido o pedir interactivamente al usuario final un nuevo valor activando Pedir valores. Si Pedir valores está habilitado, proporcione información sobre el valor del campo Solicitar y una sugerencia en el campo Sugerencia. Esto ayudará al usuario final a introducir los valores de la consulta.
  - Campo: compara el valor de un campo con el valor de otro campo.
  - Único: este filtro se basa en una lista de valores únicos para el campo seleccionado en la capa. A menudo se usa junto con Pedir valores para que el usuario final pueda seleccionar interactivamente un valor de una lista, que puede ser un conjunto de todos los valores únicos o un conjunto de valores únicos dinámicos basados en las expresiones previas o en todas las demás expresiones independientemente de su orden. Si Pedir valores está habilitado, proporcione información sobre el valor del campo Solicitar y una sugerencia en el campo Sugerencia y seleccione cómo se enumeran los valores.
  - Únicos (predefinidos): predefine una lista estática de valores; también le permite mostrar dinámicamente los valores basándose en las expresiones anteriores o en todas las demás expresiones independientemente de su orden.
    Precaución:
    Los filtros de valor único requieren una capa del servicio de mapas 10.1 o posterior. Al crear un filtro en una capa de servicio 10.0 o anterior, no aparece la opción Únicos.
    Precaución:
    Para mostrar una descripción para los valores codificados cuando se selecciona Valores filtrados por las expresiones anteriores o Valores filtrados por todas las demás expresiones, el servicio debe admitir la capacidad de consulta por estadísticas.
  - Múltiples: filtra varios valores en el campo y recupera una lista dinámica de valores de la capa.
  - Múltiples (predefinidos): predefine una lista estática de valores.
    Nota:
    Solamente los operadores es cualquiera de y no es ninguno de admiten varios valores.
  Nota:
  Si ha creado una expresión basada en valores o un valor único, es posible definir una expresión interactiva activando la casilla de verificación Pedir valores. No puede pedir valores sobre expresiones basadas en un campo.
3. Utilice + Agregar conjunto para agregar un conjunto de expresiones, que le permite definir y aplicar dos filtros a una sola consulta. Si Todas o Cualquiera de las expresiones de este conjunto son true, se devuelven como resultados los registros que satisfacen todas las expresiones o los registros que satisfacen alguna de las expresiones del conjunto.
4. Haz clic en Aceptar para cerrar el cuadro de diálogo.
Opcionalmente, active Mostrar expresión SQL para usuarios finales para mostrar la expresión SQL en el widget.
La sección Filtros espaciales le permite elegir qué filtros espaciales estarán disponibles para los usuarios finales. Active uno o varios de los siguientes filtros y defina uno de ellos como predeterminado haciendo clic en Definir como predeterminado.
- Devolver solo entidades contenidas en la extensión de mapa actual: devuelve las entidades incluidas en la extensión de mapa actual.
- Devolver solo las entidades que intersecan con la forma dibujada en el mapa: haga clic en los iconos para elegir las herramientas de dibujo que se muestran en el widget. Opcionalmente, active Habilitar opción de zona de influencia para agregar una configuración de la zona de influencia para los usuarios finales.
- Devolver solo entidades que tengan una relación espacial con entidades de otra capa: haga clic en Establecer para elegir las reglas de relación espacial de Definir relaciones espaciales. Puede especificar una etiqueta fácil de usar para cada relación haciendo doble clic en el campo de etiqueta. Opcionalmente, active Habilitar opción de zona de influencia para agregar una configuración de la zona de influencia para los usuarios finales. Se admiten las siguientes relaciones espaciales:
  - Intersecar: parte de una entidad de la capa 1 está incluida en una entidad de la capa 2.
  - Contener: una entidad o parte de la misma de la capa 1 contiene por completo la entidad de la capa 2.
  - Cruzar: la entidad de la capa 1 cruza una entidad de la capa 2.
  - Intersección de sobres: el sobre de la capa 1 interseca con el sobre de la capa 2.
  - Intersección de índice: el sobre de la capa de consulta interseca la entrada de índice de la capa de destino.
  - Superponer: las entidades de la capa 1 se superponen a las entidades de la capa 2.
  - Tocar: la entidad de la capa 1 toca el borde de una entidad de la capa 2.
  - Dentro: la entidad de la capa 1 está completamente rodada por la entidad de la capa 2.
- Devolver entidades contenidas en la extensión completa del mapa: devuelve las entidades contenidas en la extensión completa del mapa.
Nota:
Desactive todas las opciones si no desea aplicar un filtro espacial a la consulta.
Haga clic en la pestaña Resultados para configurar el contenido que se muestra y el símbolo de los resultados de la consulta.
Opcionalmente, active Usar configuración de ventana emergente de la capa en el mapa web para mostrar el mismo contenido definido por la configuración de la ventana emergente de la capa en el mapa web.
Opcionalmente, active Configurar contenido personalizado para mostrar el contenido personalizado.
1. Haga clic en el icono Agregar situado junto al cuadro de texto Título de cada elemento de resultado.
  La lista de campos en las visualizaciones de capas. Puede seleccionar campos de uno en uno. Los valores del campo seleccionado se muestran en el cuadro de texto y se utilizan como título de resultados de consulta. Repita este paso para agregar campos adicionales. Cuando se agregan varios campos, la concatenación de valores de campo se utiliza como título de resultado.
2. Haga clic en el botón de lápiz situado junto al cuadro de texto Se mostrarán estos atributos de campo para abrir el cuadro de diálogo Definir campos de visualización. Active los campos si desea mostrarlos en los resultados. Para los campos individuales, la columna Tipo especial permite que se visualicen como una imagen. También puede hacer clic en las flechas hacia arriba o hacia abajo de la columna Acciones para ajustar el orden del campo.
Haga clic en el icono de lápiz situado junto a Ordenar elementos de resultados para configurar los campos usados para ordenar el resultado de la consulta.
Los servicios deben admitir la paginación o la ordenación de los resultados de la consulta.
Opcionalmente, seleccione la opción Usar símbolos definidos por la capa para utilizar el símbolo predeterminado de la capa.
También puede seleccionar la opción Utilizar símbolo personalizado y hacer clic en el icono de símbolo para definir un símbolo personalizado.
Aparece la ventana Vista previa, que le permite elegir el color y un estilo para el símbolo de resaltado resultante.
Haga clic en cualquier parte fuera de la ventana de vista previa de símbolo para cerrarla.
Opcionalmente, active Permitir cambiar símbolos en tiempo de ejecución para cambiar interactivamente los símbolos para las entidades resultantes en tiempo de ejecución.
Haga clic en la pestaña Opciones para especificar si los resultados pueden exportarse o no y cómo creará capas la tarea de consulta.
Repita los pasos del 3 al 20 para agregar más tareas de consulta.
Para reordenar las tareas de consulta existentes, pase el ratón por la tarea y haga clic en las flechas arriba y abajo.
Si lo desea, seleccione Desactivar las capas de resultados de la consulta cuando el widget esté cerrado y personalice Etiquetas de pestaña.
Haga clic en Aceptar para guardar y cerrar la ventana Consulta.

Utilizar el widget Consultar

En los pasos siguientes se explica cómo utilizar el widget Consultar:

Haga clic en el widget Consulta para abrirlo. Se muestra una lista de consultas en la pestaña Tareas si ha configurado más de una consulta.
Si el widget solo tiene una consulta y no pide entradas de los usuarios finales, al hacer clic en el widget se ejecutará la consulta y se mostrarán inmediatamente los resultados.
Si el widget solo tiene una consulta y pide entradas de los usuarios finales, al hacer clic en el widget se mostrará la consulta con las entradas de los usuarios.
Nota:
Las entradas de los usuarios finales pueden incluir criterios de atributo, uno o varios filtros espaciales o una combinación de ambos.
Haga clic en una de las consultas. La consulta puede ejecutarse de forma distinta según la configuración.
1. Si la consulta no pide entradas, el resultado se muestra en la pestaña Resultados y las entidades resultantes se muestran en el mapa con el símbolo que haya especificado durante la configuración.
2. Si se activa Pedir valores durante la configuración, se muestra un cuadro de texto en el que se solicita un valor nuevo para el parámetro. El valor predeterminado se muestra inicialmente en el cuadro. Si se definen valores únicos, en el cuadro de texto se mostrarán todos.
  Nota:
  Al consultar sobre atributos de campos de fecha, si está configurado el selector de hora, puede elegir valores de hora predefinidos en el menú desplegable, o bien puede modificarlos escribiendo en el cuadro.
3. Puede utilizar uno o varios filtros espaciales.
  - Devolver solo entidades contenidas en la extensión de mapa actual: devuelve las entidades incluidas en la extensión de mapa actual.
  - Devolver solo las entidades que intersecan con la forma dibujada en el mapa: puede utilizarse un conjunto de herramientas de dibujo para dibujar formas en el mapa y definir el área. Como opción, se puede aplicar una distancia de búsqueda a las formas.
  - Devolver solo entidades que tengan una relación espacial con entidades de otra capa: los resultados se basan en la relación espacial entre las entidades de la capa de consulta y las entidades de la capa relacionada. También se puede aplicar una distancia de búsqueda a las geometrías de las entidades de la capa relacionada.
  - Devolver entidades contenidas en la extensión completa del mapa: devuelve las entidades contenidas en la extensión completa del mapa.
4. Haga clic en Aplicar para ejecutar la consulta.
  Las entidades resultantes de la consulta se han resaltado en el mapa con el símbolo especificado durante la configuración. Si la capa tiene datos relacionados, los registros relacionados también se incluyen en los resultados.
En el panel de resultados de la consulta:
- Entidades mostradas: muestra cuántos resultados se muestran de todos los resultados devueltos. Haga clic en el botón Cargar más para cargar más resultados y visualizarlos.
- Haga clic en Expandir todo o Contraer todo para expandir/contraer todos los detalles de resultados mostrados y o para ver resultados individuales.
- Haga clic en el botón de puntos suspensivos (...) para actuar sobre el conjunto de resultados de la siguiente manera:
  - Acercar a
  - Desplazar a
  - Flash
  - Estadísticas
  - Ver en la tabla de atributos
  - Eliminar este resultado
  - Cambiar símbolo
Sugerencia:
El número máximo de entidades que puede devolver una consulta depende de la propiedad maxRecordCount configurada en el servicio. El valor predeterminado es 1.000. Por ejemplo, si adopta el valor predeterminado y espera que una consulta devuelva 1.300 entidades, verá primero 1.000 entidades en el panel de resultados de consulta. Al desplazarse hacia abajo por el panel, verá las 300 entidades restantes.
Como alternativa, si la consulta se realiza en una tabla relacionada, todas las entidades relacionadas se resaltan en el mapa y se enumeran en el panel Consulta.