PDF de programación - Capac JasperReports

UNIVERSIDAD DE EL SALVADOR

ADACAD

JasperReports

Elaborado por:

Rudy Chicas

Jefe de ADACAD

Ciudad Universitaria, diciembre de 2010

Indice de contenido

INTRODUCCION..........................................................................................................................i
INSTALACION DE PLUGIN iReport PARA NetBeans................................................................1
ORIGENES DE DATOS..............................................................................................................1
Conexiones JDBC...................................................................................................................3
JavaBeans..............................................................................................................................8
ESTRUCTURA DE REPORTES...............................................................................................15
ELEMENTOS INTERNOS DE UN REPORTE..........................................................................16
Styles....................................................................................................................................17
Parameters...........................................................................................................................17
Fields.....................................................................................................................................19
Variables...............................................................................................................................19
Scriplets................................................................................................................................20
Bandas..................................................................................................................................21
DISEÑO DE REPORTES..........................................................................................................21
Elementos de reportes..........................................................................................................21
Construyendo el reporte.......................................................................................................23
Manejo de Grupo..................................................................................................................35
IMPLEMENTACION DE REPORTES EN APLICACION JSF...................................................45
Configuración de los servlets................................................................................................45
Clases para el soporte de reportes......................................................................................47
Clase de implementación de Reporte..................................................................................50
Integrando con la vista..........................................................................................................51
BIBLIOGRAFIA.........................................................................................................................53

INTRODUCCION
iReport es la interfaz de usuario más frecuentemente utilizada para el uso de las librerías
JasperReports. JasperReports es una herramienta para la creación de informes en Java, que permite
la adición de contenido enriquecido a los informes.

iReport permite crear los archivos fuentes de los reportes, y compilarlos para crear un archivo de
extensión .jasper. Estos archivos son los que se utilizan para la implementación de los reportes en las
aplicaciones Java.

i

INSTALACION DE PLUGIN iReport PARA NetBeans
El plugin de iReport para NetBeans puede ser descargado en la siguiente dirección:

http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=4425

Para realizar la instalación hay que seguir la forma típica para instalar un plugin en NetBeans.

ORIGENES DE DATOS
Tanto el IDE tradicional de iReport como el plugin de iReport para NetBeans permiten la configuración
de varios orígenes de datos.

Los orígenes de datos que pueden ser usados con reportes JasperReports son:

• Conexiones JDBC

•

•

JavaBeans

XML

• CSV

• Hibernate connection

•

•

Spring-loaded Hibernate connection

Proveedor de origen de datos JasperReports

• Orígenes de datos personalizados

• Conexión LDAP Mondrian

• Conexión XML/A

•

EJBQL Connection

• Origen de datos vacío

En este documento nos centraremos en el estudio de las conexiones JDBC y los orígenes de datos
JavaBeans.

Los orígenes de datos sirven para tener acceso a un conjunto de datos en tiempo de diseño de los
reportes, y no significa que al ser configurado para el diseño del reporte, estará disponible en tiempo
de ejecución.

Para definir un origen de datos es necesario hacer clic sobre el botón de configuración. La siguiente
figura muestra el botón de configuración de orígenes de datos en una instalación en NetBeans.

1

2

Conexiones JDBC
Los orígenes de datos del tipo JDBC son conexiones directas a la base de datos que estarán
disponibles en tiempo de diseño.

Para definir una conexión JDBC se debe acceder al editor de orígenes de datos de iReport, y
seleccionar la opción Database JDBC connection.

Al hacer clic en el botón Next aparecerá la interfaz de configuración de la conexión.

3

En este interfaz habrá que especificar el nombre de la conexión, el driver JDBC a utilizar, el URL de la
conexión, el nombre de usuario de la base con la que nos queremos conectar y el password.

4

Para probar la conexión, podemos usar el botón Test. Se nos pedirá que confirmemos la clave del
usuario, y si no hay errores, el sistema nos enviará un mensaje de éxito de la conexión.
Posteriormente podemos guardar los datos de la conexión.

5

Para especificar qué datos se usarán en el reporte, es necesario especificar una consulta para el
reporte (Report Query). La consulta del reporte puede ser de cualquiera de los tipos de orígenes de
datos soportados.

Para las conexiones JDBC la consulta del reporte es una consulta SQL a la base de datos, como se
muestra en la siguiente figura.

6

Al escribir la consulta, iReport retorna los campos especificados en la sentencia SQL y sus tipos de
datos. Es también posible hacer una revisión de los datos en la base de datos haciendo clic en el
botón Refresh Preview Data.

7

JavaBeans
Los orígenes de datos del tipo JavaBeans set Datasource son orígenes de datos basados en clases
Java que retornarán una colección (Collection) o arreglo (Array) de objetos de una clase Java que
contiene los datos que necesitamos mostrar en el reporte.

Aunque no es indispensable, si deseamos contar con un conjunto de datos que nos sirva para realizar
pruebas del reporte en tiempo de diseño, deberemos especificar una clase que genere dichos datos.
Esta clase no será parte de nuestra aplicación, por lo que debemos escribirla en un paquete separado
del resto.

Como ejemplo, se muestra la clase CarrerasDataSourceDesing, que se encuentra en el paquete
reportdesing.

8

Lista de código 3.2.1: Clase CarrerasDataSourceDesing, origen de datos para el diseño del reporte.

/*
* To change this template, choose Tools | Templates
* and open the template in the editor.
*/

package reportdesing;

import control.CarrerasBean;
import java.util.ArrayList;
import java.util.Collection;

/**
*
* @author rchicas
*/
public class CarrerasDataSourceDesing {
public static Collection getCarreras(){
ArrayList carreras = new ArrayList();

for(int i=0;i<=10;i++){
CarrerasBean carrera = new CarrerasBean();

carrera.setCodigo("ABC" + i);
carrera.setIdCarrera(i);
carrera.setMaxInscribir(5);
carrera.setNombre("Nombre Carrera" + i);
carrera.setPlanEstudios("Plan"+i);
carrera.setTotalUV(48+i);

carreras.add(carrera);
}

return carreras;
}
}

Adicionalmente es necesario especificar el método estático que devolverá la colección o el arreglo de
objetos, que en este caso es llamado getCarreras.

9

Para acceder a la clase y su método, iReport requiere de la configuración de Classpath, en el que se
debe especificar la ruta donde se encuentra las clases a las que se está haciendo referencia. Si
utilizamos el plugin de NetBeans, para configurar el Classpath es necesario ir al menú Opciones
(Options), seleccionar iReport y la pestaña Classpath.

10

Si iReport puede acceder a la clase y su método, al presionar el botón Test mostrará un mensaje de
éxito.

Para utilizar este tipo de orígenes de datos, se debe especificar la clase de los objetos que nos
devolverá el método especificado, en este caso getCarreras. En otras palabras, el método
getCarreras devuelve una colección de objetos del tipo CarrerasBean, por lo que la clase que se
especifique en la consulta del reporte debe ser del tipo CarrerasBean.

11

En la interfaz en la que se especifica la consulta del reporte, se debe seleccionar los atributos de la
clase que formarán parte de nuestro reporte. Esto se hace seleccionando los atributos de la clase y
haciendo clic en el botón Add selected field. Estos serán los campos que estarán disponibles en el
reporte como campos (fields).

12

Si deseamos ver los datos de prueba hacemos clic en el botón Refresh Preview Data, lo que
ejecutará el método getCarreras y devolverá la colección de objetos.

13

Puede observarse que los datos que devuelve la vista previa son los datos que se generan en el
método getCarreras, no los que se encuentran en la base de datos, puesto que no se está usando
una conexión a la base.

La configuración de la clase que generará la colección de datos es opcional, ya que su único objetivo
es poner a nuestra disposición un conjunto de datos para la vista preliminar del reporte.

En caso de optar por no crear dich