Ireport Tutorial

  • Published on
    05-Dec-2014

  • View
    109

  • Download
    2

Embed Size (px)

Transcript

Tutorial Herramienta de diseo iReport

www.ste.es

IReport Tutorial

1

INDICE1 Gua Bsica de Configuracin de iReport ................................................................... 2 1.1 1.2 1.3 2 Introduccin............................................................................................................. 2 Configuracin del classpath..................................................................................... 3 DTD de JasperReport.............................................................................................. 4

Como Generar Plantillas de Informes.......................................................................... 5 2.1 Introduccin............................................................................................................. 5 2.2 Crear un Informe, paso a paso ................................................................................ 5 2.3 Explicacin de cada banda. ..................................................................................... 6 2.4 Parmetros ($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 Imgenes. ............................................................................................................. 16 2.10 Grupos. ................................................................................................................. 17 2.11 Subinformes. ......................................................................................................... 17 2.11.1 Informe Principal. ........................................................................................... 17 2.11.2 Subinforme. ................................................................................................... 24 2.11.3 Juntndolo todo. ............................................................................................ 25 2.12 Paginar un informe. ............................................................................................... 26 2.13 Compilar un informe. ............................................................................................. 28

3

Ajustes por Desbordamiento ..................................................................................... 29 3.1 3.2 3.3 3.4 Sntomas del problema.......................................................................................... 29 Para qu sirve el ajuste por desbordamiento?..................................................... 29 A qu se debe el problema? Qu es lo que lo origina? ..................................... 29 Cmo solucionar el problema ................................................................................ 29

Document1

IReport Tutorial

2

1

Gua Bsica de Configuracin de iReport1.1 Introduccin

iReport es una herramienta visual que sirve para generar ficheros XML (plantillas de informe) que se puedan utilizar con la herramienta de generacin de informes JasperReports. iReport inicialmente se ha desarrollado en J++ por lo que su entorno de ejecucin se limita a plataformas Microsoft. En sus ltimas versiones se ha publicado una versin 100% java con lo cual se limita la restriccin existente. Este manual explica cmo configurar iReport para poder generar tanto ficheros XML (plantillas base para JasperReport), como ficheros .jasper (plantillas compiladas). -

Document1

IReport Tutorial

3

1.2

Configuracin 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 dilogo como ste:

Segn se indica en la web de iReport, la configuracin de la versin actual sigue los siguientes pasos:

Document1

IReport Tutorial

4

1 2 3

Seleccionar la entrada classpath del menu Database Completar el MS JVM para los drivers JDBC 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 validacin de las plantillas XML que genera iReport (jasperprint.dtd y jasperreport.dtd). Por omisin, iReport coloca una url del DTD con una direccin 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 operacin de validacin falla. Esto es especialmente importante para cuando colguemos las plantillas generadas en el servidor WebLogic, ya que es muy posible que la mquina 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 debern copiarse a la ubicacin accesible mediante la url especificada en la propiedad DTD_HOME.

Document1

IReport Tutorial

5

2

Como Generar Plantillas de Informes2.1 Introduccin

Este captulo trata de explicar cmo generar plantillas para crear informes. Hace un pequeo recorrido por los diferentes elementos y opciones de la herramienta iReport para explicar cules son sus cometidos y sus funciones. Es un tutorial eminentemente prctico pensado para una persona con conocimientos tcnicos a nivel de desarrollo con tecnologa 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 dilogo :

Figura 1 Cuadro de dilogo 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 Tamao de la pgina: Normalmente A4 Hay que entrar en la pestaa Ms. Ah aparece Codificacin XML. Se debe poner ISO-8859-1. Eso hace que se puedan escribir y no de error. Despus 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.

Document1

IReport Tutorial

6

2.3

Explicacin 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 pgina. Lo que se define es el aspecto general de una pgina y no se pueden definir (a priori) elementos fuera del tamao de la pgina. El significado de cada banda es el siguiente: Title : Esta banda se mostrar slo una vez al principio del informe tenga las pginas que tenga el mismo. PageHeader : Esta banda es la cabecera de la pgina; se repite cada vez que se pinta una pgina nueva. ColumnHeader : Esta banda es la cabecera de las columnas. Inicialmente nosotros hemos definido slo una columna, por lo que su comportamiento es anlogo a PageHeader. Detail : Esta banda es la encargada de mostrar los elementos que tienen alguna repeticin, estos elementos se mostrarn en los subinformes que explicaremos ms adelante. En esta banda solo se deben insertar los subinformes, ya que los mismos son los encargados de hacer las repeticiones.

Document1

IReport Tutorial

7

ColumnFooter : ColumnHeader.

Pie de la

columna.

Su comportamiento es anlogo a

PageFooter : Pie de pgina, se repite una vez por pgina. Su comportamiento es anlogo a PageHeader. Sumary : Slo se repite una vez por informe en la ltima pgina del mismo. Su comportamiento es anlogo a Title.

2.4

Parmetros ($p) .

Los parmetros se usan para definir la aparicin o no de textos o para mostrar algn valor concreto que no se pasa como campo($F). Cuando los parmetros se usan para mostrar o no un texto, tiene un valor true o false, porque tanto los parmetros como los campos ($P y $F respectivamente) se pasan como textos (strings). Para introducir los parmetros se pulsa sobre y aparece este cuadro de dilogo:

Figura 3 Cuadro de dilogo de parmetros

Document1

IReport Tutorial

8

Para aadir un parmetro ($P), se pulsa sobre Nuevo y aparece otro cuadro de dilogo:

Nombre de parmetro: Nombre que se quiere dar al parmetro. A partir de ahora, cuando en el proyecto te quieras referir a dicho parmetro, lo nombrars como $P{nombre parmetro}. Tipo de java.lang.String parmetro: Siempre

Expresin del valor por defecto: Si se quiere un valor por defecto, aqu se escribe como una cadena de texto, entrecomillado. Ej.: true Descripcin de parmetro: Si se quiere una descripcin del