Reportes

Los reportes de información se utilizan para presentar información descriptiva relativa a los elementos de un mapa. Estos informes pueden presentar atributos provenientes de la fuente de datos espaciales subyacente o información extraída de otras bases de datos externas a JMap. Cada capa puede contener cero, uno o varios reportes. Los reportes informativos se presentan en forma de páginas web o de documentos en formato PDF.

La pestaña Reportes en la interfaz de configuración de la capa contiene las herramientas para configurar los reportes.

La sección de los reportes muestra la tabla de reportes configurados para la capa. En las aplicaciones JMap los reportes son presentados en ese mismo orden. Usted puede cambiar el orden utilizando el menú Modificar.

Para crear un nuevo reporte presione Crear.

Para suprimir reportes, selecciónelos en la tabla y presione Suprimir.

Creación de un reporte

Hay tres tipos de reporte: Básico, Avanzado y Personalizado.

Básico

Los reportes de tipo básico son generados como páginas web. Contienen funciones de exportación a archivo en formato Excel y de impresión. Las tablas conteniendo los valores pueden ser ordenadas haciendo clic en el encabezado de las columnas. También es posible configurar los nombres de los campos que se visualizarán en los reportes.

Título	El título del reporte.
Extraer los datos de	Capa actual: Obtener los datos del reporte directamente de los atributos de la capa. Ver Fuente de datos del reporte - Capa actual. Base de datos externa: Obtener los datos del reporte de una base de datos externa, conectada a JMap. Esta base de datos debe contener un campo que permita establecer una relación con un atributo de la capa. Ver Fuente de datos del reporte - Base de datos externa.
Modelo (simple)	Modelo utilizado para los reportes sobre un elemento de la capa.
Modelo (múltiple)	Modelo utilizado para los reportes sobre un conjunto de elementos de la capa.

Atributos
Título	Texto que se visualizará en el reporte como nombre del atributo.

Avanzado

Los reportes de tipo avanzado se basan en la herramienta de creación de reportes BIRT (http://www.eclipse.org/birt/). JMap provee un modelo de reporte por defecto. Se puede también utilizar la aplicación BIRT report Designer para crear reportes personalizados o editar el modelo por defecto y adaptarlo a las necesidades específicas (añadir un logo, cambiar los colores, etc.). Para obtener más detalles sobre el desarrollo de reportes, puede consultar el sitio web de BIRT (http://www.eclipse.org/birt/).

Los reportes pueden ser generados en formato HTML o PDF. Se puede también integrar un mapa.

Formato	HTML: El reporte se genera bajo la forma de una página web. Contiene herramientas para exportar el contenido del reporte o para imprimirlo. Si se trata de un reporte sobre varios elementos del mapa, es posible ordenar el contenido del reporte haciendo clic en el encabezado de las columnas. PDF: El reporte se genera en formato PDF. Este formato está mejor adaptado para la impresión dado que posee un mejor diseño. El contenido del reporte es más estático que con el formato HTML.
Título	El título del reporte.
Extraer los datos de	Capa actual: Obtener los datos del reporte directamente de los atributos de la capa. Ver Fuente de datos del reporte - Capa actual. Base de datos externa: Obtener los datos del reporte de una base de datos externa, conectada a JMap. Esta base de datos debe contener un campo que permita establecer una relación con un atributo de la capa. Ver Fuente de datos del reporte - Base de datos externa.
Modelo (simple)	Modelo utilizado para los reportes sobre un sólo elemento de la capa. Dos modelos están disponibles: inforequest.rpttemplate: Modelo básico que contiene una tabla dispuesta verticalmente. inforequestMap.rpttemplate: Similar al modelo básico pero contiene también un mapa. Ver Modelos de reportes de tipo avanzado.
Modelo (múltiple)	Modelo utilizado para los reportes sobre un conjunto de elementos de la capa. Dos modelos están disponibles: selectionreport.rpttemplate: Modelo básico que contiene una tabla dispuesta horizontalmente. selectionreportMap.rpttemplate: Similar al modelo básico pero contiene también un mapa. Ver Modelos de reportes de tipo avanzado.

Modelos de reportes de tipo avanzado

Con los reportes de tipo avanzado usted puede elegir el modelo de reporte que va a utilizar.

Dos modelos se incluyen por defecto con JMap, un modelo de reporte básico y un modelo de reporte con un mapa integrado. Cada uno de esos modelos está disponible en dos versiones: para un sólo elemento o para una selección de múltiples elementos.

Usted puede crear sus propios modelos de reporte basándose en los modelos existentes, y añadirlos a los de JMap. Tendrá entonces la posibilidad de seleccionar sus modelos personalizados para la configuración de los reportes.

Los archivos de los modelos de reportes (.rpttemplate) se encuentran en el directorio JMAP_HOME/applications/templates/reports. Sus modelos deben ser colocados en el subdirectorio single o multiple, según se trate de versiones para uno o para varios elementos.

Personalizado

Los reportes de tipo personalizado son reportes externos a JMap que pueden ser llamados mediante un URL. Estos reportes pueden provenir de herramientas de creación de reportes (Crystal Reports, Jaspersoft, etc.) o de una simple página web.

Una sintaxis especial permite formatear los parámetros necesarios para abrir el reporte.

Título

El título del reporte.

URL del reporte

Ingrese el URL que le permitirá abrir el reporte externo. Es probable que deba pasar ciertos parámetros en el URL del reporte para identificar los elementos para los cuales desea abrir el reporte. Los valores de los parámetros provienen, en general, de los atributos vinculados a los elementos del mapa. Se utiliza una sintaxis especial para formatear los parámetros. Por ejemplo, si su reporte debe ser llamado mediante este URL: http://myserver/reports/myreport?id=3 Si el atributo 0 contiene los valores del parámetro, la sintaxis que debe utilizar es: http://myserver/reports/myreport?id=%0 Si su reporte incluye información sobre una selección de múltiples elementos del mapa, la sintaxis de los parámetros puede adoptar una de las dos formas siguientes: Si su reporte debe ser llamado por este URL: http://myserver/reports/myreport?id=3,4,5 Si el atributo 0 contiene los valores del parámetro, la sintaxis que debe utilizar es: http://myserver/reports/myreport?%param[%0,'id',','] Esta sintaxis utiliza la expresión %param[Índice atributo, nombre del parámetro, separador]. Si su reporte debe ser llamado por este URL: http://myserver/reports/myreport?id=3,id=4,id=5 Si el atributo 0 contiene los valores del parámetro, la sintaxis que debe utilizar es: http://myserver/reports/myreport?%param[%0,'id'] Esta sintaxis utiliza la expresión %param[Índice atributo, nombre del parámetro]. En la composición del URL se pueden incluir otras variables, tales como %f, %p, %u, %h, etc. La sección Variables soportadas en la sintaxis de los URL ofrece los detalles correspondientes.

Variables soportadas en la sintaxis de los URL

Variable	Visualización
%n	Sustituida por el valor del atributo vinculado que corresponde al elemento. Por ejemplo, %0 hace referencia al primer atributo vinculado, %1 al segundo, %2 al tercero, etc.
%f	Sustituida por una fecha o un número formateado. Dos formatos son posibles: %f [%n^D^dd/MM/yyyy] dónde %n corresponde a un atributo que contiene una fecha, D indica que se desea visualizar una fecha formateada y dd/MM/yyyy es la secuencia del formato, como se indica en la documentación de la clase Java java.text.SimpleDateFormat. %f[%n^N^##0,00] dónde %n corresponde a un atributo que contiene un número, N indica que se desea visualizar un número formateado, y ##0,00 es la secuencia del formato, como se indica en la documentación de la clase Java java.text.NumberFormat.
%p	Sustituida por el nombre del proyecto en curso.
%u	Sustituida por el nombre del usuario actualmente conectado.
%s	Sustituida por el identificador de la sesión en curso.
%h	Sustituida por el nombre del host o la dirección de la instancia del servidor JMap Server a la cual la aplicación está conectada.
%o	Sustituida por el número del puerto (http o directo) de la instancia de JMap Server a la cual la aplicación está conectada.
%t	Sustituida por la hora actual (fecha y hora).

Fuentes de datos del reporte

Los reportes de tipo básico y avanzado pueden tomar los datos de los atributos de la capa o de una base de datos externa conectada a JMap.

Capa actual

Seleccione la opción Capa actual para crear un reporte simple que interrogue los atributos de la capa. Seleccione luego los atributos que se deben incluir en el reporte, marcando las casillas correspondientes. Sólo los atributos seleccionados serán presentados al usuario, los otros atributos serán excluidos del reporte. Finalmente, se pueden especificar títulos para los atributos. El usuario verá los títulos y no los nombres reales de los atributos.

Base de datos externa

Seleccione la opción Base de datos externa para indicar a JMap que debe presentar información proveniente de otra base de datos y no de la capa. Esta opción permite interrogar toda base de datos que posea un campo que corresponde a uno de los atributos de la capa.

Atributos
Base de datos	Seleccione la base de datos a partir de la cual serán extraídos los datos. La base de datos que se va a interrogar debe haber sido configurada en JMap previamente.
Expresión de consulta SQL	Ingrese la expresión de consulta SQL de tipo SELECT que se utilizará para extraer los datos de la base de datos. Esta expresión puede incluir varias tablas. La petición debe incluir el campo clave que se utilizará para efectuar la unión con un atributo de la capa. Seguidamente presione Ejecutar para ejecutar la consulta una vez.

Campos de unión
Tabla	Seleccione la tabla que contiene el campo de unión.
Campo	Entre los campos de la tabla seleccionada, seleccione aquel que se utiliza para efectuar la unión con la capa.
Atributo	Entre los atributos de la capa, seleccione el que se utiliza para efectuar la unión con la base de datos.

Títulos

Para los reportes que toman los datos de una base de datos externa, es posible definir los títulos de los campos que se visualizarán en el reporte, reemplazando los nombres de los campos de la base de datos. Presione Títulos para definirlos.