Reportes Netbeans y Ireport

REPORTES UTILIZANDO NETBEANS, IREPORTS Y JASPER REPORTS.

Creando reporte de toda una tabla

Para la realización de esta guía tomaremos de base el mantenimiento por asistente creado anteriormente, es necesario para esta guía tambien tener encendidos los servicios de Oracle, además será necesario el plugin de iReports para netbeans. Para esta guía se usara la version 3.6.1 que tiene el nombre  “iReport-nb-3.6.1.nbm”  y serán necesarias las siguientes librerías:

• jasperreports-2.0.3.jar
• commons-logging-1.0.2.jar
• commons-javaflow-20060411.jar
• commons-digester-1.7.jar
• commons-collections-2.1.jar
• commons-beanutils-1.7.jar
• iText-2.1.7.jar

La de jasperreport nos servirá para compilar y ejecutar el reporte, las demás son necesarias para la ejecución y  algunas nos servirán para los formatos en que se puede guardar el reporte por ejemplo PDF, DOCX, etc.

Instalar el plugin.[pic 1]

Lo primero que haremos será instalar el plugin de iReports en Netbeans para esto vamos al menú herramientas > Complementos esto nos abrirá la ventana complementos que contiene 5 fichas elegimos la ficha descargado y luego damos clic en el botón agregar complementos…

[pic 2]

[pic 3]

debemos buscar el archivo de extensión .nbm que corresponde al plugin que queremos instalar este caso “iReport-nb-3.6.1.nbm” y luego damos clic en Abrir

Ya encontrado el archivo nos mostrara el plugin, un poco de información en la parte derecha y el botón instalar en la parte inferior, damos clic y el abrirá un asistente para la instalación.

[pic 4]

[pic 5]

Ahora solo resta esperar que termine el proceso de instalación, podría darnos una advertencia (Esto no representa ningún problema en el futuro) en la instalación, le damos que lo instale de todas formas.

Para comprobar que se realizo con éxito la instalación en la ficha instalado, buscamos en la categoría Tools ó Herramientas el nombre del plugin es ireport-designer y el estado debe ser activo.

[pic 6]

[pic 7]

Ahora en netbeans se ven varios cambios en la interface por ejemplo en la parte superior, mostrara  las fuentes de datos para reportes, en la parte izquierda debe mostrar el inspector de reportes y en la parte inferior de la pantalla aparecerá iReport output.[pic 8]

Agregando nuevas fuentes de datos para reportes.

En la parte superior vemos que aparece inicialmente Empty datasource, damos clic en el icono [pic 9] que aparece al lado y nos mostrara un formulario donde podemos elegir el tipo de fuente de datos, como previamente en la parte de prestaciones > bases de datos se había configurado una conexión con la base de datos que tiene el nombre de su carnet, utilizaremos la opción que dice NetBeans Database JDBC connection, si lo que necesitaramos fuera usar una nueva conexión usaríamos la primer opción. Luego damos clic en Next >.[pic 10]

El siguiente paso consiste en darle un nombre a la nueva conexión que estamos configurando en este caso le pusimos “PRUEBA ALUMNOS”, y elegimos una conexión de la cual para este caso elegiremos la de oracle que habíamos configurado previamente, con el esquema de nuestro CARNET,  después damos clic en Test, si todo esta bien nos mostrara un mensaje confirmando que si hay conexión, y luego damos clic en aceptar al dialogo abierto y Save a la nueva conexión.[pic 11][pic 12]

Podemos verificar en la parte superior de la pantalla ya aparece la nueva fuente de datos que configuramos.

[pic 13]

Agregando un nuevo reporte a nuestro proyecto

Como dijimos previamente utilizaremos el proyecto del mantenimiento creado por asistente para agregar nuestro reporte, damos clic derecho al proyecto y agregaremos un nuevo elemento, luego damos clic en otro.

[pic 14]

Nos abrirá una interfaz donde debe estar elegido como proyecto el que estemos trabajando en este caso es ALUMNOS,  en la parte de categoría elegimos Report y en tipo de archivos elegiremos Empty report, es decir un reporte vacio.

[pic 15]

Después le damos un nombre que en esta guía es Reportealumnos y damos clic en Terminar.

[pic 16]

Nos mostrara el archivo Reportealumnos.jrxml y el iReport nos permitirá hacer diseñar nuestro reporte, también es de notar que en la parte izquierda en la paleta se encuentran algunos controles que son especiales para usar con los reportes nada mas.

En la vista de diseño(Designer)  por defecto nos aparece el reporte dividido en varias zonas, pero solo usaremos 4 de ellas que son Title, Page Header, Detail y Page Footer. Para eliminar las zonas restantes damos clic derecho sobre ellas y  seleccionamos Delete Band, si por accidente borramos una zona, o queremos agregar alguna en la parte de Report Inspector ubicado en la parte dercha podemos agregarla, la buscamos damos clic derecho encima y luego Add Band.

[pic 17]

Con esto ya tenemos listo nuestro reporte en blanco pero ahora debemos arrastrar los campos que deseamos que contenga, como lo que necesitamos se encuentra en una base de datos ya previamente habíamos configurado una fuente de datos para reportes, pues debemos tener cuidado que este seleccionada.[pic 18]

Nos vamos al Report Inspector y damos clic derecho y luego en Edit Query, esto nos permitirá abrir un asistente para consultas utilizando el lenguaje sql.[pic 19]

Luego escribimos la consulta que necesitamos en este caso lo que queremos es los datos de todas las columnas, de todas las filas de la tabla alumno que ya habíamos creado.

Para eso escribimos la siguiente consulta select * from alumno  y en la parte inferior nos devuelve las columnas y su correspondiente equivalencia de tipo de dato.

[pic 20]

Damos clic en Ok y pasaremos a diseñar el contenido de nuestro reporte.

[pic 21]

Para poder realizar el diseño de nuestro reporte nos auxiliaremos de el Report Inspector y de la Paleta.

En el  Report Inspector desplegamos el Menu Fields ahí nos mostrara los campos de las Columnas de la consulta que hicimos en el paso anterior, para evitar tener problemas con los tipos de datos de oracle y su equivalencias solo debemos  arrastrar y soltar en el reporte los campos que necesitamos en este caso los 4 campos CARNET, NOMBRE, APELLIDO Y SEXO .

[pic 22]

Ahora bien necesitamos además agregar algunas etiquetas y título, utilizamos el elemento Text Field de la paleta, para poder realizar esto, debemos arrastrar y soltar donde lo necesitemos el control, para cambiar el contenido damos doble clic y escribimos el texto que necesitemos, si queremos hacer algun cambio al formato nos podemos auxiliar de las propiedades y buscamos la configuración que queramos cambiar. Además agregaremos de la categoría Tools 3 elementos Page number, Page X of Y y Current date, el primero nos mostrara el numero de pagina, el segundo la pagina actual y el total de páginas y el ultimo la fecha y hora en que se genero el reporte, cuando se suelta la herramienta current date nos permitirá elegir el formato en que deseamos mostrar la fecha y hora.

El reporte debe quedar de la siguiente forma:

Banda Title: Titulo del reporte, para el ejemplo Reporte Alumnos.

Banda Page Header: de la paleta arrastramos text fields para poner los encabezados de las columnas, estos se repetirán en todas las paginas al estar en esta banda.

Banda detail: aquí arrastraremos del Report Inspector > Fields las columnas que serán generadas por la consulta, las colocamos debajo de las etiquetas de sus repectivas columnas.

Banda Page Footer: aquí pondremos las tools de la paleta, de fecha, pagina x de y y numero de pagina.

NOTA: 

• El texto de PAGE X of Y debemos sustituirlo por "Pagina "+$V{PAGE_NUMBER}+" de" " para poder tener el texto en español.[pic 23]
• Con respecto a la fecha el formato que se utilizo para la realización de esta guía es dd/MM/yyyy h.mm a, esto se configura al arrastrar el botón abre una ventana de dialogo, si se quiere cambiar despues, se selecciona el control, vamos a las propiedades y se modifica el parámetro llamado Pattern. 

El reporte después de agregarle todos los campos necesarios debería quedar de la siguiente manera.

[pic 24]

Damos clic en preview para poder ver como quedaría nuestro reporte. Si nos diera algún error relacionado con la disponibilidad de la conexión, nos vamos a prestaciones y nos aseguramos de que este la conexión con la base establecida, y si persiste el problema cerramos y abrimos de nuevo la conexión a la base de datos esto siempre desde la parte de prestaciones.

[pic 25]

Hasta este punto hemos diseñado nuestro reporte. Y ya tenemos 2 archivos que deben estar en la carpeta de nuestro proyecto que debería ser el CARNET, de los archivos el primero es Reportealumnos.jrxml que es donde esta el diseño del reporte y además se ha creado el archivo Reportealumnos.jasper este archivo es el que ejecutaremos desde nuestra aplicación. Utilizaremos el jasper viewer para visualizar el reporte y necesitamos agregar al proyecto las librerías mencionadas al principio, esto lo hacemos dando clic derecho en bibliotecas y le seleccionamos agregar archivo JAR/Carpeta… y buscamos los archivos en la ubicación que los tengamos.

...