Un informe es un documento que permite mostrar el contenido de un origen de datos aplicando un formato que permita a los usuarios adquirir información. Son un modo eficaz de presentar la información ejerciendo un control bastante preciso sobre cómo se presenta, ya que se permite: ver, formatear y resumir datos relacionados. Por ejemplo, en un informe que muestre como datos la duración media de las estancias en el hotel organizadas por meses, la información deducible por el usuario será los meses en los que cabe esperar una mayor ocupación.

Normalmente, un informe se genera a partir de un diseño en el que se determina la distribución y configuración de los elementos a mostrar y que podemos crear utilizando alguna herramienta gráfica. Luego, se combina el diseño con los datos actuales almacenados en el origen de datos volcando el resultado en documentos que faciliten su lectura e interpretación al usuario y posibilitando su impresión y almacenamiento de copias, aunque no se podrán modificar una vez generados. En caso de haber modificaciones en el origen de datos, tendremos que generar de nuevo el informe para reflejar esos cambios.

¿Por qué los informes son un elemento fundamental en cualquier modelo de negocio?

• Porque necesitamos distribuir información a otras personas en un formato que puedan entender.
• Porque necesitamos controlar la distribución de la información cuando la imprimamos.
• Porque necesitamos hacer cálculos y mostrarlos de forma legible.
• Porque precisamos obtener información de los datos para poder tomar decisiones.

La forma de añadir el informe a la aplicación dependerá de cómo se cree el informe. Como hemos visto, es necesario tener la definición del informe y un origen de datos para rellenarlo, sin embargo, podemos crearlo dentro de la aplicación o tenerlo en un archivo independiente e insertarlo después.

• Un informe incrustado es un informe que se ha importado al proyecto o que se ha creado directamente en él. Cuando se crea un informe incrustado en una aplicación, se crea una clase contenedora para el informe. Esta clase formará parte del proyecto. Cuando se importa o se crea el informe en el proyecto, se crea una clase contenedora, con el mismo nombre que el informe. Esta clase contiene, o representa, el informe en el proyecto. Cuando ocurre esto, todo el código del proyecto interactúa con la clase del informe que se ha creado para representarlo, en vez de hacerlo con el propio archivo de informe original.

  Al compilar el proyecto, tanto el informe como su clase contenedora se incrustan en el ensamblado, lo mismo que ocurriría con cualquier otro recurso del proyecto.

• Un informe no incrustado se ha generado con una herramienta específica aparte del proyecto y también se almacena independiente del proyecto. En este caso hay que planificar cómo se va a acceder y cargar el informe para interactuar con él. No existe una clase específica para manejar el informe. A un informe no incrustado siempre se obtiene acceso externamente y el SDK puede tener acceso a él de diversas formas:
  • El informe puede estar en la unidad de disco duro en una ruta de directorio de archivos.
  • El informe puede estar expuesto a través de un servicio web de informes.

  Nunca se importan informes no incrustados en el proyecto y, por lo tanto, nunca se crea ninguna clase contenedora de informe, a diferencia de los informes incrustados. En su lugar, se carga el informe no incrustado en tiempo de ejecución.

Los motores de informes permiten, mediante una interfaz gráfica de usuario determinar la posición, aspecto final, y configuración de los elementos que aparecen en el informe, generando automáticamente los ficheros con el diseño final. Hoy día existe gran cantidad de herramientas creadas para tal fin, tanto libres como propietarias, entre las que destacamos las siguientes:

Crystal Reports:

Es la solución para la generación de informes de la empresa SAP, Crystal Solutions. Esta herramienta propietaria viene integrada en Visual Studio .NET, aunque dispone de SDK's para el desarrollo de aplicaciones .NET, Java y DOM. Es compatible con gran variedad de orígenes de datos, desde motores de base de datos, a hojas de cálculo, archivos XML o SAP.

Los informes se almacenan en un archivo de tipo .rpt, que contiene información tanto del origen de datos como del diseño. Admite informes incrustados y no incrustados.

JasperReport + iReport:

Software libre perteneciente a JasperSoft. iReport genera archivos XML (con extensión jrxml) que contienen el diseño del informe, para generar el informe se compila este archivo en otro de extensión jasper y se rellena con el origen de datos. Tiene su propio lenguaje para la definición de expresiones llamado Groovi, aunque es compatible con Basic y Java.

La librería JasperReport permite combinar el diseño con el origen de datos para obtener el documento final mediante código Java.

Eclipse Birt:

BIRT son las siglas de Bussiness Inteligence Reporting Tools. Es un sistema de generación de informes para aplicaciones web, basadas en Java o en Java EE. Tiene dos componentes principales: un diseñador de informes basado en Eclipse y un componente que se puede agregar al servidor de aplicaciones y que genera informes en tiempo de ejecución. Ofrece un motor de gráficos y es compatible con gran cantidad de orígenes de datos, bien sea SGBD relacionales, archivos con formato, etc.

iReport es un diseñador de informes escrito por completo en Java, visual, intuitivo, pero muy potente. Lo distribuye la comunidad JasperForge de forma gratuita bajo licencia AGPL. Si quieres conocer los términos para esta licencia puedes hacerlo en su web:

Licencia AGPL.

iReport dispone de asistentes para la generación de informes, subinformes y plantillas, lo que facilita enormemente el trabajo del desarrollador, sin embargo, también permite la elaboración de informes partiendo desde cero.

Sea cual sea el procedimiento elegido, el objeto de usar una herramienta de diseño es reducir el coste de escribir todo el código necesario para obtener el informe, para ello, usaremos la librería de generación de informes JasperReports, que es una de las más usada en Java, y constituye el núcleo de iReport. Con esta librería, podremos enviar nuestros informes a un documento de texto, PDF, imagen o impresora. Se integra fácilmente en una aplicación java, aunque iReport se puede utilizar de manera independiente.

En resumen, iReport permite diseñar informes mientras que JasperReports ejecuta y genera los informes en una aplicación Java.

Al ejecutar iReport, vemos una interfaz parecida a la que aparece a continuación:

Inspector de informes: muestra la estructura completa del informe, que se compone de muchos objetos (tales como campos, parámetros y variables), bandas (que son las secciones del documento) y elementos (tales como campos de texto, imágenes o gráficos).

El diseñador de informes permite diseñar visualmente el informe de arrastrando, posicionando, alineando y cambiando el tamaño de los elementos del informe.

La paleta de elementos contiene los elementos de diseño que pueden ser arrastrados dentro de una banda para mostrar los datos. Para visualizarla hacemos clic en ventana >> paleta.

La hoja de propiedades se utiliza para establecer las propiedades del componente seleccionado en el informe (como un campo, elemento, banda, grupo, u otros).

La ventana de informe de problemas contiene el listado de los errores encontrados al compilar el informe.

Sobre el diseñador de informes está el selector del origen de datos (selector de conexión), que muestra la conexión activa que se utiliza para ejecutar el informe.

En la imagen se aprecia un informe vacío. A continuación, se detallan los aspectos estructurales más destacados de cada elemento: 

Título (Title): aparece sólo al inicio del informe. En esta sección se inserta el título del informe, por ejemplo "Informe de ventas del mes de marzo".

Encabezado de página (Page Header): aparece en la parte superior de cada página. Puede contener información como la fecha y hora, nombre de la organización, etc.

Encabezado de columna (Column Header): se utiliza para listar los nombres de los campos que se van a presentar (desplegar). Por ejemplo: "Producto", "Proveedor", "Precio de compra", "Precio de venta al público", "Beneficio", etc.

Detalle (Detail): En esta sección se despliegan los valores correspondientes a las entradas de campos definidas en la sección anterior. Por ejemplo: "Barra de cortina metálica. 3M", "Cofrilsa distribuidores, S.A.", "2,25", "4,99", "205,30".

Pie de columna (Column Footer): Puede presentar información resumida para cada uno de los campos. Por ejemplo: "Beneficio total del mes: 1245".

Pie de página (Page Footer): Aparece en la parte inferior de cada página. En esta parte podemos incluir, entre otras cosas, un contador de páginas, por ejemplo: "Página 1/7".

Resumen (Summary): Esta sección se usa para proporcionar información resumida de los campos presentes en la sección "detalle". Por ejemplo, para el caso del beneficio por producto se puede definir un objeto gráfico tipo "pie" para tener una mejor comparación y comprensión visual de los datos.

A cada uno de estos elementos estructurales se le denomina banda.

El proceso de creación de informes consta de los siguientes pasos principales:

1. Crear un origen de datos o una conexión al origen de datos utilizado para llenar el informe. Un origen de datos es cualquier fuente desde donde la herramienta pueda obtener el conjunto de registros con los que se rellenará el informe.
2. Crear el informe nuevo.
3. Seleccionar los datos que formarán parte del informe.
4. Diseñar el informe, incluyendo la disposición de sus elementos y parámetros para representar los datos.
5. Ejecutar el informe, a partir del archivo de origen se genera un archivo compilado y se rellena con los datos para la exportación o en pantalla.

En la siguiente presentación tienes un resumen gráfico de estos pasos para aprender a crear un informe a partir de una consulta sencilla.

Al generar la vista previa, iReport realiza una serie de operaciones para crear el informe final.

La primera operación consiste en compilar el archivo fuente, con extensión .jrxml en un archivo de Jasper, con extensión .jasper. Este primer paso puede fallar si los elementos no están colocados correctamente (por ejemplo, si un elemento se coloca fuera de una banda), o si una expresión en el informe tiene errores y no puede ser compilado.

Si la compilación se ejecuta correctamente, el archivo producido Jasper se carga y se llena con la conexión activa o fuente de datos. Esta segunda operación, otra vez puede conducir a errores, por ejemplo, si la base de datos se hace referencia no está activo, una consulta no válida se ha proporcionado, o en un campo nulo producido un error en una expresión durante el proceso de llenado. Finalmente, si todas las operaciones se completan sin errores, el informe se muestra en el visor integrado.

Los errores se muestran en la ventana de Información sobre problemas y resultados de la operación se muestran en la salida de iReport, los cuales comparten la parte inferior de la pantalla de iReport:

En concreto iReport gestiona esto desde el menú Vista previa (Preview), donde podemos seleccionar el formato final del informe.

Para generar de nuevo un informe que no se ha modificado, haga clic en ejecutar de nuevo en la barra de herramientas de vista previa. Una nueva ejecución de un informe es útil cuando un subinforme cambia, cuando cambia la fuente de datos, o cuando se desea ejecutar el informe con parámetros de entrada diferentes.

Para almacenar el resultado en un formato diferente al que aparece por defecto, por ejemplo, PDF debemos de pulsar el botón Guardar (Save) y elegir el formato de salida que queramos utilizar.

iReport es capaz de identificar el visor adecuado para cada formato automáticamente en función de los valores por defecto del sistema. Sin embargo, es posible ajustar manualmente la aplicación de visualización para cada formato, para hacerlo selecciona herramientas --> opciones--> iReport --> visualizadores (Viewers).

Efectivamente, Ana tiene razón. Un informe suele ser algo más que la presentación gráfica de los datos de una tabla de la base de datos. Lo habitual es realizar ciertas operaciones sobre el informe para obtener más información o mejor el formato de presentación, entre otras cosas veremos cómo:

• Hacer cálculos sobre los datos para mostrar información resumida, como promedios o sumas.
• Parametrizar el informe para que se pregunte al usuario que datos desea mostrar.
• Filtrar los datos.
• Aplicar encabezados y pies de página a las hojas del informe.
• Etc.

La utilidad de los parámetros en un informe es permitir generar diferentes resultados a partir de un mismo archivo de diseño, en función de un dato que podemos cambiar nosotros directamente o a través de la aplicación final.

Para administrar los parámetros, utilizamos el apartado Parameters del inspector de informe. Desde aquí es posible agregar y quitar parámetros utilizando el menú contextual. Podemos modificar un parámetro seleccionándolo y editando sus propiedades. Podemos modificar entre otras cosas:

• Name: nos permite asignar un nombre a un parámetro.
• Parameter class: lugar en donde ubicaremos la clase asociada al parámetro.
• Default Value Expression: valor predeterminado asociado al parámetro. Esta expresión es evaluada por JasperReports sólo cuando un valor para el parámetro no ha sido proporcionado por el usuario en tiempo de ejecución. Si el parámetro es de tipo String, el valor que introduzcamos debe de ir encerrado entre comillas.
• Use as prompt: activaremos esta opción cuando el valor del parámetro sea asignado durante el instante de tiempo en el cual se está generando el informe. En caso de no activarlo, el parámetro tendrá asignado el valor Default Value Expression.

Los parámetros se pueden clasificar en:

• Parámetros integrados están disponibles de forma predeterminada y contienen información en tiempo de ejecución. Algunos de los más importantes son REPORT_CONNECTION , que tiene la conexión JDBC para ejecutar la consulta SQL del informe (si el informe está lleno con una conexión JDBC), el REPORT_DATA_SOURCE que contiene, en su caso, la fuente de datos utilizada para llenar el informe, o el REPORT_LOCALE que contiene la configuración regional utilizada para rellenar el informe, y así sucesivamente. Los parámetros integrados no pueden ser modificados o eliminados. En cuanto al tipo de parámetro podemos encontrar:
• Parámetros de usuario: el programador determina su nombre, clase y valor. se pueden configurar para que sean insertados por el usuario cuando se ejecute el informe. Por ejemplo, vamos a crear un parámetro llamado ENCABEZADO_INFORME de tipo String con la propiedad "Use as prompt" activa. Si arrastramos el parámetro desde el inspector de informe a la banda título, iReport creará un campo de texto para mostrar el valor del parámetro. Por lo tanto, al generar el informe nos solicitará un valor para este parámetro que se visualizará como título del informe.

Uno de los usos más extendido de los parámetros es el filtrado de datos, que veremos a continuación.

Se pueden utilizar parámetros en las consultas SQL para filtrar los registros en la condición where o para añadir o sustituir elementos de la consulta SQL o incluso pasar toda la cadena SQL para ejecutar. Tenemos dos posibilidades:

1. En el primer caso los parámetros se utilizan como parámetros estándar SQL, por ejemplo:

select nombre, direccion from clientes where Ciudad = $P{nombre_ciudad}

En este ejemplo, nombre_ciudad es un parámetro de tipo java.lang.String (Text) que contiene el nombre de la ciudad debe seleccionar. Este parámetro se puede pasar al informe desde la aplicación que lo ejecuta para seleccionar sólo una ciudad específica.

El parámetro aquí es un verdadero parámetro SQL, lo que significa que la consulta se ejecutará mediante una sentencia como la siguiente:

select nombre, direccion from clientes where Ciudad = ?

y el valor del parámetro nombre_ciudad entonces pasa a la instrucción.

1. El segundo caso se trata de construcciones como:

SELECT * FROM clientes ORDER BY $P!{campos}

El parámetro será tratado como un campo de SQL. JasperReports tendrá en cuenta este parámetro como una especie de marcador de posición (ten en cuenta la sintaxis especial de $P!{}), que será reemplazado por el valor de texto del parámetro (que en este caso puede ser, por ejemplo, "Fecha_pedido DESC").

Con la misma lógica, una consulta puede pasarse íntegramente mediante un parámetro del siguiente modo:

$P!{mi_consulta}

El número de parámetros en una consulta es arbitrario. Al pasar un valor utilizando la sintaxis $P!{}, el valor del parámetro se toma tal cual, el usuario es responsable de la exactitud del valor pasado: la resolución de la sentencia SQL no se realiza por JasperReports en este caso.

Cuando se utilizan parámetros en una consulta, para que iReport pueda recuperar los campos disponibles de la consulta, se debe fijar un valor por defecto para el parámetro.

Podemos hacer cálculos usando variables. Podemos añadir y eliminar variables desde la zona variables del inspector de informe y la hoja de propiedades y, al igual que los parámetros, se definen por su nombre, clase y valor. Para editar una variable, se seleccione en el inspector de informe y modificamos la hoja de propiedades.

• Existen variables predefinidas que sirven para hacer recuentos de elementos propios del informe, como PAGE_NUMBER que contiene el número total de páginas, o el REPORT_COUNT que tiene el número de registros procesados en el momento, COLUMN_NUMBER que contiene el número de columnas, PAGE_COUNT que contiene el número de registros que han sido procesados por página. Este tipo de variables no pueden ser modificadas o eliminadas. 
• También se pueden crear variables de usuario, que sí pueden cambiar. Será el programador el encargado de asignar nombre (NAME), tipo de datos (VARIABLE CLASS) y valor inicial a la variable (INIT VALUE EXPRESSION).

Select nombre, count(id_pedido) as Npedidos from pedidos, clientes where pedidos.ID_Cliente = clientes.ID_Cliente group by pedidos.ID_Cliente

Comenzaremos creando un nuevo informe vacío. Modificaremos la consulta asociada al informe para introducir la consulta anterior. Para ello, podemos acceder al menú contextual sobre la opción report name que aparece en el panel Report Inspector.

Arrastraremos los campos Nombre y Npedidos a la banda de detalle, en la banda Column Header modificaremos las etiquetas de cada columna para indicar los textos Cliente y Número de pedidos, y a continuación, arrastramos el campo de NPedidos dentro de la banda Summary, iReport preguntará qué valor debe mostrar. Puede ser sólo el valor de NPedidos (que en esta banda será sólo el último valor asumido por el campo) o el resultado de una función de agregación, como la suma.

Selecciona la Suma (Sum) y pulsa Aceptar.

En la banda del título (Title) introduciremos una etiqueta (static text) con el texto NÚMERO DE PEDIDOS EFECTUADOS POR CADA CLIENTE. Podemos modificar el color del texto de la etiqueta y el fondo utilizando las propiedades ForeColor y Bakcolor junto con la propiedad Opaque.

Si pulsamos el botón Preview para visualizar el informe, nos aparecerá:

Para añadir la página X de Y en el pie de página de un informe, sólo tienes que arrastrar la herramienta página X de Y de la paleta en la banda PAGE_FOOTER Como se escribe Page en inglés, editamos la etiqueta y sustituimos la palabra "Page" por "Página".

Esta herramienta crea dos campos de texto que muestran la misma variable: PAGE_NUMBER. El campo de texto primero muestra la página actual, el segundo el total de páginas del informe. Esto es posible porque el tiempo de evaluación de cada campo de texto es diferente, en particular, el primer campo de texto tiene el tiempo de evaluación establecido a Now por lo que PAGE_NUMBER contiene el valor de la página actual, el segundo lo tiene establecido a Report (en este momento de evaluación, JasperReports ha llegado al final del informe, por lo que PAGE_NUMBER contiene el número de la última página).

El tiempo de evaluación de un campo de texto es muy importante porque nos permite imprimir el valor asumido por una variable en diferentes momentos. Con esta idea, podemos poner la suma total de pedidos, como se ve en el ejemplo anterior, y obtener el valor correcto estableciendo el tiempo de evaluación de ese campo de texto a Report (esto se hace automáticamente por iReport cuando un campo se arrastra a una banda y el usuario elige para mostrar el resultado de una función de agregación).

De igual manera podemos añadir etiquetas, imágenes a la banda PAGE_HEADER para modificar el encabezado de las páginas del informe, por ejemplo, podemos añadir una etiqueta en la que escribamos el nombre de la empresa y arrastrar la fecha (Current date) del apartado Tools de la paleta. Cuando colocamos el campo de fecha nos preguntará el formato en el que queremos que aparezca.

A veces puede ser necesario incluir el número de líneas en un informe. Para conseguirlo, usaremos una variable creada por el usuario, por ejemplo, podemos crear la variable NLineas. Para conseguir que cuente el número de línea para cada registro modificaremos las propiedades de la variable para hacer que sea de tipo entero (java.lang.Integer), en Calculation indicaremos que no haga nada (nothing), iniciaremos la variable a 0 (Init Value Expresion) y le asignaremos la expresión $V{REPORT_COUNT} (Value Expresion).

Para visualizar los números de línea arrastramos la variable a la banda de detalle, justo antes del país.

Es conveniente obtener los registros de la consulta de base bien ordenados, ya que la herramienta no va a hacer nada por ordenarlos, solo va a crear grupos cada vez que la expresión cambie.

Por ejemplo, si la expresión para el agrupamiento es la ciudad, cada vez que cambiemos de ciudad se genera un grupo nuevo, por lo que debemos obtener todos los registros ordenados por ciudad.

Cada grupo puede tener bandas de cabecera y pie de página. Los encabezados y pies de página del grupo se imprimen antes y después de la banda de detalle. Se puede definir un número arbitrario de grupos (es decir, podemos tener un grupo de primer nivel que contiene los pedidos entregados por ciudad y un grupo anidado que contiene los artículos de cada pedido), que se anidarán según se ordenen en el inspector del informe.

A continuación, veremos dos ejemplos de agrupamiento: uno cuya expresión es un campo de la consulta y otro cuyo agrupamiento es el resultado de una expresión.

El cálculo de subtotales implica hacer recuentos y cálculos resumidos (medias, porcentajes, mínimos o máximos) del conjunto de los datos que se representan en el informe, pero aplicando una categorización que lo divide en grupos. Se realiza el cálculo para cada grupo y luego para el conjunto de datos completo también.

Un ejemplo sencillo de creación de subtotales lo hemos visto en el apartado anterior, basta con añadir la variable al pie del grupo. No obstante, podemos hacer cálculos algo más complejos aprovechando las características de las variables. 

Supongamos, con respecto a la base de datos fabrica, que cada empresa que realiza pedidos a la fábrica puede tener varios teléfonos y emails de contactos. Por lo tanto, la base de datos fábrica almacena, para cada cliente, varios teléfonos y emails de contacto. Esta información la guarda en la tabla Teléfonos y Emails. 

Queremos realizar un informe representando la información del siguiente modo:

• Las zonas azules corresponden a los datos del contacto.
• Las zonas naranjas serán sus números de teléfono.
• Las zonas verdes serán para las direcciones de correo.

Crearemos un informe principal para los datos de las empresas clientes de la fábrica (zona azul) y después dos subinformes secundarios para los teléfonos y direcciones de correo de dichas empresas.

El informe principal se utilizará para seleccionar a los clientes. Crearemos un primer subinforme, para seleccionar las direcciones de correo electrónico asociadas a cada cliente, en la zona de color naranja. Por último, crearemos un segundo subinforme, para obtener los números de teléfono de cada empresa cliente (parte verde).

En los siguientes apartados de esta unidad vamos a ver cómo crear el informe principal y los dos informes secundarios.

Cuando se añaden imágenes a un informe, éstas no pasan a formar parte del mismo, sino que se añade una expresión con la ruta absoluta de la imagen, por eso, cuando se arrastra un elemento de imagen en el diseñador, iReport muestra un cuadro de diálogo selector de ficheros. Esta es la forma más conveniente de especificar una imagen que se va a usar en el informe. La expresión se establece como el valor de la propiedad Image Expression de la imagen. He aquí una expresión de ejemplo:

"c:\usuarios\alumno\Documentos\Imagenes\informes\flor.jpg".

Parametrizar la Imagen Image Expression:

Este sistema tiene un gran impacto en la portabilidad informe, ya que probablemente el archivo no se encuentre en otra máquina (es decir, después de implementar el informe en un servidor web o de ejecutar el informe en un equipo diferente). Para solucionar este problema podemos parametrizar la propiedad Image Expression de la imagen estableciendo su valor a algo similar a esto:

En tiempo de ejecución en una aplicación hipotética, el valor del parámetro directorio_de_imagenes se puede ajustar mediante la aplicación en sí misma. Podemos proporcionar un valor por defecto para el parámetro. La ventaja de esta solución es que la ubicación del directorio en el que están las imágenes no se define directamente en el informe, sino que se proporciona de forma dinámica.

$P{DIRECTORIO_DE_IMAGENES} + “miImagen.png” 

Usar el Classpath

Otra opción es utilizar el Classpath Cuando una imagen se encuentra en el Classpath, sólo se requiere el nombre de la imagen para encontrarla. De forma predeterminada, al ejecutar un informe, iReport agrega el directorio en el que reside el informe al Classpath. Si tenemos el informe y la imagen en el mismo directorio, basta con establecer el valor de Image Expression al nombre del fichero con la imagen. Puesto que el directorio del informe se agrega a la ruta de clases, la imagen se encuentra de forma automática.

Este proceso sigue siendo válido si la imagen se encuentra en un subdirectorio de un directorio incluido en el Classpath. En ese caso, se deberá especificar la ruta completa del recurso.

Existen distintos tipos de gráficos, entre los que destacan:

• Gráficos lineales: se representan los valores en dos ejes cartesianos ortogonales entre sí. Las gráficas lineales se recomiendan para representar series en el tiempo, y es donde se muestran valores máximos y mínimos; también se utilizan para varias muestras en un diagrama.
• Gráficos de barras: contienen barras verticales que representan valores numéricos. Normalmente representan frecuencias dentro de una categoría.
• Gráficos circulares: permite ver la distribución interna de los datos que representan un hecho, en forma de porcentajes sobre un total. Se suele separar el sector correspondiente al mayor o menor valor, según lo que se desee destacar.
• Gráfico simbólico: con imágenes que sirven para representar el comportamiento o la distribución de los datos cuantitativos de una población, utilizando símbolos de tamaño proporcional al dato representado.

Cuando trabajamos con gráficos, conviene aclarar los conceptos de serie y categoría:

• Serie: Es el conjunto de datos numéricos a representar. Podemos tener más de una serie en un gráfico, salvo en los gráficos circulares que sólo tienen una serie. A cada serie se le asigna un color diferente o algún otro identificativo que aparece claramente señalado en la leyenda del gráfico. Cada dato de la serie toma valores en un rango, por lo que si queremos tener más de una serie en el gráfico es conveniente que todas estén dentro del mismo rango.
• Categoría: Se corresponde con los datos a representar dentro del eje horizontal de gráfico. Cada dato de la serie toma valores para un dato de la categoría.

Los gráficos se pueden insertar en cualquier banda de nuestro informe, pero lo más lógico y habitual es insertarlo en la banda de resumen (Summary)

En la imagen anterior puede verse un ejemplo, vemos un gráfico con una serie, Pedidos por año, que toma valores en el rango de cero a cuatrocientos y cuya categoría está formada por tres elementos correspondientes a los años 1996, 1997 y 1998. Representa la evolución de los pedidos por año.

En el siguiente apartado, vamos a ver un ejemplo de cómo construir un gráfico con JasperReport. 

A veces es preciso involucrar varias tablas en la consulta para generar un informe, incluyendo uniones, ordenación y agrupaciones. El resultado final es independiente de lo compleja que pueda ser la consulta, ya que una vez que hayamos obtenido los registros, pero para facilitar el proceso de crear la consulta podemos utilizar alguna herramienta visual. iReport, por ejemplo, proporciona un diseñador de consultas (query designer), accesible desde la ventana de la consulta que puede acceder a la estructura completa de la base de datos para hacer la selección de tablas y campos de manera gráfica.

• En la zona de la izquierda abajo aparece la lista de las tablas de la base de datos seleccionando las opciones Public y Tables. Podemos desplegar una tabla en el panel de la derecha haciendo doble clic sobre su nombre. Los campos que se marquen se añadirán a la consulta.
• Haciendo clic con el botón secundario sobre la cláusula WHERE y seleccionando add condition podemos añadir condiciones.
• De igual forma se añaden cláusulas HAVING.
• Para añadir cláusulas GROUP BY u ORDER BY hacemos clic con el botón secundario sobre el campo que va a participar en la cláusula y seleccionamos add to group by o add to order by.
• Cualquier cláusula se elimina haciendo clic con el botón secundario, seleccionando la opción remove.

La librería JasperReports permite la integración de los informes en una aplicación Java. Es posible hacerlo partiendo tanto del archivo .jasper como del archivo .jrxml. Se utiliza para compilar, rellenar, aplicar parámetros y visualizar un informe en diferentes formatos finales. La ventaja es que como podemos pasar parámetros mediante código, basta con conectar el informe a un formulario y el usuario final podrá determinar las características finales del informe o de los datos a mostrar.

Para pasar parámetros a un informe es necesario, en primer lugar, tener definido el parámetro en el informe con el tipo adecuado. En el código crearemos una tabla hash a la que añadiremos una pareja formada por el nombre del parámetro y la variable que contiene su valor. Una Hashtable Java es una estructura de datos que utiliza una función hash para identificar datos mediante una llave o clave

El despliegue del informe se hace a través de un objeto de la clase JasperPrint y la clase JasperFillManager. Para crearlo usaremos esta sentencia:

JasperPrint print = JasperFillManager.fillReport(ArchivoJasper, Parámetros, Conexion);

Donde:

• ArchivoJasper: es el archivo de Jasper con el informe.
• Parámetros: tabla hash con los parámetros que hay que pasar al informe.
• Conexión: conexión al origen de datos.

JasperFillManager.fillReport genera el informe en memoria. Para volcar el informe a un archivo, utilizamos la clase JasperExportManager, que tiene varios métodos para crear archivos de salida de diferentes tipos, entre otros podremos generar un archivo PDF con el informe con el siguiente código:

JasperExportManager.exportReportToPdfFile(print, "informe.pdf");

Antes de comenzar es preciso que instales y configures NetBeans para poder usar el complemento de JasperReport, si no lo has hecho ya, como veíamos al principio de la unidad y que inicies el servidor MySQL con la base de datos Fabrica que hemos venido utilizando en los ejemplos anteriores.

En el proyecto que crees debes añadir las librerías:

Driver MySql JDBC: para incluirla accede al panel proyectos, pulsas el botón derecho del ratón (menú contextual) y seleccionas la opción Agregar Biblioteca. Lo buscamos en la lista que nos aparece y pulsamos Añadir librería (Add Library).

Spring Framework 4.0.1: repetimos el proceso anterior y seleccionamos dicho valor en la lista.

JasperReport 6.11: repetimos el proceso de la misma forma que hicimos con el Driver de MySQL y Spring Framework.

Incluiremos los siguientes ficheros .jar a nuestra Biblioteca. Accedemos, de nuevo, al menú contextual sobre Bibliotecas y seleccionamos Añadir ficheros jar /carpeta. Debemos de incluir los siguientes ficheros jar: commons-beanutils-1.8.2.jar, commons-collections4-4.4.jar, commons-digester-2.1.jar, commons-logging-1.1.2.jar, itext-2.1.7.jar, joda-time-2.4.jar, jollyday-0.4.9.jar.

Todos estos ficheros los puedes descargar desde el siguiente enlace: Conjunto de ficheros jars necesarios para el ejemplo.

Lo que pretendemos con este ejemplo, es desde una aplicación Java, construir un informe en formato PDF. Es decir, al ejecutar la aplicación vamos a crear un nuevo fichero, en formato PDF, que contendrá el informe.

Vamos a utilizar el informe PedidosCiudad.jrxml, que creamos de ejemplo durante el desarrollo de esta unidad. Vamos a duplicarlo y le vamos a cambiar el nombre para que se llame PedidosCiudadParametro.jrxml. Este informe muestra los pedidos que se han recibido de cada ciudad. Lo vamos a modificar para que reciba un parámetro, que será el año del cual queremos consultar los pedidos. Por lo tanto, obtendremos un informe de los pedidos que se han recibido agrupados por ciudad durante el año indicado.

Utilizando este fichero, accederemos al panel Report Inspector para definir el parámetro año. Las propiedades asociadas a este parámetro son:

Name: año

Parameter Class: java.lang.Integer

Default Value Expression:0. (Lo inicializamos con el valor cero.)

SELECT ciudad, id_pedido, fecha_pedido FROM
                    clientes, pedidos where clientes.ID_Cliente = pedidos.ID_Cliente 
                    and year(fecha_pedido)=$P{año}
                    order by ciudad

A continuación, procedemos a modificar el diseño del informe para introducir las etiquetas (static text) para agregar los títulos Número de pedido, Fecha de pedido y Total pedidos. También agregaremos, en la banda Title, el texto AÑO, utilizando una etiqueta (static label) y el valor del parámetro año.

El diseño del informe tiene que quedar de la siguiente forma:

Una vez creado correctamente el informe, procederemos a utilizarlo desde una aplicación en Java. Para ello, vamos agregar a nuestro proyecto un nuevo fichero java, denominado PedidosAnio.java, que contendrá las instrucciones necesarias para establecer una conexión con la base de datos, obtener los datos para crear el informe y crear el fichero PDF en donde se guardará el informe.

import java.awt.Desktop;
            import java.io.File;
            import java.sql.Connection;
            import java.sql.DriverManager;
            import java.sql.SQLException;
            import javax.swing.*;
            import java.util.HashMap;
            import java.util.Map;
            import net.sf.jasperreports.engine.*;
            public class PedidosAnio {
            public static Connection conexion = null;
            String baseDatos = "jdbc:mysql://localhost/fabrica";
            String usuario = "root";
            String clave = "";
            public PedidosAnio(){
            try{
            Class.forName("com.mysql.jdbc.Driver").newInstance();
            conexion = DriverManager.getConnection(baseDatos,usuario,clave);
            }
            catch (ClassNotFoundException cnfe){
            System.err.println("Fallo al cargar JDBC");
            System.exit(1);
            }
            catch (SQLException sqle){
            System.err.println("No se pudo conectar a BD");
            System.exit(1);
            }
            catch (java.lang.InstantiationException sqlex){
            System.err.println("Imposible Conectar");
            System.exit(1);
            }
            catch (Exception ex){
            System.err.println("Imposible Conectar");
            System.exit(1);
            }
            }
            //El método ejecutar recibe el parametro del informe
            public void ejecutar(int año) 
            {
            //Ruta del informe respecto del proyecto NetBeans
            String archivojasper="PedidosCiudadParametro.jasper";
            try
            {
            //Cargamos los parametros del informe en una tabla Hash
            Map parametros = new HashMap();
            parametros.put("año",año);
            //Generamos el informe en memoria
            JasperPrint print = JasperFillManager.fillReport(archivojasper, parametros, conexion);
            // Exporta el informe a PDF 
            JasperExportManager.exportReportToPdfFile(print, "informe.pdf");
            //Abre el archivo PDF generado
            File path = new File ("informe.pdf");
            Desktop.getDesktop().open(path);
            }
            catch(Exception e)
            {
            JOptionPane.showMessageDialog(null,e.toString(),"Error",JOptionPane.WARNING_MESSAGE);
            }
            }
            }
            

Con este código estamos utilizando el informe PedidosCiudadParametro.jasper para generar el informe. El fichero resultante de la ejecución del código se almacenará en un fichero llamado informe.pdf

A continuación, vamos a crear un nuevo fichero, llamado EjemploDI05.java, donde tendremos definido el método main con este código:

public static void main(String[] args) {
            PedidosAnio informe = new PedidosAnio();
            int anio=2019;//Valor que se va a pasar para que lo recoja el parámetro
            informe.ejecutar(anio);
            }

Si ejecutamos la aplicación, se nos generará el fichero informe.pdf, cuyo contenido es:

Si creamos un formulario para seleccionar el año mediante un campo de texto o lista desplegable y ejecutamos el formulario desde un botón tendremos una aplicación gráfica para generar nuestro informe parametrizado.

Los informes de iReport se almacenan en archivos XML con extensión .jrxml. Un archivo jrxml se compone de un conjunto de secciones, algunas de ellas relativas a las características físicas del informe, como las dimensiones de la página, el posicionamiento de los campos, y la altura de las bandas, otras son relativas a las características lógicas, tales como la declaración de los parámetros y variables, y la definición de una consulta para la selección de datos.

Al hacer clic en el botón de vista previa en la barra de herramientas de diseño, iReport realiza una serie de operaciones para crear el informe final. La primera operación consiste en compilar el archivo fuente jrxml en un archivo de Jasper. Esta compilación se realiza por motivos de rendimiento. Si la compilación se ejecuta correctamente, el archivo producido Jasper se carga y se llena con la conexión activa o fuente de datos.

Durante la compilación del archivo jrxml, el archivo XML se analiza y se carga en un objeto JasperDesign, una estructura de datos que permite representar el contenido XML en la memoria. Independientemente del lenguaje que se utiliza para las expresiones dentro del archivo jrxml, JasperReports crea una clase especial de Java que representa la totalidad del informe, se compila, se instancia y se serializa en un archivo Jasper, que será el que se cargue en una aplicación posteriormente.

A la hora de ejecutar un informe necesitaremos este archivo de Jasper y una fuente de datos para JasperReports. Hay muchos tipos de fuentes de datos, es posible llenar un archivo de Jasper de una consulta SQL, un archivo XML, un archivo CSV, una colección de JavaBeans, etc., incluso es posible elaborar una fuente de datos personalizada. Con un archivo de Jasper y un origen de datos, JasperReports es capaz de generar el documento final en el formato que prefiera.

El archivo Jasper no contiene recursos externos, como puedan ser las imágenes utilizadas en el informe, paquetes de recursos para ejecutar el informe en diferentes idiomas, scriptlets extra u hojas de estilos externas. Todos estos recursos deben estar ubicados en tiempo de ejecución y ser proporcionados por la aplicación, como veremos a continuación.