Generacin de reportes en mltiples formatos

con JasperReport e iReport

Juan David Guarnizo Hernandez (juandavid794@gmail.com)
Grupo de Investigacin en Teleinformtica con software de cdigo abierto GITECX
Facultad de Ciencias Bsicas e Ingeniera Ingeniera de Sistemas
Universidad de los Llanos Villavicencio, Colombia
Introduccin
Cuando se desarrolla una aplicacin esta no solo debe tener la capacidad de recolectar mucha
informacin, sino que tambin debe organizarla y presentarla en usuario de una forma en que genere
algn beneficio u ofrezca alguna informacin a tener en cuenta en el momento de toma de decisiones
gerenciales o comerciales; sea por medio de grficas o reportes dinmicos.
Bsicamente la generacin de reportes se resumen en el diseo 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 da de hoy se cuenta con herramientas open-source
que cumplen con el mismo objetivo, que tambin ofrecen facilidad y robustez que la herramientas
comerciales, es el caso de JasperReport.
JasperReport
Es un poderoso framework open-source para la generacin de reportes que presenta grandes
habilidades en la organizacin y presentacin 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 generacin dinmica de contenido.
JasperReport organiza datos recuperados de una base de datos relacional a travs de JDBC.
iReport
Aunque JasperReport es una librera que nos facilita el desarrollo, tambin se cuenta con una
herramienta de diseo que se puede integrar con Netbeans, donde se disea de forma grfica los
archivos XML que se define a travs de etiquetas que obedece una estructura, vocabulario y
restricciones declarados en una archivo DTD.
Instalacin
Cuando se quiere implementar JasperReport en algunas aplicaciones debemos realizar procesos
paralelos al desarrollo de la aplicacin. Adelante presentare algunos ejemplo de diseo e
implementacin de esta herramienta desarrollado en iReport utilizado como Plug-in de Netbeans. Por
lo tanto tambin explicaremos esta forma de instalacin
1. El primer paso que se debe hacer el momento de instalar cualquier aplicacin en la plataforma
de NetBeans es conseguir los archivos .nbm. En el caso de iReport se pueden conseguir en
la direccin http://jasperforge.org/project/ireport, Es la pagina principal del proyecto y estos
instaladores contienen incluidos las libreras de JasperReport.

2. Una vez en la pagina del proyecto iReport hay mltiples opciones de obtener la herramienta y
mltiples 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 instalacin en NetBeans entramos a Herramientas

Complementos Descargado Agregar Plugin. Seleccionan los archivos de instalacin y se
procede a realizar la instalacin.

5. En este punto NetBeans ya contiene las libreras de JasperReport y tambin tiene incorporado
la herramienta de diseo de reportes iReport, la cual se relaciona directamente con una Base de
Datos configurada en la barra de herramientas y tambin existe una nueva opcin en la creacin
de archivos.

Como Funciona?

Principalmente debemos comprender que se inicia con un archivo XML donde las etiquetas difieren
entre elementos como textos estticos, textos dinmicos, imgenes y formas geomtricas, tambin las
etiquetas establecen las variables, campos, parmetros, posiciones y extensiones; dentro del diseo
tambin se incluye la consulta a realizar en la base de datos, de donde se obtendr la informacin que
finalmente se mostrara en el reporte.
Una vez creado nuestro diseo, este debe ser compilado, por lo cual se genera un archivo de extensin
.jasper, durante este proceso de compilacin se verifica que la sintaxis del archivo XML para
comprobar la consistencia del diseo.Una vez el diseo 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 Bsicos de Diseo

El diseo 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 informacin obtenida de la base
de datos. Cuando diseamos un reporte debemos tener en cuenta que el template esta dividi
principalmente en la siguientes secciones comnmente 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 diseamos debemos tener en cuenta que estos reportes estn 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.
Tambin es muy importante que JasperReport maneja tres tipos diferentes de variables para el
manejo de los datos que son:

Parmetros: Se le asigna su valor antes de que el reporte sea llamado, principalmente se utilizan
para filtrar la informacin de la consulta a la base de datos o para obtener datos que no se
encuentra fcilmente en la fuente de datos.
Variables: Son utilizadas para realizar clculos 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 algn parmetro previamente declarado

$V{Nombre} para hacer referencia a alguna variable previamente declarado
$F{Nombre} para hacer referencia a algn campo o columna previamente declarado

Obteniendo estos conceptos bsicos de diseo, procederemos a crear un ejemplo completo utilizando
los anteriormente citado:
<?xmlversion="1.0"encoding="UTF8"?>
<jasperReportxmlns="http://jasperreports.sourceforge.net/jasperreports"
xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance"
xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports

http://jasperreports.sourceforge.net/xsd/jasperreport.xsd"name="reportname"pageWidth="595"pageHeight="842"
columnWidth="535"leftMargin="20"rightMargin="20"topMargin="20"bottomMargin="20">
<propertyname="ireport.zoom"value="1.0"/>
<propertyname="ireport.x"value="0"/>
<propertyname="ireport.y"value="0"/>
<queryString>
<![CDATA[SELECTA.Identificacion,A.NombreAsistente,I.NombreInstitucionFROMAsistentesA,
InstitucionesIWHEREI.idInstitucion=A.Institucion]]>
</queryString>
<fieldname="Identificacion"class="java.lang.String"/>
<fieldname="Asistente"class="java.lang.String"/>
<fieldname="Institucion"class="java.lang.String"/>
<title>
<bandheight="59"splitType="Stretch">
<staticText>
<reportElementx="0"y="0"width="555"height="59"/>
<textElementtextAlignment="Center"verticalAlignment="Middle">
<fontfontName="Arial"size="40"isBold="true"/>
</textElement>
<text><![CDATA[VJornadadelSoftwareLibre]]></text>
</staticText>
</band>
</title>
<pageHeader>
<bandheight="26">
<staticText>
<reportElementx="0"y="0"width="555"height="26"/>
<textElementtextAlignment="Center"verticalAlignment="Middle">
<fontfontName="Arial"size="20"isBold="true"/>
</textElement>
<text><![CDATA[Asistentes]]></text>
</staticText>
</band>
</pageHeader>
<columnHeader>
<bandheight="20"splitType="Stretch">
<staticText>
<reportElementx="0"y="0"width="82"height="20"/>
<textElementtextAlignment="Center"verticalAlignment="Middle">
<fontfontName="Arial"size="12"/>
</textElement>
<text><![CDATA[Identificacion]]></text>
</staticText>
<staticText>
<reportElementx="82"y="0"width="254"height="20"/>
<textElementtextAlignment="Center"verticalAlignment="Middle">
<fontfontName="Arial"size="12"/>
</textElement>
<text><![CDATA[Nombres]]></text>
</staticText>
<staticText>
<reportElementx="336"y="0"width="219"height="20"/>
<textElementtextAlignment="Center"verticalAlignment="Middle">
<fontfontName="Arial"size="12"/>
</textElement>
<text><![CDATA[Institucion]]></text>
</staticText>
</band>

</columnHeader>
<detail>
<bandheight="20"splitType="Stretch">
<textField>
<reportElementx="82"y="0"width="254"height="20"/>
<textElementtextAlignment="Left"verticalAlignment="Middle"markup="none">
<fontfontName="Arial"size="12"/>
</textElement>
<textFieldExpressionclass="java.lang.String"><!
[CDATA[$F{Asistente}]]></textFieldExpression>
</textField>
<textField>
<reportElementx="0"y="0"width="82"height="20"/>
<textElementtextAlignment="Left"verticalAlignment="Middle"markup="none">
<fontfontName="Arial"size="12"/>
</textElement>
<textFieldExpressionclass="java.lang.String"><!
[CDATA[$F{Identificacion}]]></textFieldExpression>
</textField>
<textField>
<reportElementx="336"y="0"width="219"height="20"/>
<textElementtextAlignment="Left"verticalAlignment="Middle"markup="none">
<fontfontName="Arial"size="12"/>
</textElement>
<textFieldExpressionclass="java.lang.String"><!
[CDATA[$F{Institucion}]]></textFieldExpression>
</textField>
</band>
</detail>
</jasperReport>

Generacin del Reporte desde el cdigo Java

Observamos anteriormente la forma de disear un reporte con iReport iniciando desde lo mas simple.
Ahora ya que aprendimos a disear y compilar el reporte, veremos como es llamado en reporte desde

una clase Java indicndole los valores de las variables de tipo Parmetro y la fuente de donde
obtendr los datos, tambin debemos indicar en nuestra clase que tipo de salida obtendr; es decir, si se
exporta a un archivo, se har una impresin o se mostrara en el JasperViewer.
importjava.sql.Connection;
importjava.sql.DriverManager;
importjava.util.HashMap;
importjava.util.Map;
importnet.sf.jasperreports.engine.JasperExportManager;
importnet.sf.jasperreports.engine.JasperFillManager;
importnet.sf.jasperreports.engine.JasperPrint;
importnet.sf.jasperreports.engine.JasperPrintManager;
importnet.sf.jasperreports.view.JasperViewer;
publicclassEjemploJSL{
publicstaticvoidmain(String[]args){
newEjemploJSL();
}

publicEjemploJSL(){
try{
MapParametros=newHashMap();
JasperPrintReporte=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(Exceptionex){}
}

privateConnectiongetConnection(){
try{
Class.forName("com.mysql.jdbc.Driver");
ConnectionConn=DriverManager.getConnection("jdbc:mysql://localhost:3306/jsl","root","");
return(Conn);
}
catch(Exceptionex){return(null);}
}