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 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.
Ejemplo de reporte básico
Configuración
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 (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/).
Ejemplo de reporte avanzado con mapa
Reporte avanzado
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.
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.
Modelos de reportes (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.
Información general
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 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.
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
Seleccionar la opción Capa actual para crear un reporte simple que interrogue los atributos de la capa. Seleccionar 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
Seleccionar 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 debe presionar 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.
Formularios
Los formularios se utilizan en JMap para ingresar los parámetros de búsqueda en las consultas de selección por atributos, para el ingreso de los datos de los atributos de las capas editables y para la gestión de los datos almacenados en las bases de datos, siempre que éstos estén
relacionados con los elementos de una capa. Existe también un tipo de formulario denominado subformulario, al que se accede a partir de un formulario.
El administrador JMap concibe los formularios mediante el diseñador de formularios y los usuarios pueden luego utilizarlos en las aplicaciones JMap Pro, JMap Web y JMap Mobile. Según los
permisos acordados, los usuarios pueden utilizar los formularios de ingreso de datos para visualizar, añadir, modificar o suprimir los datos.
Las secciones siguientes explican en detalle el proceso de creación de los formularios así como la función de cada tipo de formulario.
Ejemplo de formulario abierto en JMap Pro