Saltar la navegación

3.5.- Creación de un informe sencillo.

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.

Utilizando el proyecto que hemos configurado en el apartado anterior, para el cual ya tenemos configurado el acceso a la base de datos, vamos a ver cómo construir un informe sencillo.

Agregaremos un nuevo fichero a nuestro proyecto que utilizaremos para crear el informe. Para ello, en NetBeans, seleccionamos Archivo --> Archivo Nuevo --> Categorías, seleccionamos Report --> ReportWizard.

Ilustración de una captura de pantalla del asistente para crear el informe
Montaña Martín Vergel (Elaboración propia)

Podemos ver que existen diferentes formatos predefinidos que podemos utilizar, En nuestro caso, vamos a proceder a crear un informe vacío. Para ello, seleccionamos Blank A4 y pulsamos Siguiente.

Ilustración de una captura de pantalla de los diferentes tipos de proyectos que podemos seleccionar cuando creamos un proyecto
Montaña Martín Vergel (Elaboración propia)

A continuación, introducimos el nombre que va a tener nuestro fichero dentro del proyecto. Por ejemplo, podemos asignarle el nombre "Informe.jrxml". Podemos indicar en que carpeta podemos almacenar el fichero, el nombre del proyecto en donde queremos crearlo y la ruta absoluta del fichero que se va a crear.

Ilustración en donde se muestra el diseñador de consulta.
Montaña Martín Vergel (Elaboración propia)

A continuación, seleccionamos la conexión que queremos utilizar, que en nuestro caso se denomina "Conexión MySQL" e introduciremos la orden SQL que utilizaremos para recuperar los datos que se van a presentar en el informe. En nuestro caso vamos a realizar una consulta a la base de datos para recuperar el nombre de nuestro cliente junto con la ciudad en la que se encuentran. Para ello, escribiríamos la orden SQLSelect Nombre, Ciudad from clientes

También podemos utilizar un asistente para crear o diseñar la consulta que queramos realizar contra la base de datos. Para ello, pulsaremos la opción Design Query. Al seleccionarlo, deberemos de introducir la contraseña del usuario que definimos en la configuración de la conexión en el caso de que no marcáramos la opción de guardar contraseña.

A continuación, podemos indicar que campos queremos que aparezcan en el informe. A pulsar Siguiente, podemos agrupar la información que queremos mostrar. De esta manera podemos clasificar los resultados obtenidos a la hora de presentarlos en el informe. Para finalizar el diseño del informe, pulsaremos Terminar.

Llegado este momento, ya tenemos creado el informe vacío y configurado para que pueda recuperar la información que vamos a presentar en el informe. Para finalizar, la creación del informe, deberemos de indicar que información queremos que se nos muestre en el informe. Para ello, podemos utilizar el panel Report Inspector para diseñar el informe. A través de este panel, podemos seleccionar los elementos que queramos que aparezcan en el informe. Para ello, solo hay que seleccionarlo y arrastrarlo hacía la parte del informe en donde queramos que se muestren.

Dentro del panel Report Inspector, podemos acceder al apartado Fields, en donde se nos mostrará los campos que definimos en la configuración de la consulta a la base de datos. Estos campos deberemos de incluirlos dentro de cada banda del informe en donde queramos que se muestre.

Captura de pantalla de los campos que podemos seleccionar para que aparezcan en el informe
Montaña Martín Vergel (Elaboración propia)

Cuando el objeto de campo se arrastra dentro de la banda de detalle, se crea un elemento de campo de texto y establece el campo de texto la expresión de ese elemento a $F{Nombre_Campo}. Esta es una expresión simple para imprimir el valor del campo Nombre_Campo. 

Ilustración de la paleta Reports Elements.
Montaña Martín Vergel (Elaboración propia)

Para añadir otros elementos (tales como líneas o etiquetas), arrástralos desde la Paleta Reports Elements en la vista del diseñador para, a continuación, cambiar el tamaño y organizarlos como desee.

Desde la ventana de Propiedades se podrán modificar en su aspecto (color, tipo de fuente, tamaño, etc).

En este caso, añadimos una etiqueta en la banda de título para el título del informe, se añade etiquetas de las columnas con elementos de la etiqueta colocada en la banda de cabecera de la columna, y colocamos una fina línea justo debajo de los campos de texto en la banda de detalle.

Por último, cambiamos el tamaño de algunas bandas y eliminamos los demás mediante el establecimiento de una su altura a 0. Cambiaremos la altura de una banda arrastrando su borde inferior. Una forma directa para reducir la altura de la banda es hacer doble clic en su borde inferior, esto se establece en el borde inferior de su elemento más bajo.

Para ver el resultado del informe que hemos creado solo hay que pulsar el botón PreviewAl pulsar este botón, se compila primero el fichero fuente jrxml. Si la compilación es correcta, el archivo producido se carga y se llena con la conexión activa.

Captura del diseño del informe.
Montaña Martín Vergel (Elaboración propia)

Ejercicio resuelto

Crea un informe de tipo listado por cada una de las tablas de la base de datos que hemos utilizado en el ejemplo anterior. Añade diferentes elementos de la paleta y modifica las propiedades de campos y objetos para mejorar el diseño. Ejecuta los informes y exporta su contenido a archivos PDF y a hojas de cálculo.