Generación de reportes en múltiples formatos con JasperReport e ireport

Transcripción

1 Generación de reportes en múltiples formatos con JasperReport e ireport Juan David Guarnizo Hernandez (juandavid794@gmail.com) Grupo de Investigación en Teleinformática con software de código abierto GITECX Facultad de Ciencias Básicas e Ingeniería Ingeniería de Sistemas Universidad de los Llanos Villavicencio, Colombia Introducción Cuando se desarrolla una aplicación esta no solo debe tener la capacidad de recolectar mucha información, sino que también debe organizarla y presentarla en usuario de una forma en que genere algún beneficio u ofrezca alguna información a tener en cuenta en el momento de toma de decisiones gerenciales o comerciales; sea por medio de gráficas o reportes dinámicos. Básicamente la generación de reportes se resumen en el diseño y mapeo de datos dentro de un layout definido. Dentro de ese contexto surgen herramientas que facilitan esta labor. En el pasado esa área fue dominada por productos comerciales como Crystal Report que con el pasar del tiempo se hacia mas robusto integrando nuevas funcionalidades, en el día de hoy se cuenta con herramientas open-source que cumplen con el mismo objetivo, que también ofrecen facilidad y robustez que la herramientas comerciales, es el caso de JasperReport. JasperReport Es un poderoso framework open-source para la generación de reportes que presenta grandes habilidades en la organización y presentación de contenido en pantalla, impresora o en formatos como PDF, HTML, XLS, CSV y XML. Esta completamente escrito en Java y puede usarse en infinidad de aplicaciones web, distribuidas o de escritorio habilitadas para la generación dinámica de contenido. JasperReport organiza datos recuperados de una base de datos relacional a través de JDBC. ireport Aunque JasperReport es una librería que nos facilita el desarrollo, también se cuenta con una herramienta de diseño que se puede integrar con Netbeans, donde se diseña de forma gráfica los archivos XML que se define a través de etiquetas que obedece una estructura, vocabulario y restricciones declarados en una archivo DTD. Instalación Cuando se quiere implementar JasperReport en algunas aplicaciones debemos realizar procesos paralelos al desarrollo de la aplicación. Adelante presentare algunos ejemplo de diseño e implementación de esta herramienta desarrollado en ireport utilizado como Plug-in de Netbeans. Por lo tanto también explicaremos esta forma de instalación 1. El primer paso que se debe hacer el momento de instalar cualquier aplicación en la plataforma de NetBeans es conseguir los archivos.nbm. En el caso de ireport se pueden conseguir en la dirección Es la pagina principal del proyecto y estos instaladores contienen incluidos las librerías de JasperReport.

2 2. Una vez en la pagina del proyecto ireport hay múltiples opciones de obtener la herramienta y múltiples plataformas, solo se ofrece en modalidad de plug-in en la plataforma NetBeans; las otras opciones son para utilizar de forma independiente en Windows, Mac Os o Linux. 3. Cuando se descarga ireport para trabajar en NetBeans se obtiene un archivo comprimido el cual al descomprimirse se obtienen los siguientes archivos. 4. Una vez se obtienen los archivos de instalación en NetBeans entramos a Herramientas Complementos Descargado Agregar Plugin. Seleccionan los archivos de instalación y se procede a realizar la instalación.

3 5. En este punto NetBeans ya contiene las librerías de JasperReport y también tiene incorporado la herramienta de diseño de reportes ireport, la cual se relaciona directamente con una Base de Datos configurada en la barra de herramientas y también existe una nueva opción en la creación de archivos.

4 Como Funciona? Principalmente debemos comprender que se inicia con un archivo XML donde las etiquetas difieren entre elementos como textos estáticos, textos dinámicos, imágenes y formas geométricas, también las etiquetas establecen las variables, campos, parámetros, posiciones y extensiones; dentro del diseño también se incluye la consulta a realizar en la base de datos, de donde se obtendrá la información que finalmente se mostrara en el reporte. Una vez creado nuestro diseño, este debe ser compilado, por lo cual se genera un archivo de extensión.jasper, durante este proceso de compilación se verifica que la sintaxis del archivo XML para comprobar la consistencia del diseño.una vez el diseño se encuentra compilado entran en juego las clases que permiten visualizar, imprimir o exportar el reporte, para dar fin al ciclo de vida. Conceptos de Básicos de Diseño

5 El diseño se representa en un template que va a ser utilizado por el motor de JasperReport para generar un reporte de acuerdo con la estructura y completando con la información obtenida de la base de datos. Cuando diseñamos un reporte debemos tener en cuenta que el template esta dividió principalmente en la siguientes secciones comúnmente llamadas Band o Bandas que cuando se genera el reporte con los datos, cada una de ella se comporta de forma diferente: Title Page Header Column Header Detail 1 Column Footer Page Footer Last Page Footer Summary No Data Cuando diseñamos debemos tener en cuenta que estos reportes están muy adjuntos a funcionar con una fuente de datos, cuando esta fuente es una base de datos en Postgres, MySQL entre otras, debemos especificar la consulta (Query) que se va a realizar. También es muy importante que JasperReport maneja tres tipos diferentes de variables para el manejo de los datos que son: Parámetros: Se le asigna su valor antes de que el reporte sea llamado, principalmente se utilizan para filtrar la información de la consulta a la base de datos o para obtener datos que no se encuentra fácilmente en la fuente de datos. Variables: Son utilizadas para realizar cálculos dentro del reporte, como ejemplo el conteo de las paginas. Campos o Filas: Representan la única manera de mapear las columnas o datos obtenidos de la consulta realizada al sistema administrador de bases de datos, deben tener como requerimiento el mismo nombre de cada columna con su tipo de dato compatible. Para complementar el uso de los tipos de variables que podemos usar en JasperReport, tenemos las Expresiones, que hacen referencia a ellos de la siguiente manera: $P{Nombre para hacer referencia a algún parámetro previamente declarado $V{Nombre para hacer referencia a alguna variable previamente declarado $F{Nombre para hacer referencia a algún campo o columna previamente declarado Obteniendo estos conceptos básicos de diseño, procederemos a crear un ejemplo completo utilizando los anteriormente citado: <?xml version="1.0" encoding="utf 8"?> <jasperreport xmlns=" xmlns:xsi=" instance" xsi:schemalocation="

6 name="report name" pagewidth="595" pageheight="842" columnwidth="535" leftmargin="20" rightmargin="20" topmargin="20" bottommargin="20"> <property name="ireport.zoom" value="1.0"/> <property name="ireport.x" value="0"/> <property name="ireport.y" value="0"/> <querystring> <![CDATA[SELECT A.Identificacion, A.Nombre Asistente, I.Nombre Institucion FROM Asistentes A, Instituciones I WHERE I.idInstitucion = A.Institucion]]> </querystring> <field name="identificacion" class="java.lang.string"/> <field name="asistente" class="java.lang.string"/> <field name="institucion" class="java.lang.string"/> <title> <band height="59" splittype="stretch"> <reportelement x="0" y="0" width="555" height="59"/> <font fontname="arial" size="40" isbold="true"/> <text><![cdata[v Jornada del Software Libre]]></text> </band> </title> <pageheader> <band height="26"> <reportelement x="0" y="0" width="555" height="26"/> <font fontname="arial" size="20" isbold="true"/> <text><![cdata[asistentes]]></text> </band> </pageheader> <columnheader> <band height="20" splittype="stretch"> <reportelement x="0" y="0" width="82" height="20"/> <text><![cdata[identificacion]]></text> <reportelement x="82" y="0" width="254" height="20"/> <text><![cdata[nombres]]></text> <reportelement x="336" y="0" width="219" height="20"/> <text><![cdata[institucion]]></text> </band>

7 </columnheader> <detail> <band height="20" splittype="stretch"> <textfield> <reportelement x="82" y="0" width="254" height="20"/> <textelement textalignment="left" verticalalignment="middle" markup="none"> <textfieldexpression class="java.lang.string"><! [CDATA[$F{Asistente]]></textFieldExpression> </textfield> <textfield> <reportelement x="0" y="0" width="82" height="20"/> <textelement textalignment="left" verticalalignment="middle" markup="none"> <textfieldexpression class="java.lang.string"><! [CDATA[$F{Identificacion]]></textFieldExpression> </textfield> <textfield> <reportelement x="336" y="0" width="219" height="20"/> <textelement textalignment="left" verticalalignment="middle" markup="none"> <textfieldexpression class="java.lang.string"><! [CDATA[$F{Institucion]]></textFieldExpression> </textfield> </band> </detail> </jasperreport> Generación del Reporte desde el código Java Observamos anteriormente la forma de diseñar un reporte con ireport iniciando desde lo mas simple. Ahora ya que aprendimos a diseñar y compilar el reporte, veremos como es llamado en reporte desde

8 una clase Java indicándole los valores de las variables de tipo Parámetro y la fuente de donde obtendrá los datos, también debemos indicar en nuestra clase que tipo de salida obtendrá; es decir, si se exporta a un archivo, se hará una impresión o se mostrara en el JasperViewer. import java.sql.connection; import java.sql.drivermanager; import java.util.hashmap; import java.util.map; import net.sf.jasperreports.engine.jasperexportmanager; import net.sf.jasperreports.engine.jasperfillmanager; import net.sf.jasperreports.engine.jasperprint; import net.sf.jasperreports.engine.jasperprintmanager; import net.sf.jasperreports.view.jasperviewer; public class EjemploJSL{ public static void main(string[] args){ new EjemploJSL(); public EjemploJSL(){ try{ Map Parametros = new HashMap(); JasperPrint Reporte = JasperFillManager.fillReport("EjemploJSL.jasper", Parametros, this.getconnection()); JasperExportManager.exportReportToPdfFile(Reporte, "archivo.pdf"); JasperExportManager.exportReportToHtmlFile(Reporte, "archivo.html"); JasperPrintManager.printReport(Reporte, true); JasperViewer.viewReport(Reporte); catch(exception ex){ private Connection getconnection(){ try{ Class.forName("com.mysql.jdbc.Driver"); Connection Conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/jsl", "root", ""); return(conn); catch(exception ex){return(null);

9