Post on 25-Jul-2015
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
I
MANUAL IREPORTS
DELTA21 WEB 1
Creado por Lenin Boada PinoFecha Creación 12/04/2023Fecha Modificación 12/04/2023
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
INDICE
1. INSTALACION....................................................................................................................................32. LEVANTAR IREPORTS......................................................................................................................43. CONFIGURAR DATA SOURCE........................................................................................................54. DISTRIBUCIÓN DEL LAYOUT.........................................................................................................85. BARRA DE HERRAMIENTAS.........................................................................................................106. DEFINICIÓN PARÁMETROS, CAMPOS Y VARIABLES.............................................................117. DEFINICIÓN CONSULTA CON PARÁMETROS...........................................................................158. CAMPOS CALCULADOS.................................................................................................................169. MANEJO DEL PRINT WHEN EXPRESSION..................................................................................1710. GRAFICOS EN IREPORTS.........................................................................................................1811. SUBREPORTES...........................................................................................................................2112. REPORTES DINAMICOS...........................................................................................................2613. USO DE CLASES JAVA..............................................................................................................2714. ENLACES DE INTERES.............................................................................................................29
DELTA21 WEB 2
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
1. 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
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
3. Instalar Ireporta. Copiar la carpeta en el siguiente PATH
2. LEVANTAR IREPORTS
Ejecutar C:\Archivos de Programa\Apache\Ireport-1.2.0\ireport.bat
La interfaz gráfica de iReport comienza a cargarse:
DELTA21 WEB 4
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
3. CONFIGURAR DATA SOURCE
Verificar que los archivos *.jar que permiten la conexión vía JDBC estén definidos en la variable de sistema
DELTA21 WEB 5
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
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 conexión. JDBC URL: La dirección URL de donde se encuentra alojado el
ambiente de trabajo de la base de datos. Especificar la cadena de conexión con la base de datos, colocar
usuario y password. Salvar la configuración de la conexión.
DELTA21 WEB 6
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Presionar el botón Test, para verificar que la conexión este correcta, para la cual deberá aparecer la siguiente ventana:
DELTA21 WEB 7
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Para Oracle los parámetros son:
4. DISTRIBUCIÓN DEL LAYOUT
La apariencia del layout (plantilla) de la página del reporte es la siguiente:
DELTA21 WEB 8
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Donde:
title Aparece sólo al inicio del reporte. El título se escribe en está sección. Ejemplo: “Reporte de Desempeño de los empleados”
pageHeader Aparece en la parte superior de cada página. Puede contener información como la fecha y hora, nombre de la organización, 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 sección se despliegan los valores correspondientes a las entradas de campos definidas en la sección anterior. Por ejemplo “Juan Perez”, “09:00”, “18:00”, “9”,”2005-04-27”
columnFooter Puede presentar información sumarizada para cada uno de los campos. Por ejemplo “Total de Horas Trabajadas: 180”
pageFooter Aparece en la parte inferior de cada página. Este parte puede presentar, el contador de páginas como “Página 1/7”
summary Esta sección se usa para proporcionar información sumarizada de los campos presentes en la sección “detail” por ejemplo para el caso de las horas trabajadas de cada empleado se puede definir un objeto gráfico tipo “pie” para tener una mejor comparación y comprensión visual de los datos.
DELTA21 WEB 9
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
5. BARRA DE HERRAMIENTAS
Los objetos de texto, imágenes, etc pueden ser colocados en la plantilla del documento usando el método de arrastrar y pegar.
Para insertar texto puro usar:
Para insertar campos (Fields) usar:
Para insertar imágenes 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
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
A medida que insertemos objetos de texto (estáticos y campos dinámicos), nuestro reporte empezará a definir la apariencia visual que buscamos.
6. DEFINICIÓN PARÁMETROS, CAMPOS Y VARIABLES
Para definir los parámetros se tiene que pulsar el botón “Parameters” desde la barra de herramientas
Los documentos que se generan con iReports + jasperreports tienen varios valores que son seteables o configurables, estos son parámetros, campos (Fields) y variables:
DELTA21 WEB 11
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
a)Parámetros: son valores generales como el titulo del reporte / subreporte, ubicación, autor, etc.
b)Campos (Fields): son los campos tipo texto que llenaremos desde las consultas lanzadas a la aplicación durante la ejecución del reporte.
DELTA21 WEB 12
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
c) Variables: una variable es un valor calculado como una sumatoria.
DELTA21 WEB 13
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Los objetos de tipo TextField, deben definir un campo field en su viñeta 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
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
7. DEFINICIÓN CONSULTA CON PARÁMETROS
RECOMENDACIONES:
USAR SQL ESTÁNDAR 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 parámetros en ireports de debe hacer referencia a los parámetros previamente creados en el reporte. De la siguiente manera:
SELECT CODIGO,TIPO,NOMBRE FROM mutual.CO_CTAWHERE CODIGO BETWEEN $P{CodigoIni} AND $P{CodigoFin} AND ID_EMPRESA=$P{Empresa}
DELTA21 WEB 15
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
ORDER BY CODIGO
8. CAMPOS CALCULADOS
Crear un nuevo TextField , dar clic derecho e ir a sus propiedades. Poner la fórmula cálculo en TEXTFIELD EXPRESSION. Tanto parámetros, campos o variables pueden participar en una fórmula.
Parámetros -> $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 podrán sumar String y tipos de Datos Double.o No se podrán sumar DATE , para eso se usan los métodos
propios de la Clase DATE.
Ejemplos de fórmulas utilizados:
o Suma de valores Double.
DELTA21 WEB 16
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
new Double ( V{totalactivo}.doubleValue()+ $V{total4}.doubleValue()+ $V{total61}.doubleValue()+ $V{total63}.doubleValue()+ $V{total71}.doubleValue()+ $V{total73}.doubleValue())
o Obtener la fecha actualnew Date()
o Fórmula de condición.- 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 paginación:
"Pagina: " + $V{PAGE_NUMBER} + " de "
9. MANEJO DEL PRINT WHEN EXPRESSION
Sirve para indicar una condición para que el campo pueda ser mostrado en el reporte o no. Debe recibir un resultado Booleano.
DELTA21 WEB 17
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
10.GRAFICOS EN IREPORTS
A partir de la versión 0.4.0, iReport proporciona una herramienta para simplificar la construcción de un gráfico. Esta herramienta permite crear un gráfico configurando propiedades y datos principales que serán vistos de manera simple por el usuario final.
La creación de un gráfico se basa en una librería muy conocida de código libre llamada JFreeCharts desarrollada por David Gilbert de Object Refinery Limited. iReport soporta por ahora solamente un pequeño número de tipos de gráficos presentados en JFreeCharts, y pueden modificarse solamente algunas de las propiedades del gráfico, pero es posible aún así, crear gráficos limpios con un gran impacto a la vista.
DISEÑO DE EJEMPLO
DELTA21 WEB 18
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Para insertar un gráfico en un reporte de iReport, seleccione el objeto Chart tool de la barra de herramientas de iReport y dibuje el gráfico sobre la sección summary del reporte:
A continuación deberá seleccionar el tipo de gráfico deseado, para este ejemplo seleccionamos el tipo BAR. Oprimir el botón OK y el componente que contendrá al gráfico 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 gráfico, se mostrará la pantalla de propiedades de este, sitúese en la pestaña Chart, a continuación oprima el botón Edit chart properties, deberá aparecer una pantalla como la siguiente:
DELTA21 WEB 19
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
En la pestaña Chart properties de esta pantalla, se encuentran las propiedades que pueden modificarse para el gráfico en turno, como el nombre del gráfico, las fuentes, leyendas, ect. Puede dejar las propiedades actuales por ahora y modificarlas posteriormente. Ahora centraremos la atención en la manera de configurar los datos para el gráfico.
Debe situarse en la pestaña Chart data de la pantalla anterior y enseguida en la pestaña Details. En el apartado Seriesexpression, coloque la descripción para el eje de las X , en el apartado Category expresión coloque el campo $F{} para los valores del eje X y en el apartado Value expresión 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 mostrarán en la sección detail del reporte.
DELTA21 WEB 20
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Fuente reporte Ireport: cliPrestamo.jrxml
11. SUBREPORTES
DELTA21 WEB 21
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Los pasos a seguir sarán los siguientes:
1. Diseñar el reporte maestro un elemento vacío de subreporte2. Diseñar el subreporte como un reporte más3. Definir los enlaces entre el reporte maestro y el subreporte
Después de llevar a cabo los puntos 1 y 2 debemos ser capaces de visualizar por separado reporte y subreporte usando iReport.
Inclusión del subreporte en iReport
La inclusión de un subreporte en un reporte usando iReport supone lo mismo que incluir un campo de texto o un texto estático. Simplemente hay que pulsar el botón de Subreport tool de la barra de herramientas y después arrastrar el ratón en la banda que nos interese hasta conseguir el tamañodeseado para nuestro subreporte.La siguiente imagen muestra la parte de la barra de herramientas que incluye el botón desubreportes:
DELTA21 WEB 22
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Definir en el reporte maestro un parámetro, al que llamaremos SUBREPORT4, de tipo net.sf.jasperreports.engine.JasperReport.Para ello, abriremos la vista de parámetros del menú View y accederemos a la ventana de definición de parámetros. En esta ventana, pulsaremos el botón New para acceder al diálogo que nos permitirá definir nuestro parámetro. La siguiente figura intenta sintetizar lo dicho hasta ahora:
Dar clic Derecho del subreporte y acceder a sus propiedades.
DELTA21 WEB 23
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
En la pestaña Bajo el título Connection / Datasource expression, vemos una lista desplegable. De ella, podemos seleccionar el método 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 conexión.A continuación, escribimos la expresión que nos va a llevar a la conexión deseada. En nuestro caso, el parámetro REPORT_CONNECTION.Es decir, nuestro reporte maestro le va a pasar a nuestro subreporte la conexión referenciada en el parámetro REPORT_CONNECTION para que pueda ejecutar su consulta SQL.
DELTA21 WEB 24
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Enlazar y subreporte al parámetro que enlazamos anteriormente (SUBREPORT4) y crear los parámetros que recibirá el subreporte.
DELTA21 WEB 25
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Si intentamos visualizar el reporte maestro desde iReport, veremos sólo el reporte maestro. En el espacio del subreporte, no veremos nada.La razón es simple, no le hemos pasado al reporte maestro todos los datos necesarios para que pueda mostrarnos el subreporte. Simplemente le hemos indicado dónde los puede encontrar. Laaplicación iReport no sabe crear un objeto JaspeReport y pasárselo en un parámetro al reporte maestro.Para ver el resultado final, escribiremos un pequeño 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
12.REPORTES DINAMICOS
El problema a solucionar es tener un solo reporte y pasarle dinámicamente el Query de consulta. No definir una Query estática Definir un parámetro sql_query de tipo string En lugar del Query estático colocar la siguiente instrucción $P!
{sql_query}
DELTA21 WEB 26
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
Fuente reporte Ireport: invInversiones.jrxmlLlamada al reporte ver en el archivo: inversiones.jsp
13.USO DE CLASES JAVA
Definir un Directorio CLASSPATH , que contendrá las clases compiladas.
Registrar las Directivas de importación.
DELTA21 WEB 27
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
DELTA21 WEB 28
MANUAL IREPORTS
LB
Documentación
Fecha: 12/04/2023
NORMAS-001
En el ejemplo se Accede al método hello() de la clase Prueba. Devuelve un String
14.ENLACES DE INTERES
http://jasperreports.sourceforge.net/ http://www.forosdelweb.com/showthread.php?t=280528
DELTA21 WEB 29