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 servicio de imágenes
- Tabla relacionada
El widget Consulta sirve como generador de consultas durante la configuración, permitiéndole definir la consulta especificando los datos de origen, expresión de filtro 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.
Configuración del widget Consulta
El widget Consulta se puede definir para que se abra automáticamente al iniciar una aplicación. Para ello, haga clic en el punto amarillo del widget para volverlo verde.
Los pasos siguientes indican cómo crear una consulta de definición. Repita estos pasos si necesita definir varias consultas.
- Desplace el ratón por el widget Consulta y haga clic en el icono pequeño de edición
.Se abre la ventana de configuración de este widget.
- Opcionalmente, haga clic en el icono cambiar icono de widget si desea reemplazar el icono predeterminado para este widget.
Se abre 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 Agregar nuevo junto a Tareas de consulta.
Se abre la ventana Establecer fuente de datos. De manera predeterminada, se elige Seleccionar en el mapa y todas las capas de entidades del mapa actual se muestran debajo.
Alternativamente, puede elegir Seleccionar en Portal o Agregar dirección URL del servicio. Además de capas, puede consultar las tablas relacionadas.
- Seleccione el botón de radio junto a una fuente de datos.
- Seleccione una capa de la lista.
- Haga clic en Aceptar para cerrar la ventana Establecer fuente de datos y volver a la ventana de configuración de la consulta.
De manera predeterminada, la pestaña Definición de filtro está activa.
- Haga clic en Agregar una expresión de filtro para visualizar el generador de expresiones.
- Seleccione un campo de consulta, una expresión y proporcione un valor en el cuadro de texto. Si lo desea, elija la opción Único para que se muestren todos los valores únicos del campo seleccionado en la capa. Esta opción resulta útil cuando el campo seleccionado es una cadena de caracteres o un número.
- De manera opcional, active Pedir valores.
- Tiene también la opción de usar Agregar una expresión a este conjunto, que le permite definir y aplicar dos filtros a una sola consulta. Dependiendo de si Todas las expresiones de este conjunto o Cualquiera de ellas se cumplen, se devolverán como resultados los registros que cumplan todas las expresiones o los que cumplan cualquiera de ellas.
- Haga clic en la pestaña Configuración de resultados para activarla. Esta pestaña permite configurar el título y ordenar el contenido para los resultados de la consulta. Los campos de la capa de datos disponibles para la visualización se muestran en esta pestaña.
- Haga clic en el botón de agregar situado al lado del cuadro de texto Título del elemento de resultado.
Se muestra la lista de campos de la capa, que permite seleccionarlos 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.
- Haga clic en el botón de lápiz que hay junto a Ordenación del elemento de resultado para configurar los campos por los que se ordena el resultado de la consulta.
Los servicios deben admitir la paginación u ordenación en el resultado de la consulta.
- En Contenido del elemento de resultado, active los campos que desea visualizar en los resultados. Para los campos individuales, la columna Tipo especial permite que se muestren como un vínculo o una imagen dependiendo de la selección. También puede hacer clic en las flechas arriba o abajo de la columna Acciones para ajustar el orden del campo.
- Haga clic en el símbolo para los resultados de consulta.
Se abre la ventana de vista previa, que le permite elegir el color y un estilo para el símbolo para resaltar resultados.
- Haga clic en cualquier parte fuera de la ventana de vista previa de símbolo para cerrarla.
- Haga clic en Aceptar para cerrar la ventana Consulta.
Se guarda la definición de consulta y se cierra la ventana de configuración de consulta.
- Para volver a ordenar las tareas existentes, desplace el cursor por encima del nombre de la tarea y haga clic en la flecha de Rueda del ratón hacia arriba o Rueda del ratón hacia abajo. Para cambiar el nombre de una tarea, elija la tarea en la tabla de nombres de tarea, actualice el texto en el cuadro de texto Nombre de tarea y haga clic en otro lugar de la ventana para confirmar el cambio.
La expresión de filtro puede ser una operación basada en valores o una operación entre dos campos. Al elegir la opción Único, se muestran los valores únicos del campo seleccionado en la capa. De manera predeterminada, se elige Valor.
Uso del widget Consulta
Al hacer clic en el widget Consulta en su aplicación, se muestra la lista de consultas predefinidas. Al seleccionar una consulta, se muestran las opciones para ejecutarla. Las opciones son las siguientes:
- Si se especifica Pedir valores durante la configuración, se abre un cuadro de texto en el que se pide un nuevo valor para el parámetro. El valor predeterminado se muestra inicialmente en el cuadro. Si se han definido valores únicos, en el cuadro de texto se mostrarán todos.
- Usar filtro espacial: el filtro espacial se aplica sobre la definición de consulta.
- Utilizar la extensión de mapa actual: solo se devuelven las entidades que caigan en la extensión de mapa actual y cumplan la definición de consulta.
- Dibujar un gráfico en el mapa: solo se devuelven las entidades que caigan dentro del gráfico y cumplan la definición de consulta.
- Agregar resultado como capa operativa: cuando se activa esta opción, los resultados de la consulta permanecen en el mapa hasta que se hace clic en el botón Borrar resultados.
Puede elegir una o varias opciones. Haga clic en Aplicar para ejecutar la consulta y visualizar los resultados. Si la capa tiene datos relacionados, los registros relacionados también se incluyen en los resultados. Las entidades resultantes de la consulta se resaltan en el mapa con el símbolo especificado en el momento de la configuración.
Sugerencia:
El número máximo de entidades que puede devolver una consulta depende de la propiedad maxRecordCount configurada en el servicio. De forma predeterminada, es 1.000. Por ejemplo, si adopta el valor predeterminado y espera que una consulta devuelva 1.300 entidades, primero verá 1.000 entidades en el panel del resultado de la consulta. Al desplazarse hacia abajo por el panel, verá las 300 entidades restantes.
Si la consulta se lleva a cabo sobre una tabla relacionada, en el resultado se mostrarán las entidades relacionadas.