Consultas de selección por atributos
Esta función permite seleccionar elementos de una capa utilizando los valores de sus atributos o utilizando una base de datos vinculada a la capa.
Los administradores crean las consultas y sus formularios asociados en JMap Admin. Los usuarios de las aplicaciones JMap utilizan luego esos formularios para ingresar los valores de los atributos y efectuar las búsquedas. Todos los elementos cuyos valores de atributos corresponden a los valores ingresados son seleccionados y presentados en el explorador de elementos.
La pestaña Consultas de la interfaz de configuración de un proyecto le permite configurar las consultas de selección por atributos del proyecto.
La pestaña Consultas se visualiza cuando el proyecto contiene al menos un capa.
La pestaña presenta una tabla con los grupos de consultas. El grupo Defecto es el grupo por defecto. La tabla indica el número de consultas que contiene cada grupo. La sección Organización de las consultas ofrece detalles sobre los grupos.
Crear una consulta de selección por atributos
Las consultas se crean dentro de un grupo de consultas
Seleccione el grupo en la tabla y presione su nombre para abrir su interfaz de detalle. En la misma se visualiza el botón Crear una consulta.
Los parámetros varían en función del tipo de consulta seleccionado.
Título | Ingrese un título para la consulta. Los usuarios verán ese título en la lista de consultas. |
Capa | Seleccione la capa en la que se ejecutará la consulta. El campo de búsqueda facilita la selección de la capa. |
Escala máxima | Ingrese la escala máxima para la visualización de los resultados en el mapa. Esto es útil para evitar los zooms demasiado detallados sobre los resultados. |
Nro. max. de valores devueltos | Ingrese el número máximo de elementos que pueden ser devueltos por la consulta. Ésta no se ejecutará si el tamaño del resultado es superior a este límite. Este parámetro evita la ejecución de consultas demasiado voluminosas que podrían disminuir el rendimiento del sistema. |
Modelos de consultas | Básico: En este tipo de consulta la búsqueda se efectúa únicamente en los atributos de la capa. Es el tipo más simple de consulta. Base de datos externa: En este tipo de consulta la búsqueda se efectúa en una base de datos externa que posee un campo que la vincula a un atributo de la capa. Este tipo de consulta es más complejo para configurar pero ofrece más flexibilidad para las búsquedas. |
Consultas en la capa
WHERE | Cláusula WHERE de la expresión SQL que se ejecuta para realizar la búsqueda. Típicamente esta cláusula contiene parámetros numerados ( Selecciona los elementos de la capa que tienen el valor del atributo COUNTRY igual al valor ingresado por el usuario. El valor del atributo debe corresponder perfectamente al valor ingresado (
lower(COUNTRY) like lower( Selecciona los elementos de la capa que tienen el valor del atributo COUNTRY similar al valor ingresado por el usuario. El valor del atributo debe comenzar por el valor ingresado (
POP2000>= Selecciona los elementos de la capa que tienen el valor del atributo POP2000 dentro del rango definido por los dos valores ingresados ( |
Diseño de formulario | Presione este botón para configurar el formulario de la consulta. La sección Formularios ofrece más detalles sobre el tema. |
Consultas externas
Este tipo de consultas se utiliza cuando se debe hacer una búsqueda en datos contenidos en una base de datos externa a JMap. La base de datos externa debe tener un campo que permita vincularla con un atributo de la capa. En primer lugar se ejecuta una consulta SQL de tipo SELECT en la base de datos externa y los valores devueltos por la misma son luego asociados a los elementos de la capa utilizando el campo de vinculación.
Bases de datos | Seleccione la base de datos en la que desea efectuar la búsqueda. |
Expresión SQL | Ingrese la expresión SQL que será ejecutada en la base de datos para buscar los elementos.
Ejemplo
Busca en la tabla cities de la base de datos seleccionada. Devuelve los registros cuyo valor del campo CITY_LANGUAGE es igual al valor ingresado por el usuario ( |
Atributo de la capa | Especifique, entre los atributos de la capa, el atributo que servirá para establecer el vínculo con la base de datos. |
Campo | Seleccione, entre los campos devueltos por la consulta SQL, el campo que servirá para establecer el vínculo con la capa. |
Diseño de formulario | Presione este botón para configurar el formulario de la consulta. La sección Formularios ofrece más detalles sobre el tema. |
Parámetros obligatorios y opcionales
Aún si el diseño del formulario de consulta indica que un campo es obligatorio u opcional, la cláusula WHERE de la expresión de consulta debe ser ajustada para soportar esta opción. Para ello, las partes de la consulta que están asociadas a parámetros opcionales deben estar incluidas entre llaves ( { } ).
Ejemplo de cláusula WHERE:
CITY = '$param1' and { COUNTRY = '$param2' }
Este ejemplo efectúa la búsqueda de las ciudades cuyo valor para el atributo CITY es igual al valor del parámetro 1 ingresado por el usuario ($param1) y que opcionalmente tienen el valor del atributo COUNTRY igual al valor del parámetro 2 ingresado por el usuario ($param2). Si el parámetro 2 no se ingresa, todo el bloque { COUNTRY = '$param2' } es eliminado de la consulta, así como el operador AND que se vuelve huérfano. Atención: el administrador debe obligatoriamente definir $param2 como opcional en el diseño del formulario. La sección Formularios ofrece más detalles sobre este tema.
Valores múltiples para un mismo parámetro
Se puede permitir el ingreso de valores múltiples en los formularios, en un campo de tipo Lista (opciones múltiples). Los valores se separan mediante el carácter delimitador ; (punto y coma) . Esta opción puede ser activada en la cláusula WHERE de la consulta. La sintaxis es la siguiente:
$multiple{true|false} {\$delimiter{;}}
Ejemplo:
CITY = '$param1{$multiple{true} $delimiter{;}}'
Selecciona las ciudades cuyo valor del atributo CITY es igual a uno de los valores ingresados en el parámetro 1. Los valores están separados por punto y comas (;).
Gestión de las consultas de selección por atributos
Los administradores pueden modificar las consultas por atributos. Cuando las consultas se modifican no es necesario desplegar nuevamente las aplicaciones que publican el proyecto, dado que los cambios se transmiten de manera directa.
Organización de las consultas
Las consultas de selección por atributos pueden ser organizadas en grupos, lo que resulta especialmente útil en los proyectos que implican un número elevado de consultas.
Para crear un nuevo grupo, en la pestaña Consultas presione el botón Crear un grupo.
Para suprimir un grupo, selecciónelo en la lista y presione Suprimir.
Supresión de las consultas
La supresión de una consulta de selección por atributos suprime definitivamente la consulta y el formulario que está asociado a la misma. Para suprimir una consulta, selecciónela en la lista y presione Suprimir.
Publicación de las consultas
Una vez que la consulta ha sido creada se de forma automática y es accesible en todas las aplicaciones que difunden el proyecto.
Usted puede anular esta publicación para que la misma no esté disponible para los usuarios de las aplicaciones sin perder su configuración. Para anular la publicación de una consulta, desmarque la marca Publicada de la consulta en la interfaz de gestión de las consultas.
Consultas sobre las capas por referencia
Cuando un proyecto contiene capas por referencia, las consultas configuradas sobre esas capas en el proyecto que contiene las capas originales están disponibles automáticamente en el proyecto, que “hereda” esas consultas.
Usted no puede modificar esas consultas “por referencia” a partir del proyecto, éstas sólo pueden ser modificadas en el proyecto que contiene las capas originales.
Si usted desea modificar una consulta “por referencia” cree una copia de la consulta presionando Duplicar. La interfaz de configuración presenta los parámetros de la consulta que usted puede modificar.
Después que la nueva consulta ha sido configurada, usted debe desmarcar la marca Publicada de la consulta “heredada” de la capa por referencia para que ésta no sea más accesible en las aplicaciones JMap que utilizan dicha capa por referencia.
Usted también puede crear una nueva consulta sobre una capa por referencia, tal como se describe en la sección Crear una consulta de selección por atributos.
Dernière mise à jour
