Tutorial Herramienta de

diseño iReport

www.ste.es
IReport Tutorial
1

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

52350486.doc
IReport Tutorial
2

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).

52350486.doc
IReport Tutorial
3

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:

52350486.doc
IReport Tutorial
4

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.

52350486.doc
IReport Tutorial
5

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.

52350486.doc
IReport Tutorial
6

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.

52350486.doc
IReport Tutorial
7

 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

52350486.doc
IReport Tutorial
8

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:

52350486.doc
IReport Tutorial
9

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

52350486.doc
IReport Tutorial
10

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

52350486.doc
IReport Tutorial
11

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,

aquí se dice cual.

“Reset type”: Aquí se decide cuándo

quiere evaluarse la variable

“Reset group”: Aquí se decide el grupo

(se debe definir con anterioridad)

Figura 8 Cuadro de diálogo de añadir variable

“Expresión” y “Valor inicial de expresión”: aquí se escribe una expresión. Haciendo clic
al botón derecho aparece un cuadro de diálogo que es el “Editor de expresiones”.

52350486.doc
IReport Tutorial
12

Figura 9 Editor de expresiones

En este editor se pueden crear expresiones “complejas” del tipo “si A=2 entonces X sino Y”.
Este “Editor de expresiones” puede abrirse desde cualquier área de texto donde se pueda
escribir un $F, un $V o un $P.

52350486.doc
IReport Tutorial
13

2.7 Elementos de Texto

Sólo guardan texto. Se usarán cuando se quiera poner un texto largo que como mucho se
pueda elegir mostrarlo o no dependiendo del $P asociado a él.

Se pulsa sobre el icono

Se coloca en la banda en la que se quiera mostrar y se hace doble click sobre él. Aparece el
siguiente cuadro de diálogo:

Figura 10 Cuadro de diálogo de elemento de texto

En la pestaña “Texto Estático” escribe el texto (sin comillas, ya que iReport sabe que sólo
puedes escribir texto).

En la caja “Imprime cuando sea verdadera la expresión”, hay que poner una expresión de
tipo booleano: “new Boolean ($P{nombre_parámetro})” (sin comillas), sabiendo que $P vale
“true” o “false”. Esa expresión puede ser compleja usando tanto && (and) como || (or).

52350486.doc
IReport Tutorial
14

2.8 Elementos de Datos

Se usarán para mostrar los $F, $P y $V que previamente se han definido.

Se pulsa sobre el icono

Se coloca en la banda en la que se quiera mostrar y se hace doble click sobre él. Aparece el
siguiente cuadro de diálogo:

Figura 11 Cuadro de diálogo de elementos de datos. Pestaña Comunes

En la caja “Imprime cuando sea verdadera la expresión”, hay que poner una expresión de
tipo booleano: “new Boolean($F{CAMPO} != null)” (sin comillas). Esa expresión puede ser
compleja usando tanto && (and) como || (or).
En “Posición” se puede decidir si la posición del elemento será fija o por el contrario
flotante, con lo que se moverá según se hagan más o menos grandes los elementos que le
preceden.
Las demás opciones de esta pestaña son intuitivas, menos la de “Imprimir cuando cambie
el grupo”, que se explicará al mismo tiempo que los grupos.

52350486.doc
IReport Tutorial
15

Si se pulsa sobre la siguiente pestaña “Campos de texto”, aparece el siguiente cuadro de

diálogo:

Figura 12 Cuadro de diálogo de elementos de datos. Pestaña Campos de Texto

En “Expresión del Campo de Texto” se introduce el texto que se quiere mostrar y se le

concatena (+) el campo asociado a dicho texto.
Del resto de las opciones de la pantalla es reseñable el “Ajuste en desbordamiento”. Esta
opción no funciona correctamente si en la anterior pantalla se ha definido la posición como
“float”.
La pestaña “Propiedades Texto” sirve para definir los textos
La pestaña “Hiperenlace” permite crear un hiperenlace asociado tanto a una página web
como a un ancla dentro del propio documento. Esta opción no será usada apenas porque el
fin último de casi todos los informes es la impresión en papel.

52350486.doc
IReport Tutorial
16

2.9 Imágenes.
Todas las imágenes necesarias para las plantillas se encuentran en un mismo directorio en
un sistema de ficheros T3. Esa ruta ya está fijada dentro de Jasper, por lo que cuando
desde la plantilla se quiera introducir una imagen los pasos a seguir son los siguientes:
Dejar el fichero de imagen en “T3/modulos/plantillas/imagenes”
Escribir en el elemento de imagen de la plantilla en la casilla “Expresión de imagen” el
nombre del fichero con su extensión.
Por ahora, si se introducen imágenes en el informe éste sigue compilando, pero el “Viewer”
de Jasper falla por lo que no se puede mostrar, así que lo lógico será hacer las plantillas sin
imágenes, compilarlas y más tarde añadir las imágenes cuando se quiere ver el resultado
final.
Se pulsa sobre el icono

Se coloca en la banda en la que se quiera mostrar y se hace doble click sobre él. Aparece el
siguiente cuadro de diálogo:

”Expresión de Imagen”: Se
escribe el nombre del fichero
con su extensión .

Figura 13 Cuadro de diálogo de propiedades de imagen

52350486.doc
IReport Tutorial
17

2.10 Grupos.
Actualmente este recurso de iReport sólo se usa para hacer que los subinformes funcionen
tal como nosotros queremos en cada informe. La explicación del funcionamiento de los
grupos va asociada al funcionamiento de los subinformes por lo que serán explicados junto
con los mismos.

2.11 Subinformes.
Se usarán sólo cuando se quieran mostrar “n” ocurrencias de varios campos agrupados de
alguna forma determinada.
Hasta ahora hemos visto un informe como un fichero XML que guarda la información
necesaria para crear el mismo.
Ahora con los subinformes hay que cambiar ligeramente ese punto de vista. Si un informe es
lo suficientemente complejo para tener varios grupos de repetición, por ejemplo un
demandante al que se le quieren mostrar todos los idiomas que habla con sus características
(grupo1) y todos los trabajos que ha realizado con sus fechas de alta y baja en los mismos
(grupo2), hay que usar subinformes.
Un subinforme no es más que otro fichero XML asociado al fichero XML principal y que
comparte todos o parte de sus datos.
Tanto el informe como el/los subinforme/s se deben definir de un modo determinado para
que cumplan unos requisitos predeterminados por Jasper.
Primero vamos a enumerar los requisitos que debe cumplir el XML principal. Para hacer más
entendible la explicación vamos a seguir el proceso de creación del informe antes
mencionado.
2.11.1 Informe Principal.
En el informe principal se crearán tantos grupos como subinformes se necesiten. En este
caso serán 2, uno para idiomas y otro para ocupaciones.
Para crear el grupo se opera del siguiente modo:
Se pulsa sobre el icono y aparece el cuadro de diálogo:

Figura 14 Cuadro de diálogo de grupos

52350486.doc
IReport Tutorial
18

Se pulsa sobre el botón “New” y aparece este otro cuadro de diálogo:

Figura 15 Cuadro de diálogo de configuración de grupos

”Nombre del grupo”: Nombre significativo para reconocer el grupo (por ejemplo Idiomas u
Ocupaciones)
“Expresión del grupo”: aquí se escribe literalmente “$V{REPORT_COUNT}” (sin las
comillas). Esto hace que se generen correctamente los saltos de página dentro del informe.
“Altura de la banda cabecera”: En esta casilla se debe poner una altura suficiente como
para meter el elemento de subinforme (Por ejemplo 20)
“Altura de la banda pie”: Inicialmente la pondremos a 0 porque no vamos a utilizarla.

El resto de las opciones deben quedar si chequear excepto “Empieza en nueva página” si lo
que queremos es que cada grupo empiece en una página nueva (eso dependerá de la
colocación que se quiera en cada informe).

52350486.doc
IReport Tutorial
19

Una vez tengamos creado el grupo, éste aparecerá en nuestra pantalla del siguiente modo:

Figura 16 Pantalla con el grupo de idiomas

Ahora tenemos que crear un elemento de subinforme dentro de ese grupo al que
posteriormente le asociaremos un fichero XML con el subinforme apropiado.

52350486.doc
IReport Tutorial
20

Se pulsa sobre el icono

Se coloca en la banda de cabecera del grupo y se hace doble click sobre él. Aparece el
siguiente cuadro de diálogo:

Figura 17 Cuadro de diálogo de propiedades de subinforme 1

Se define en “Expresión de la conexión /Fuente de Datos” el parámetro del sistema

“$P{REPORT_DATA_SOURCE}” (sin comillas) que hace que se le pase al subinforme el
objeto DataSource completo (todos los campos) que hemos definido para el informe
principal.

52350486.doc
IReport Tutorial
21

Pulsando sobre la pestaña “Sub informe 2” aparece:

Figura 18 Cuadro de diálogo de propiedades de subinforme 2

En “Expresión del subinforme” se escribe la ruta donde está el subinforme compilado

(.jasper), ya que un subinforme no es más que un informe pre-compilado que se alimenta del
contenido del informe de llamada.

52350486.doc
IReport Tutorial
22

Si se quieren pasar parámetros a un subinforme, se pulsa sobre el botón derecho en el

cuadro de “Parámetros del subinforme” y aparece el siguiente cuadro de diálogo:

“Nombre” : Nombre que se dará al

parámetro en el subinforme

“Expresión” : Valor del parámetro. Este

valor puede ser una expresión y si pulsas en
el botón derecho puedes abrir el “Editor de
expresiones”.

Figura 19 Cuadro de diálogo de parámetros de subinfome

52350486.doc
IReport Tutorial
23

Después de hacer esto, el aspecto de la pantalla será el siguiente:

Figura 20 Pantalla con el subinforme de idiomas

52350486.doc
IReport Tutorial
24

Repitiendo el proceso de nuevo para el segundo grupo y su subinforme (ocupaciones) el

aspecto final del informe principal sería el siguiente:

Figura 21 Pantalla con el subinforme de idiomas y el subinforme de ocupaciones

Como se puede apreciar, hemos eliminado la banda de detalle porque el detalle lo va a hacer
el subinforme y por lo tanto ya no es necesaria.

2.11.2 Subinforme.
Un subinforme no es más que un informe normal pero que toma todos sus datos de otro
informe y es llamado desde él.
Jasper sólo puede tener asociado un fichero fuente (XML) a la hora de la generación del
informe, por lo que todos los ficheros de subinformes deberán estar pre-compilados (.jasper)
para que Jasper los entienda.

El fichero XML en el que definamos el subinforme debe llamarse igual que el fichero “.jasper”
que hemos definido en la llamada al subinforme desde el informe principal. En el caso de
idiomas el fichero se llamará “datos_idiomas.XML”. Cuando compilemos este fichero se

52350486.doc
IReport Tutorial
25

generará el fichero “datos_idiomas.jasper” que será el que utilizaremos para que Jasper
genere el informe.

Hacemos el subinforme de la forma normal, pero teniendo en cuenta lo siguiente:

 Cuando definimos el tamaño del informe, el ancho del mismo a de ser el mismo que
el ancho del elemento “subreport” que hemos pintado en la pantalla del informe
principal.
 Hay que ponerle todos los márgenes a 0, ya que los márgenes ya los tiene el informe
principal.
 No se debe paginar. De eso se tiene que encargar el informe principal.
 Los elementos que queramos que se repitan tienen que ir en la banda de detalle.

2.11.3 Juntándolo todo.

Ahora solo queda generar los ficheros “.jasper” para que los pueda usar el informe principal.
Para eso, lo primero que tenemos que hacer es compilar nuestro fichero XML (en nuestro
caso “datos_idiomas.xml”) para generar el fichero “.jasper” (en nuestro caso
“datos_idiomas.jasper”).
Una vez compilado, se copia el fichero jasper a la ruta que previamente se a definido en el
elemento de subreport dentro del informe principal.
Este proceso lo haremos tantas veces como subinformes tengamos definidos (en nuestro
caso dos).

52350486.doc
IReport Tutorial
26

2.12 Paginar un informe.

Normalmente utilizaremos la banda del pie de página, aunque también se puede utilizar la
cabecera de la página ya que esas dos bandas se repiten una vez por página.
Primero definimos un elemento de campo “Field Tool” y en “Expresión del Campo de
Texto“ escribimos “Página “ + String.valueOf($V{PAGE_NUMBER}) + “ de “.
El “Momento de evaluación” es muy importante ya que decide en qué momento se tiene
que pintar el valor de la variable asociada. En este caso debemos seleccionar “Now” para
que nos indique en que página nos llegamos en ese momento.

Figura 22 Cuadro de diálogo de creación de paginación I

Con esto ya tenemos la primera parte del paginado.

Ahora nos falta la segunda parte, que es saber cuántas páginas va a tener nuestro informe.
Para eso, operamos de igual manera que la vez anterior:
A continuación del primer elemento de campo, definimos un segundo elemento. Y en la
“Expresión del Campo de Texto“ escribimos:
““ “ + String.valueOf($V{PAGE_NUMBER})”

52350486.doc
IReport Tutorial
27

Pero esta vez “Momento de Evaluación” ha de ser “Report”, lo que hace que esa variable
se escriba una vez terminado el informe, con lo que contendrá el número de páginas del
mismo.

Figura 23 Cuadro de diálogo de creación de paginación y II

El resultado final para la página 3 de nuestro informe de 10 páginas será:

“Página 3 de 10”.

52350486.doc
IReport Tutorial
28

2.13 Compilar un informe.

Se pulsa sobre el icono

Aparece el cuadro de diálogo siguiente:

Figura 24 Cuadro de diálogo de compilación de informe

Aquí se puede elegir si sólo se quiere compilar (generar el .jasper) o además se quiere pasar
el informe a algún formato determinado (leer la lista desplegando la caja de selección).
Tanto el fichero “.jasper” (sólo compilar), como los ficheros de exportación se guardan en el
mismo directorio en el que esté la plantilla del informe (.XML).

52350486.doc
IReport Tutorial
29

3 Ajustes por Desbordamiento

3.1 Síntomas del problema
El denominado "Problema de ajuste por desbordamiento" se detecta cuando al generar un
informe se produce un "corte" del texto a mostrar y ese "corte" está en relación con un
campo de texto con el atributo de ajuste por desbordamiento activo.
Visto desde el XML asociado a la plantilla de informe es el siguiente código:
<textField isStretchWithOverflow="true" ...>
...
</textField>
Otro síntoma de que hay este problema es que al rellenar el informe el sistema (servidor de
aplicaciones) entra en un bucle infinito (parece como que se queda "bloqueado") del que o
bien tarda en salir con una excepción de agotamiento de memoria o bien el servidor acaba
cerrándose él solo.
Cuando se constata este síntoma hay que aplicar la "segunda etapa" del tratamiento
obligatoriamente (ver punto “como solucionar el problema”)

3.2 ¿Para qué sirve el ajuste por desbordamiento?

Esta opción se utiliza cuando se tienen campos de texto en los que a priori no se conoce cual
es su tamaño vertical o altura.
Es decir, que al asignar el valor al campo cuando se rellena el informe, el tamaño de aquel
puede ser más grande que el asignado inicialmente en tiempo de diseño (ejemplo típico es el
que ocupe varias líneas).

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

El problema está en los cálculos que se realizan en el proceso de "layout" del informe
(cuando se está rellenando).
Se utilizan propiedades de objetos "Font" (fuente de letra) para asignar espacio a los textos
que se escriben en el informe, estando acotado el espacio usable a las dimensiones de la
plantilla y de las bandas de ésta.
Además, la combinación de dos distintas máquinas virtuales Java (en el servidor se utiliza
Java 1.3 y en el cliente Java 1.4), cuando entre ambas hay diferencia de unidades de medida
en cuanto a dimensiones de objetos gráficos (y las fuentes lo son :) junto con un "bug" (o
como dirían otros, "funcionalidad") de "iReport", que omite un información crucial en las
plantillas generadas a partir de él, hace que en algunas situaciones se produzca el terrible
problema del malfuncionamiento del ajuste por desbordamiento.

3.4 Cómo solucionar el problema

Hay dos etapas distintas que nos permiten solucionar este problema.
Si con la primera etapa se soluciona no va a ser necesario ir a la segunda.

52350486.doc
IReport Tutorial
30

1. Primera etapa:
Aplicable cuando se producen los cortes de texto.
Editar la plantilla de informe con la herramienta "iReport" versión 1.00 (1) ó superior. Y
guardarla. Es decir, la abres y la guardas (sobrescribiéndola)
(1) => A partir de esta versión de "iReport" se ha corregido la "funcionalidad" que omitía
cierta información que afectaba directamente a que se produjese el problema.

2. Segunda etapa:
Aplicable cuando el sistema entra en estado de bucle infinito.
Si estamos aquí, es que el informe tiene complejidad añadida.
Posiblemente la situación está en que el ajuste que se está realizando (el aumento de
tamaño vertical) no es suficiente para los datos que se están utilizando en el relleno del
informe.
Para solucionarlo hay que editar la plantilla (con "iReport" versión 1.00 o superior o
directamente el XML con un editor) y aumentar el parámetro de altura del campo de
texto.
Visto desde el XML asociado a la plantilla de informe es el siguiente código:
<textField isStretchWithOverflow="true" height="18" ...>
...
</textField>

Una manera de calcular qué altura (height) indicar es utilizar la siguiente fórmula:
• tdl = tamaño de letra. Se corresponde con al atributo "size" de la etiqueta “<font>" el
campo de texto.

Ejemplo: <font fontName="Helvetica" pdfFontName="Helvetica" size="8"...>

• nafot = número aproximado de filas que se espera que ocupe el texto.

• CB = Cte.. Su valor es 2 :

altura (height) = (tdl * nafot) + CB

52350486.doc
IReport Tutorial
31

Por ejemplo, si esperamos que haya tres líneas de texto como máximo y nuestro
tamaño de letra es 8, la altura sería:
altura = (8 * 3) + 2 = 26
Importante: esta fórmula da una estimación del valor a utilizar (). En caso de que el
valor resultante no fuese suficiente hay que incrementarlo.

52350486.doc