Widget de consulta
En este tema
El widget Consulta permite recuperar información a partir de los datos de origen ejecutando una consulta predefinida. Las fuentes de datos pueden ser de los siguientes tipos:
- Capa de entidades del mapa actual
- Capa de entidades como elemento en el portal
- Capa de entidades del servicio REST de ArcGIS Server
Sugerencia:
Una capa de entidades puede proceder de un servicio de mapas o de un servicio de entidades.
El widget Consulta funciona como generador de consultas durante la configuración y permite definir la consulta especificando los datos de origen y la expresión de filtro y mostrando los filtros en los resultados de la consulta. Cada consulta funciona con una única capa. Sin embargo, puede definir varias consultas para una única aplicación y las capas de datos pueden proceder de varias fuentes.
Configurar el widget Consulta
En los siguientes pasos se indica 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 imagen 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 a continuación.
Como alternativa, puede elegir Seleccionar en portal o Agregar URL de servicio.
- Elija el botón de opción situado junto a una fuente de datos.
- Seleccione una capa en 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 y 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 la casilla Pedir valores.
- Tiene también la opción de usar Añadir una expresión a este conjunto, lo que 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 los contenidos mostrados 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 Agregar campo junto al cuadro de texto del título.
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 los resultados de la consulta. Repita este paso para agregar más campos. Cuando se agregan varios campos, se usa la concatenación de valores de campos como título del resultado.
- Active los campos que desee 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 de los resultados de la consulta.
Se abre la ventana de vista previa, que permite elegir el color y el estilo del símbolo que resalta el resultado.
- Haga clic en un punto situado fuera de la ventana de vista previa del símbolo para cerrarla.
- Haga clic en Aceptar para cerrar la ventana Consulta.
La definición de la consulta se guarda y la ventana de configuración de la consulta se cierra.
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.
Nota:
Cuando elija esta opción, proporcione los textos de los dos mensajes y los de las sugerencias para que la consulta se guarde correctamente; de lo contrario, aparecerá un mensaje de error.
Utilizar el 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:
- 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 establecido los valores únicos, en el cuadro de texto figurarán todos ellos para que pueda seleccionar.
- Usar filtro espacial: el filtro espacial se aplica sobre la definición de la consulta.
- Usar la extensión del mapa actual: solo se devuelven las entidades que se encuentran dentro de la extensión de mapa actual y que cumplen la definición de la consulta.
- Dibujar un gráfico en el mapa: solo se devuelven las entidades que se encuentran dentro del gráfico y que cumplen la definición de la 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 seleccionar 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.
