Jasper Reports

INDICE

1 Guía Básica de Configuración de iReport 2

1.1 Introducción 2

1.2 Configuración del classpath 3

1.3 DTD de JasperReport 4

2 Como Generar Plantillas de Informes 5

2.1 Introducción 5

2.2 Crear un Informe, paso a paso 5

2.3 Explicación de cada banda. 6

2.4 Parámetros ($p) . 7

2.5 Campos ($F). 8

2.6 Variables ($V). 10

2.7 Elementos de Texto 13

2.8 Elementos de Datos 14

2.9 Imágenes. 16

2.10 Grupos. 17

2.11 Subinformes. 17

2.11.1 Informe Principal. 17

2.11.2 Subinforme. 24

2.11.3 Juntándolo todo. 25

2.12 Paginar un informe. 26

2.13 Compilar un informe. 28

3 Ajustes por Desbordamiento 29

3.1 Síntomas del problema 29

3.2 ¿Para qué sirve el ajuste por desbordamiento? 29

3.3 ¿A qué se debe el problema? ¿Qué es lo que lo origina? 29

3.4 Cómo solucionar el problema 29

1 Guía Básica de Configuración de iReport

1.1 Introducción

iReport es una herramienta visual que sirve para generar ficheros XML (plantillas de informe) que se puedan utilizar con la herramienta de generación de informes JasperReports.

iReport inicialmente se ha desarrollado en J++ por lo que su entorno de ejecución se limita a plataformas Microsoft. En sus últimas versiones se ha publicado una versión 100% java con lo cual se limita la restricción existente.

Este manual explica cómo configurar iReport para poder generar tanto ficheros XML (plantillas base para JasperReport), como ficheros “.jasper” (plantillas compiladas).

-

1.2 Configuración del classpath

Antes de poder trabajar con iReport hay que configurar sus variables de classpath para conseguir compilaciones de las plantillas con éxito.

Para configurar el classpath seleccionamos el menú “Entorno -> Classpath...”

Aparece un cuadro de diálogo como éste:

Según se indica en la web de iReport, la configuración de la versión actual sigue los siguientes pasos:

1 Seleccionar la entrada classpath del menu Database

2 Completar el MS JVM para los drivers JDBC

3 Completar el Java VM classpath para los drivers JDBC, tools.jar y ficheros jar de JasperReports: (los ficheros que indica el ejemplo son)

X:\path\to\jasperreports-0.4.2-project\JasperReports\lib\commons-beanutils.jar

X:\path\to\jasperreports-0.4.2-project\JasperReports\lib\commons-collections.jar

X:\path\to\jasperreports-0.4.2-project\JasperReports\lib\commons-digester.jar

X:\path\to\jasperreports-0.4.2-project\JasperReports\lib\itext-0.92.jar

X:\path\to\jasperreports-0.4.2-project\JasperReports\lib\jasperreports.jar

X:\path\to\jasperreports-0.4.2-project\JasperReports\lib\xerces.jar

4 Set Java home

1.3 DTD de JasperReport

En la carpeta “dtds” se incluyen dos ficheros DTD necesarios para la validación de las plantillas XML que genera iReport (“jasperprint.dtd” y “jasperreport.dtd”).

Por omisión, iReport coloca una url del DTD con una dirección de Internet. Al parsear la plantilla desde JasperReport, esta herramienta intenta acceder a la url (Internet) para validar la plantilla. En caso de que no pueda acceder la operación de validación falla. Esto es especialmente importante para cuando colguemos las plantillas generadas en el servidor WebLogic, ya que es muy posible que la máquina donde está instalado el servidor Weblogic no tenga acceso a Internet.

Lo que se pretende con la propiedad DTD_HOME del punto anterior es especificar una url local que evite el salir a Internet para validar una plantilla XML.

Los dos ficheros DTD deberán copiarse a la ubicación accesible mediante la url especificada en la propiedad DTD_HOME.

2 Como Generar Plantillas de Informes

2.1 Introducción

Este capítulo trata de explicar cómo generar plantillas para crear informes. Hace un pequeño recorrido por los diferentes elementos y opciones de la herramienta iReport para explicar cuáles son sus cometidos y sus funciones.

Es un tutorial eminentemente práctico pensado para una persona con conocimientos técnicos a nivel de desarrollo con tecnología XML y Java, así como cierta desenvoltura en el manejo de editores

2.2 Crear un Informe, paso a paso

Menú Informes -> Nuevo

Aparece un cuadro de diálogo :

Figura 1 Cuadro de diálogo de crear nueva plantilla de informe

“Nombre del informe”: Nombre interno que va a tener el informe en iReport. Debe coincidir con el nombre del fichero XML

“Tamaño de la página”: Normalmente A4

Hay que entrar en la pestaña “Más…”. Ahí aparece “Codificación XML”. Se debe poner ISO-8859-1. Eso hace que se puedan escribir “ñ” y no de error.

Después de pulsar “OK”, es buena idea guardar el informe y ya se crea el “.XML” con el mismo nombre que has puesto antes en el informe.

2.3 Explicación de cada banda.

Cuando has pulsado OK, se ha creado una pantalla como la que se muestra en la figura.

Figura 2 Bandas del informe

En ella aparecen marcadas diferentes áreas que llamaremos a partir de ahora “bandas”.

Cada banda se comporta de un modo diferente.

Hay que pensar que un informe de iReport está pensado a nivel de página. Lo que se define es el aspecto general de una página y no se pueden definir (a priori) elementos fuera del tamaño de la página.

El significado de cada banda es el siguiente:

 Title : Esta banda se mostrará sólo una vez al principio del informe tenga las páginas que tenga el mismo.

 PageHeader : Esta banda es la cabecera de la página; se repite cada vez que se pinta una página nueva.

 ColumnHeader : Esta banda es la cabecera de las columnas. Inicialmente nosotros hemos definido sólo una columna, por lo que su comportamiento es análogo a PageHeader.

 Detail : Esta banda es la encargada de mostrar los elementos que tienen alguna repetición, estos elementos se mostrarán en los subinformes que explicaremos más adelante. En esta banda solo se deben insertar los subinformes, ya que los mismos son los encargados de hacer las repeticiones.

 ColumnFooter : Pie de la columna. Su comportamiento es análogo a ColumnHeader.

 PageFooter : Pie de página, se repite una vez por página. Su comportamiento es análogo a PageHeader.

 Sumary : Sólo se repite una vez por informe en la última página del mismo. Su comportamiento es análogo a Title.

2.4 Parámetros ($p) .

Los parámetros se usan para definir la aparición o no de textos o para mostrar algún valor concreto que no se pasa como campo($F).

Cuando los parámetros se usan para mostrar o no un texto, tiene un valor “true” o “false”, porque tanto los parámetros como los campos ($P y $F respectivamente) se pasan como textos (strings).

Para introducir los parámetros se pulsa sobre y aparece este cuadro de diálogo:

Figura 3 Cuadro de diálogo de parámetros

Para añadir un parámetro ($P), se pulsa sobre “Nuevo” y aparece otro cuadro de diálogo:

“Nombre de parámetro”: Nombre que se quiere dar al parámetro. A partir de ahora, cuando en el proyecto te quieras referir a dicho parámetro, lo nombrarás como $P{nombre parámetro}.

“Tipo de parámetro”: Siempre java.lang.String

“Expresión del valor por defecto”: Si se quiere un valor por defecto, aquí se escribe como una cadena de texto, entrecomillado. Ej.: ”true”

“Descripción de parámetro”: Si se quiere una descripción del parámetro.

Figura 4 Cuadro de diálogo de propiedades de parámetros

2.5 Campos ($F).

Siempre se van a definir como datos de tipo texto.

Serán los campos que se recuperen de la base de datos y se pasen en un objeto DataSource que entienda Jasper.

Para introducir los campos se pulsa sobre y aparece este cuadro de diálogo:

Figura 5 Cuadro de diálogo de campos

Para añadir un campo ($F), se pulsa sobre “Nuevo” y aparece otro cuadro de diálogo:

“Nombre del Campo”: Nombre que se quiere dar al campo. A partir de ahora, cuando en el proyecto te quieras referir a dicho campo, lo nombraras como $F{nombre campo}.

“Tipo de campo”: Siempre java.lang.String

“Descripción del campo”: Si se quiere una descripción del campo.

Figura 6 Cuadro de diálogo de propiedades de campo

2.6 Variables ($V).

Se utilizan para hacer cálculos dentro del informe, como por ejemplo calcular una suma de campos o un paginado.

Para introducir una variable se pulsa sobre y aparece este cuadro de diálogo:

Figura 7 Cuadro de diálogo de variables

Para añadir una variable, se pulsa sobre “Nueva” y aparece otro cuadro de diálogo:

“Nombre de variable”: Nombre que se quiere dar. A partir de ahora, cuando en el proyecto te quieras referir a dicha variable, la nombraras como $V{nombre variable}.

“Tipo de variable”: Depende de la salida que genere

“Cálculo”: Si se quiere hacer un cálculo,

...