LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

MANUAL IREPORTS

Creado por Lenin Boada Pino Fecha Creacin 09/07/2012 Fecha Modificacin 09/07/2012

DELTA21 WEB

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

INDICE
INSTALACION.............................................................................................................................................3 LEVANTAR IREPORTS..............................................................................................................................4 CONFIGURAR DATA SOURCE.................................................................................................................5 Distribucin del Layout ................................................................................................................................8 Barra de herramientas ..................................................................................................................................10 Definicin PARMETROS, campos y Variables.......................................................................................11 Definicin CONSULTA CON Parmetros .................................................................................................15 CAMPOS CALCULADOS.........................................................................................................................16 MANEJO DEL PRINT WHEN EXPRESSION..........................................................................................17 GRAFICOS EN IREPORTS........................................................................................................................18 SUBREPORTES ..........................................................................................................................................21 REPORTES DINAMICOS..........................................................................................................................26 USO DE CLASES JAVA ...........................................................................................................................27 ENLACES DE INTERES............................................................................................................................30

DELTA21 WEB

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

INSTALACION

1. Instalar DB2 como cliente para conectarse a un servidor de Base de Datos. 2. Instalar j2sdk y configurar las variables de entorno a. JAVA_HOME

b. PATH
DELTA21 WEB 3

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

3. Instalar Ireport a. Copiar la carpeta en el siguiente PATH

LEVANTAR IREPORTS Ejecutar C:\Archivos de Programa\Apache\Ireport-1.2.0\ireport.bat La interfaz grfica de iReport comienza a cargarse:

DELTA21 WEB

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

CONFIGURAR DATA SOURCE

Verificar que los archivos *.jar que permiten la conexin va JDBC estn definidos en la variable de sistema
5

DELTA21 WEB

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Configurar los DataSource JDBC Seleccionar DataSource--> Connection/DataSource-->New

Name: Escribir el nombre de la base de datos. JDBC Driver: Seleccionar el Driver de la base de datos con la cual se realizar la conexin. JDBC URL: La direccin URL de donde se encuentra alojado el ambiente de trabajo de la base de datos. Especificar la cadena de conexin con la base de datos, colocar usuario y password. Salvar la configuracin de la conexin.

DELTA21 WEB

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Presionar el botn Test, para verificar que la conexin este correcta, para la cual deber aparecer la siguiente ventana:
DELTA21 WEB 7

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Para Oracle los parmetros son:

DISTRIBUCIN DEL LAYOUT

La apariencia del layout (plantilla) de la pgina del reporte es la siguiente:

DELTA21 WEB

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Donde:

title Aparece slo al inicio del reporte. El ttulo se escribe en est seccin. Ejemplo: Reporte de Desempeo de los empleados pageHeader Aparece en la parte superior de cada pgina. Puede contener informacin como la fecha y hora, nombre de la organizacin, etc. columnHeader Sirve para listar los nombres de los campos que se van a presentar (desplegar). Por ejemplo: Nombre del Empleado, Hora de Entrada, Hora de Salida, Horas trabajadas, Fecha, etc. detail En esta seccin se despliegan los valores correspondientes a las entradas de campos definidas en la seccin anterior. Por ejemplo Juan Perez, 09:00, 18:00, 9,2005-04-27 columnFooter Puede presentar informacin sumarizada para cada uno de los campos. Por ejemplo Total de Horas Trabajadas: 180 pageFooter Aparece en la parte inferior de cada pgina. Este parte puede presentar, el contador de pginas como Pgina 1/7 summary Esta seccin se usa para proporcionar informacin sumarizada de los campos presentes en la seccin detail por ejemplo para el caso de las horas trabajadas de cada empleado se puede definir un objeto grfico tipo pie para tener una mejor comparacin y comprensin visual de los datos.

DELTA21 WEB

LB

MANUAL IREPORTS
BARRA DE HERRAMIENTAS

Documentacin Fecha: 09/07/2012 NORMAS-001

Los objetos de texto, imgenes, etc pueden ser colocados en la plantilla del documento usando el mtodo de arrastrar y pegar. Para insertar texto puro usar:

Para insertar campos (Fields) usar:

Para insertar imgenes usar:

Cuando insertamos un objeto de texto lo haremos arrastrando el elemento hasta el lugar del documento donde queramos visualizarlo. Seguidamente se presionar clic derecho para editar las propiedades del objeto y as poder definir los valores de fuente, bordes y el contenido mismo del texto.

DELTA21 WEB

10

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

A medida que insertemos objetos de texto (estticos y campos dinmicos), nuestro reporte empezar a definir la apariencia visual que buscamos.

DEFINICIN PARMETROS, CAMPOS Y VARIABLES Para definir los parmetros se tiene que pulsar el botn Parameters desde la barra de herramientas

Los documentos que se generan con iReports + jasperreports tienen varios valores que son seteables o configurables, estos son parmetros, campos (Fields) y variables:

DELTA21 WEB

11

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

a)Parmetros: son valores generales como el titulo del reporte / subreporte, ubicacin, autor, etc.

b)Campos (Fields): son los campos tipo texto que llenaremos desde las consultas lanzadas a la aplicacin durante la ejecucin del reporte.

DELTA21 WEB

12

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

c) Variables: una variable es un valor calculado como una sumatoria.

DELTA21 WEB

13

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Los objetos de tipo TextField, deben definir un campo field en su vieta de propiedades y deben usar el key textField. En general debe configurarse como se indica en las siguientes pantallas.

Una vez que hemos terminado de diagramar nuestro reporte, debemos compilar y luego ejecutarlo. La herramienta nos permite tener una vista previa en varios formatos de la apariencia de nuestro documento.

DELTA21 WEB

14

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

DEFINICIN CONSULTA CON PARMETROS RECOMENDACIONES: USAR SQL ESTNDAR USAR FUNCIONES DE USUARIO PARA EVITAR JUNTURAS NO USAR ALIAS EN LAS TABLAS NO USAR FUNCIONES COMO COUNT(*), SUM(*), UNION

Para que un Query maneje parmetros en ireports de debe hacer referencia a los parmetros previamente creados en el reporte. De la siguiente manera: SELECT CODIGO,TIPO,NOMBRE FROM mutual.CO_CTA
DELTA21 WEB 15

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

WHERE CODIGO BETWEEN $P{CodigoIni} AND $P{CodigoFin} AND ID_EMPRESA=$P{Empresa} ORDER BY CODIGO

CAMPOS CALCULADOS Crear un nuevo TextField , dar clic derecho e ir a sus propiedades. Poner la frmula clculo en TEXTFIELD EXPRESSION. Tanto parmetros, campos o variables pueden participar en una frmula. Parmetros -> $P{nombre_parametro} Campo -> $F{nombre_campo} Variable -> $V{nombre_variable} Se deben respetar estrictamente el manejo de tipos de datos del lenguaje JAVA. o Por ejemplo: o No se podrn sumar String y tipos de Datos Double. o No se podrn sumar DATE , para eso se usan los mtodos propios de la Clase DATE. Ejemplos de frmulas utilizados:
16

DELTA21 WEB

LB

MANUAL IREPORTS
o Suma de valores Double. new Double ( V{totalactivo}.doubleValue()+ $V{total4}.doubleValue()+ $V{total61}.doubleValue()+ $V{total63}.doubleValue()+ $V{total71}.doubleValue()+ $V{total73}.doubleValue()) o Obtener la fecha actual new Date()

Documentacin Fecha: 09/07/2012 NORMAS-001

o Frmula de condicin.- Si el signo es N, el saldo lo multiplica por -1 ( $F{SIGNO}.equals("P") ? $F{SALDO} : new Double ($F{SALDO}.doubleValue() * new Double(-1).doubleValue())) o Para la paginacin: "Pagina: " + $V{PAGE_NUMBER} + " de "

MANEJO DEL PRINT WHEN EXPRESSION Sirve para indicar una condicin para que el campo pueda ser mostrado en el reporte o no. Debe recibir un resultado Booleano.

DELTA21 WEB

17

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

GRAFICOS EN IREPORTS A partir de la versin 0.4.0, iReport proporciona una herramienta para simplificar la construccin de un grfico. Esta herramienta permite crear un grfico configurando propiedades y datos principales que sern vistos de manera simple por el usuario final. La creacin de un grfico se basa en una librera muy conocida de cdigo libre llamada JFreeCharts desarrollada por David Gilbert de Object Refinery Limited. iReport soporta por ahora solamente un pequeo nmero de tipos de grficos presentados en JFreeCharts, y pueden modificarse solamente algunas de las propiedades del grfico, pero es posible an as, crear grficos limpios con un gran impacto a la vista. DISEO DE EJEMPLO

DELTA21 WEB

18

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Para insertar un grfico en un reporte de iReport, seleccione el objeto Chart tool de la barra de herramientas de iReport y dibuje el grfico sobre la seccin summary del reporte:

A continuacin deber seleccionar el tipo de grfico deseado, para este ejemplo seleccionamos el tipo BAR. Oprimir el botn OK y el componente que contendr al grfico ya ha sido creado, lo que resta es configurar las propiedades del mismo y los datos que mostrar. Haciendo doble click sobre el componente del grfico, se mostrar la pantalla de propiedades de este, sitese en la pestaa Chart, a continuacin oprima el botn Edit chart properties, deber aparecer una pantalla como la siguiente:
DELTA21 WEB 19

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

En la pestaa Chart properties de esta pantalla, se encuentran las propiedades que pueden modificarse para el grfico en turno, como el nombre del grfico, las fuentes, leyendas, ect. Puede dejar las propiedades actuales por ahora y modificarlas posteriormente. Ahora centraremos la atencin en la manera de configurar los datos para el grfico. Debe situarse en la pestaa Chart data de la pantalla anterior y enseguida en la pestaa Details. En el apartado Seriesexpression, coloque la descripcin para el eje de las X , en el apartado Category expresin coloque el campo $F{} para los valores del eje X y en el apartado Value expresin coloque el campo $F{} para los valores del eje Y. Estos campos son precisamente los que se obtienen de la consulta que se estableci anteriormente, estos a su vez se mostrarn en la seccin detail del reporte.

DELTA21 WEB

20

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Fuente reporte Ireport: cliPrestamo.jrxml SUBREPORTES

DELTA21 WEB

21

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Los pasos a seguir sarn los siguientes: 1. Disear el reporte maestro un elemento vaco de subreporte 2. Disear el subreporte como un reporte ms 3. Definir los enlaces entre el reporte maestro y el subreporte Despus de llevar a cabo los puntos 1 y 2 debemos ser capaces de visualizar por separado reporte y subreporte usando iReport. Inclusin del subreporte en iReport

La inclusin de un subreporte en un reporte usando iReport supone lo mismo que incluir un campo de texto o un texto esttico. Simplemente hay que pulsar el botn de Subreport tool de la barra de herramientas y despus arrastrar el ratn en la banda que nos interese hasta conseguir el tamao deseado para nuestro subreporte. La siguiente imagen muestra la parte de la barra de herramientas que incluye el botn de subreportes:
DELTA21 WEB 22

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Definir en el reporte maestro un parmetro, al que llamaremos SUBREPORT4, de tipo net.sf.jasperreports.engine.JasperReport. Para ello, abriremos la vista de parmetros del men View y accederemos a la ventana de definicin de parmetros. En esta ventana, pulsaremos el botn New para acceder al dilogo que nos permitir definir nuestro parmetro. La siguiente figura intenta sintetizar lo dicho hasta ahora:

Dar clic Derecho del subreporte y acceder a sus propiedades.

DELTA21 WEB

23

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

En la pestaa Bajo el ttulo Connection / Datasource expression, vemos una lista desplegable. De ella, podemos seleccionar el mtodo que usar nuestro subreporte para obtener los datos. En nuestro caso, seleccionamos el elemento Use connection expression ya que los vamos a obtener de una base de datos mediante una conexin. A continuacin, escribimos la expresin que nos va a llevar a la conexin deseada. En nuestro caso, el parmetro REPORT_CONNECTION. Es decir, nuestro reporte maestro le va a pasar a nuestro subreporte la conexin referenciada en el parmetro REPORT_CONNECTION para que pueda ejecutar su consulta SQL.

DELTA21 WEB

24

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Enlazar y subreporte al parmetro que enlazamos anteriormente (SUBREPORT4) y crear los parmetros que recibir el subreporte.

DELTA21 WEB

25

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Si intentamos visualizar el reporte maestro desde iReport, veremos slo el reporte maestro. En el espacio del subreporte, no veremos nada. La razn es simple, no le hemos pasado al reporte maestro todos los datos necesarios para que pueda mostrarnos el subreporte. Simplemente le hemos indicado dnde los puede encontrar. La aplicacin iReport no sabe crear un objeto JaspeReport y pasrselo en un parmetro al reporte maestro. Para ver el resultado final, escribiremos un pequeo programa en Java que nos acabar de llenar los huecos que iReport no puede.

Fuente reporte Ireportco: coBalanceGeneral.jrxml Llamada al reporte ver en el archivo: BalanceGeneral.jsp REPORTES DINAMICOS El problema a solucionar es tener un solo reporte y pasarle dinmicamente el Query de consulta. No definir una Query esttica Definir un parmetro sql_query de tipo string En lugar del Query esttico colocar la siguiente instruccin $P! {sql_query}

DELTA21 WEB

26

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Fuente reporte Ireport: invInversiones.jrxml Llamada al reporte ver en el archivo: inversiones.jsp

USO DE CLASES JAVA Definir un Directorio CLASSPATH , que contendr las clases compiladas.

DELTA21 WEB

27

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

Registrar las Directivas de importacin.

DELTA21 WEB

28

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

En el ejemplo se Accede al mtodo hello() de la clase Prueba. Devuelve un String

DELTA21 WEB

29

LB

MANUAL IREPORTS

Documentacin Fecha: 09/07/2012 NORMAS-001

ENLACES DE INTERES

http://jasperreports.sourceforge.net/ http://www.forosdelweb.com/showthread.php?t=280528

DELTA21 WEB

30