1.

INTRODUCCIÓN 2

1.1. CARACTERÍSTICAS DE IREPORT 2

1.2. INSTALACIÓN DE IREPORT 2

2. CONFIGURACIÓN DE IREPORT 6

3. MI PRIMER INFORME 9

3.1 CREAR UN INFORME 9

3.2 PARTES DE UN INFORME 9
3.3 PARÁMETROS ($P) 10
3.4 VARIABLES ($V) 11
3.5 CAMPOS ($F) 12
3.6 CONSULTAS 12

4. AGRUPACIÓN 16

5. SUBINFORMES 19

5.1 CREAR EL INFORME PADRE 19

5.2 CREAR EL INFORME HIJO 19
5.3 INTEGRACIÓN DE LOS INFORMES 20

6. INFORMES CON CÓDIGO HTML 23

7. GRÁFICAS 25

7.1 PROPIEDADES GENERALES 26

7.2 GRÁFICA DE BARRAS 26
7.3 GRÁFICA CIRCULAR O DE QUESOS. 27

8. TABLA DE REFERENCIAS CRUZADAS 29

9. REFERENCIAS 33
 1. Introducción
iReport es una herramienta visual para la construcción y diseño de informes de
JasperReports.

1.1. Características de iReport

Ireport tiene, entre otras, las siguientes características:

100% escrito en Java, opensource y gratuito

Soporta internacionalización nativamente.

Soporta jdbc

Facilidad de instalación

Incluye Asistentes

Variedad de Fuentes incluidas

1.2. Instalación de iReport

• Jdk 6: el realmente el único requerimiento de instalación

(http://java.sun.com/javase/downloads/index.jsp)
• iReport 2.0.2: lógicamente, para descargarlo,
http://sourceforge.net/project/showfiles.php?group_id=64348&package_id=
64215, si nuestro sistema operativo es Windows, descargar el iReport-2.0.2-
windows-installer.exe
• Acrobat 7 o superior, realmente no es necesario pero es recomendable para
visualizar el resultado.
• En nuestro caso vamos a conectarnos a una base de datos, por lo que
necesitamos el driver JDBC para oracle (ojdbc14.jar)

1. Instalación de JDK

Ejecutar el archivo de instalación y seguir las instrucciones del asistente.

2
3
2. Instalación de iReport

4
3. Instalación del driver. Lo único que hay que hacer es copiar el driver
ojdbc14.jar el la carpeta lib de donde se haya instalado el iReport, si hemos
dejado la opción por defecto C:\Archivos de programa\JasperSoft\iReport-
2.0.2\lib

5
 2. Configuración de iReport
Una vez hecho todo esto ya podemos abrir el iReport y empezar a configurar
nuestras opciones y lo primero va a ser crearnos una conexión con la Base de
Datos. Para ello buscamos la opccion de Conexiones/Fuentes de datos, le damos a
nueva y elegimos la opcion de Conexión Base de Datos JDBC.

6
Si hemos instalado el driver nos tiene que salir en el desplegable de Controlador
JDBC. Introducimos los datos de la conexión y listo.

Una vez creada la conexión vamos a establecer los programas de externos en los
que se va visualizar los reports, además también podemos especificar dónde
queremos la compilación, si queremos que se generen backups,…

7
Y ya por último antes de empezar a trabajar, especificamos el formato de salida del
report.

Una vez creado el datasource correctamente vamos a diseñar nuestro informe.

8
 3. Mi primer informe
3.1 Crear un informe

Para crear un nuevo informe, hacemos Fichero  Nuevo documento ( ), aparece

el cuadro de diálogo en el que especificamos las propiedades del informe, si
posteriormente tenemos que cambiarlas desde editar  propiedades del informe.

Lo más destacable es el nombre del informe, el tamaño de la página y la

orientación y luego en la pestaña de i18n la codificación del XML, que si tenemos
problemas con la ñ hay que poner en ISO-8859-1.

3.2 Partes de un informe

Cuando creamos un informe, podemos distinguir distintas partes o bandas:

9
 • title: esta zona aparece sólo en la primera pagina del informe, por lo que si
queremos que un título nos aparezca en todas las páginas, esta no se la
banda adecuada
• pageHeader: el encabezado de página aparece en la parte superior de cada
una de las páginas que tenga el informe.
• columnHeader: esta zona también se repite en cada una de las páginas, se
suele utilizar para listar los nombres de los campos que se van a presentar.
Hay que tener en cuenta que las variables calculadas, en ocasiones, no se
ejecutan correctamente en esta zona y hay que especificarles el tiempo de
evaluación.
• detail: En esta banda se suelen representar los valores de los campos a
representar.
• columnFooter: en esta se suele presentar información sumarizada para
cada uno de los campos.
• pageFooter: Aparece en la parte inferior de cada una de las páginas.
• summary: Esta banda se suele utilizar para representar los totales del
report, entre otras cosas que ya iremos viendo.

En ocasiones podremos tener más bandas, si es que tenemos agrupaciones

también podemos tener solamente las que vayamos a usar. Las bandas las
podemos gestionar de forma visual o en las propiedades de las bandas del informe.

3.3 Parámetros ($P)

Campos, Variables
y parámetros Consultas

Bandas Grupos

Los parámetros se usan para definir valores concretos y sobre todo para que la
consulta sea “dinámica”, es decir, establecer los parámetros del where de la
consulta.

10
Para crear un parámetro, pulsamos sobre el icono de campos, variables y
parámetros.

Podemos crear los parámetros que necesitemos. Por ejemplo si vamos ha hacer
una consulta sobre trabajadores, a lo mejor queremos que unas veces nos salgan
los activos, otras los no activos o todos, para ello le daríamos a nuevo y
estableceríamos las propiedades que necesitáramos.

Cuando referenciemos a este parámetro lo haremos cono $P{ACTIVO}. Tenemos

que tener en cuenta que como estamos en “java” se distinguen entre mayúsculas y
minúsculas por lo que no será el mismo parámetro ACTIVO que activo, Activo, …

3.4 Variables ($V)

Las variables se utilizan para hacer cálculos dentro del informe, como totales,
cuentas, …

Por ejemplo, la suma de los salarios.

11
 Establecemos:

nombre de la variable

clase tipo de variable, que siempre

que sea un cálculo tendremos que
poner como java.math.BigDecimal.

tipo de cálculo, cuenta, suma,

promedio, …

restauración, es decir, si el cálculo es

por página, por informe, por grupo,
….

expresión de variable, indicamos el

campo o variable sobre la que se va a
realizar el cálculo.

3.5 Campos ($F)

Son los campos que se recuperan de la consulta de la Base de datos. Los campos
se suelen cargar automáticamente cuando se crea la consulta.

3.6 Consultas

Para poder hacer un listado de una consulta de Base de Datos tenemos que
introducir la consulta,

Campos, Variables y
parámetros Consultas

Bandas Grupos

Vamos a hacer un listado de los empleados y su salario.

12
Como vemos, al escribir la consulta salen los campos seleccionados con el tipo del
campo ya mapeado.

Una vez tenemos esto, ya podemos empezar a “dibujar”

Texto Campo $F{FIELD} Compilar

Ejecutar

Una vez hecho el report compilamos y ejecutamos y obtendremos el resultado en el

formato que le hayamos indicado

13
Vamos a introducir una variable que sume todos los salarios.

14
Como vemos, lo hemos puesto en el summary, ya que es donde deben ir las
variables “calculadas”.

15
 4. Agrupación

Campos, Variables y
parámetros Consultas

Bandas Grupos

Podemos sacar los listados de manera agrupada, sin tener que agrupar en la select,
por ejemplo, vamos a listar los empleados de cada departamento.

Ahora agruparemos por el departamento

16
Cuando agrupamos se crean 2 bandas nuevas, NOMBRE_DEL_GRUPO footer y
NOMBRE_DEL_GRUPO header. En ellas pondremos los campos que queramos, por
ejemplo, en este caso podemos poner el nombre del departamento en el
encabezado del grupo y la suma del salario por departamento en el pie del grupo.
El nombre de los empleados se seguirá poniendo en el detail.

17
18
 5. Subinformes
Este mismo ejemplo también podríamos haberlo hecho con un subinforme. Los
pasos para crear un subinforme son:

5.1 Crear el informe padre

En este caso el informe padre seria la consulta de los departamentos.

5.2 Crear el informe hijo

Para crear el informe hijo tenemos dos opciones:

• Ayudarnos del wizard de iReport para crea el subinforme

• Crearlo manualmente y luego insertarlo en el padre

Vamos a optar por la segunda opción, ya que nos deja mas libertada

Vamos a diseñar el informe hijo. Este va a listar los empleados, pero como tenemos
que tener en cuenta los departamentos, vamos a pasarle un parámetro, es decir, la
consulta del report hijo será:

19
Ahora diseñamos el informe, para que no nos estorben los márgenes del informe
hijo, hacemos editar  quitar márgenes

5.3 Integración de los informes

Tenemos que asegurarnos de haber guardado el informe hijo y haberlo compilado,

es decir, haber generado el .jasper, ya que este fichero es el necesario para
integrarlo.

Subinformes

20
Seleccionamos la opción de usar el informe existente y buscamos el fichero .jasper
generado por el hijo.

El informe hijo se puede ejecutar desde la misma conexión que el padre o desde
otra,

21
Después elegimos el enlace de los informes, es decir, nos aparecen los parámetros
creados en el informe hijo y nos pide que los enlacemos con los campos del padre.
En nuestro ejemplo sólo tenemos un parámetro,

Y por último el modo de referenciarse. Si los reports están en la misma ruta

podemos elegir la referencia estática, si no, usaremos la primera opción.

Terminamos y ya tendríamos los dos reports integrados.

22
 6. Informes con código HTML
Otra de las funcionalidades de iReport es poder insertar código html dentro de
nuestros informes, con esto podemos hacer que las etiquetas de texto se formateen
exactamente como queremos.

No se puede embeber cualquier etiqueta html, sólo unas cuantas, por ejemplo:

• Nombre de la Fuente: <font face="Comic Sans MS">cambio de

fuente</font>
• Tamaño de fuente: <font size="12">Fuente a tamaño 12</font>
• Negrita: <b>bold</b>
• Cursiva: <i>italic</i>
• Subrayado: <u>underlined</u>
• Tachado: <style isStrikeThrough="true">isStrikeThrough</style>
• Color de la fuente: <font color="red">Texto en rojo</font>
• Salto de Linea: <br/>
• Elemento de Lista: <li>item 1</li>

23
El listado completo de los tags los podemos ver en un ejemplo:

http://www.jasperforge.org/images/documentation/jasperreports/samples/StyledTe
xtReport.jrxml

http://www.jasperforge.org/images/documentation/jasperreports/samples/StyledTe
xtReport.html

24
 7. Gráficas

Gráficas

Creamos nuestro informe como siempre escribiendo lo primero la consulta a

realizar y luego vamos a la opción de gráficas. Hemos de tener en cuenta que las
gráficas sólo se pueden representar en la banda Sumary.

Lo primero que nos pregunta es el tipo de gráfica que queremos representar.

Una vez tenemos decidido el tipo, hacemos doble clic en la gráfica y editamos las
propiedades, dependiendo el tipo de grafica vamos a tener unas u otras.

25
 7.1 Propiedades generales

Entre las propiedades generales tenemos la posibilidad de cambiar los colores y las
fuentes de la gráfica, el mostrar o no la leyenda, el rotar la orientación de las
etiquetas (en grados, -90, 90, 270, …) y la orientación de la gráfica, …

7.2 Gráfica de barras

Para indicar los campos o valores a representar en la gráfica de barras accedemos a

la pestaña “datos de la gráfica” de las “propiedades de la gráfica” y le damos a
añadir.

26
Aquí tenemos que rellenar los siguientes campos:

• Expresión de la serie: campo por el que se agrupa, es decir, sobre el que

se van a mostrar las barras, en nuestro caso vamos a sacar el sueldo de los
empleados, por lo que en este campo vamos a poner el nombre de los
empleados.
• Expresión de categoría: Etiqueta que se muestra de la expresión
• Expresión del valor: Valor que tomará la barra en la gráfica. En nuestro
caso el salario.
• Expresión de la etiqueta: Valor que se muestra dentro de la barra, solo se
muestra si tiene espacio.

7.3 Gráfica circular o de quesos.

Procedemos de la misma manera que con la gráfica de barras, pero en este caso,
solo hemos de rellenar tres campos.

• Clave expresión: Campo por el que se agrupan los datos, es decir, cada
quesito será un valor de lo que pongamos aquí, en nuestro ejemplo cada
trabajador será un quesito.
• Valor Expresión: Valor que toma el quesito
• Etiqueta de la expresión: Etiqueta para cada quesito.

27
28
 8. Tabla de referencias cruzadas
Para crear un informe en crosstab, al igual que con el resto, lo primero es crear la
consulta.

Con la consulta guardada, hacemos clic en Tabla de Referencias Cruzadas

Crosstab

Y lo insertamos en la banda de Sumary

Definimos la agrupación.

29
y el contenido de las celdas

30
Ya tendriamos el informe.

Desde aquí podemos modificar las propiedades del informe accediendo a las
“propiedades tabla ref. cruzadas” y también podemos añadir campos o cambiar el
formato al crosstab accediendo a su diseño en la pestaña.

31
Y como resultado:

32
9. Referencias
• http://blog.antioroku.com/archivo/5
• http://www.adictosaltrabajo.com
• http://www.ste.es

33