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

...