Crysfel’s Blog
Enviar parámetros a un reporte en JasperReport
Monday, October 1, 2007, 05:43:01 pm
Desarrollo, Featured, Java, Tutoriales
Hoy quiero continuar el tema de generar reportes pdf por medio de JasperReports, este tutorial es mas avanzado que el anterior, así que te sugiero leer la introducción en caso de que seas realmente nuevo con esta herramienta.
Goals
Hoy tratare el tema de paso de parámetros al reporte, y se definiran algunos conceptos claves, al igual que se hará un plantilla donde se mostrara como dar formato a texto entre otras cosas mas.
Para comenzar es necesario poner el enviroment adecuado, ya sabes, agregar al classpath las librerías requeridas (Señaladas en la introducción), luego de esto creamos un archivo de texto llamado plantilla.jrxml y nos disponemos a diseñar la plantilla por medio de xml.
Preparando el papel
Para este tutorial se va a realizar un reporte que muestre los alumnos de una carrera x de una universidad z, no voy a pasarle la información de los alumnos, solo la información necesaria para generar una plantilla, El primer paso es agregar la cabecera y configurar el nodo principal.
<!DOCTYPE jasperReport
PUBLIC "-//JasperReports//DTD Report Design//EN"
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">
<jasperReport name="Plantilla"
pageWidth="595"
pageHeight="842"
leftMargin="20"
rightMargin="20"
topMargin="20"
bottomMargin="20">
</jasperReport>
Si te das cuenta, se le han especificado algunas propiedades, tales como el ancho, el largo y los márgenes de la pagina, estos datos corresponden a una hoja tamaño carta, los márgenes los puedes poner al gusto, dependiendo tus necesidades.
Los parametros
Ahora viene una de las partes mas importantes de este tutorial, y es que continuación se define dentro de la plantilla los parámetros a utilizar, hay que aclarar que los parámetros no es el contenido principal del reporte, simplemente es información útil para mostrar en el reporte, por ejemplo la fecha en que se genera el reporte, o el periodo que se esta desplegando en el reporte, el autor o cosas semejantes, son parámetros importantes del reporte, pero no la información principal del reporte, con esto en cuenta se definen los parámetros a utilizar.
<parameter name="P_FACULTAD" class="java.lang.String"/>
<parameter name="P_CARRERA" class="java.lang.String"/>
Como puedes ver se utiliza la etiqueta <parameter /> la cual tiene dos propiedades, name que es el nombre o identificador con la que se hará referencia, y el tipo de dato que es, en este caso String, es importante mencionar que se debe escribir el paquete exacto donde se encuentra la clase.
La cabecera
Para la cabecera se mostrara el nombre de la institución en letras grandes y sobresalientes, se dibujara una línea horizontal debajo del nombre de la institución, se mostrara la facultad y la carrera. Todo esto lo pondremos dentro de la sección <title/> ya que esta únicamente se muestra una vez en el reporte, si existiese mas de una página, esto se muestra solo en la primera.
<band height="50">
<!-- AQUI DECLARAMOS EL CONTENIDO -->
</band>
</title>
El único detalle a comentar es que se ha declarado la propiedad height de “50″, esto significa que todo el contenido debe ser menor o igual a 50 pixeles, es importante tener en cuenta este dato y no superarlo con el contenido, de lo contrario tendremos un error a la hora de compilar el jrxml.
Como el texto será dinámico, pues desde nuestra aplicación le pasaremos la información, utilizaremos un textField, declarándolo de esta manera.
<reportElement x="0" y="0" width="530" height="30" />
<textElement>
<font pdfFontName="Helvetica-Bold" size="20" isBold="true"/>
</textElement>
<textFieldExpression class="java.lang.String">
<![CDATA[$P{P_INSTITUCION}]]>
</textFieldExpression>
</textField>
El código esta más que entendible, primero se especifica las coordenadas y dimensiones del textField, opcionalmente se da formato a la tipografía del textField mediante el bloque <textElement> por último la parte más importante, la expresión que contendrá el textField <textFieldExpression>, es importante mencionar que se debe especificar la clase que contendrá esta expresión, en este caso es un String, dentro de CDATA se puede concatenar inclusive varios parámetros, en este caso solo estamos poniendo el parámetro P_INSTITUCION.
Una cosa mas que conviene mencionar es que para poder acceder a los parámetros se hace mediante $P{NOMBRE_DEL_PARAMETRO} dende se sustituye el nombre del parámetro que se quiera accesar.
Es el turno de hacer una línea, es muy sencillo, simplemente hacemos lo siguiente.
<reportElement x="0" y="29" width="530" height="0" />
</line>
Aquí solo se declara la linea mediante la etiqueta <line> luego le especificamos las coordenadas y dimensiones donde estará posicionada.
Para los otros dos parámetros se hace exactamente igual que el anterior, con la diferencia que se le cambian las coordenadas, dimensiones, formato de letra y pasarle el parámetro correcto.
Al final el jrxml debe quedar algo asi:
<!DOCTYPE jasperReport
PUBLIC "-//JasperReports//DTD Report Design//EN"
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">
<jasperReport name="plantilla"
pageWidth="595"
pageHeight="842"
leftMargin="20"
rightMargin="20"
topMargin="20"
bottomMargin="20">
<parameter name="P_INSTITUCION" class="java.lang.String"/>
<parameter name="P_FACULTAD" class="java.lang.String"/>
<parameter name="P_CARRERA" class="java.lang.String"/>
<title>
<band height="50">
<textField>
<reportElement x="0" y="0" width="530" height="30" />
<textElement>
<font pdfFontName="Helvetica-Bold" size="20" isBold="true"/>
</textElement>
<textFieldExpression class="java.lang.String">
<![CDATA[$P{P_INSTITUCION}]]>
</textFieldExpression>
</textField>
<line direction="TopDown">
<reportElement x="0" y="29" width="530" height="0" />
</line>
<textField isStretchWithOverflow="false" isBlankWhenNull="false" evaluationTime="Now" hyperlinkType="None" hyperlinkTarget="Self" >
<reportElement x="0" y="30" width="250" height="20" />
<textElement>
<font pdfFontName="Helvetica-Bold" size="10" />
</textElement>
<textFieldExpression class="java.lang.String">
<![CDATA[$P{P_FACULTAD}]]>
</textFieldExpression>
</textField>
<textField isStretchWithOverflow="false" isBlankWhenNull="false" evaluationTime="Now" hyperlinkType="None" hyperlinkTarget="Self" >
<reportElement x="260" y="30" width="270" height="20" />
<textElement textAlignment="Right">
<font pdfFontName="Helvetica-Bold" size="10" />
</textElement>
<textFieldExpression class="java.lang.String">
<![CDATA[$P{P_CARRERA}]]>
</textFieldExpression>
</textField>
</band>
</title>
<detail>
<band height="200">
</band>
</detail>
</jasperReport>
Una vez diseñado el reporte se necesita compilar y generar el archivo jasper, luego se le pasan los parámetros y se exporta al formato deseado, en este caso se exportara a PDF.
El código necesario para realizar lo anterior es muy sencillo, es el siguiente.
import java.util.HashMap;
import java.util.Map;
import net.sf.jasperreports.engine.JREmptyDataSource;
import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperCompileManager;
import net.sf.jasperreports.engine.JasperExportManager;
import net.sf.jasperreports.engine.JasperFillManager;
import net.sf.jasperreports.engine.JasperPrint;
public class JasperReport2{
public static void main(String[] args){
try{
//1. Se compila el reporte
JasperCompileManager.compileReportToFile("plantilla.jrxml");
//2. Se llena el reporte con la informacion necesaria
Map pars = new HashMap();
pars.put("P_INSTITUCION", "Universidad de Montemorelos");
pars.put("P_FACULTAD", "Facultad de Ingeniería Tecnología");
pars.put("P_CARRERA", "Ingeniería en Sistemas Computacionales");
JasperPrint jasperPrint = JasperFillManager.fillReport(
"plantilla.jasper", pars, new JREmptyDataSource());
//3. Se exporta a PDF
JasperExportManager.exportReportToPdfFile(
jasperPrint, "plantilla.pdf");
System.out.println("Done!");
}
catch (JRException e)
{
e.printStackTrace();
}
}
}
Si te has dado cuenta, en el punto numero dos, se ha creado un HashMap, donde como llave contiene el nombre del parámetro, esto es muy importante, especificarle correctamente el nombre, de lo contrario no sucederá nada.
Pues bien, esto ha sido todo por hoy, creo que con esto queda claro como pasar parámetros a un reporte.
22 Respuestas para este tema
celer
Friday, January 11, 2008, 8:00 am
Hola Crysfel, te felicito por esta pagina dedicada a jasper r. Para los que recien se inician en este mundillo ,como yo,del jasp.rep, viene muy bien. A ver cuando continuas con tu articulo, o si alguien pudiese hacerlo , para sacar el listado con mas filas, por ejemplo ,como leer los alumnos de una carrera especifica. Gracias
WENDY
Friday, January 18, 2008, 11:37 pm
Hola, esta muy bien definido lo mencionado en tu blog. Pero tengo una duda la cual me gustaria que me ayudaras a resolver quisiera enviar una consulta que lea ciertos datos de una tabla enviandola desde una aplicacion Swing (uso netbeans). Has desarrollado algo similar si pudieras contestarme pronto te lo agradeceria.
thepanch
Sunday, January 20, 2008, 12:27 pm
Felicidades, justamente esto es lo que habia estado buscando y no encontraba, muchas gracias eres de los pocos, que además de saber de lo que hablan tambien saben escribir correctamente y expresar lo que quieren decir, Felicidades y de nuevo Gracias
Omar Valentín
Wednesday, February 6, 2008, 10:09 am
Gracias por compartir lo que sabes, justamente estaba buscando lo que tu publicaste, y estoy tratando de aplicarlo a una aplicación web desarrollada con el Visual Web Pack (netbeans). Gracias de nuevo Saludos!!
SERGIO ORDOÑEZ
Tuesday, March 11, 2008, 1:05 pm
Hola Crysfel!!!
Gracias por compartir tu conocimiento. Pero dime, ¿sabes de una forma para enviar como parametros un objeto? Me explico. En lugar de enviar, como en tu ejemplo los datos de la institucion uno a uno, enviarlos en una clase donde vayan incluidos todos.
Crysfel
Wednesday, March 12, 2008, 10:52 am
@Sergio
Hola, sobre lo que preguntas de pasar parametros como una clase no es posible en Jasper Report, pues la única forma de pasar parámetros es mediante el Map, lo que si puedes pasar en clases es la información del reporte o datasource, para esto último he hecho un tutorial. 
Saludos
adalid garcia
Thursday, April 3, 2008, 6:15 pm
Hola!!!! por mas y mas que trato de entender como jalarlo no puedo echarlo andar!!!
ya generamos nuestro reporte en el ireport ahi se ve bien desde la pc pero no se ocmo jalarlo … lo quiero meter a un linux, mysql … ya instale segun yo el jdk y jre … pero no se como se compila o como lo llamo desde el web para que funcion… me meto http://midireccion/mireporte.jrxml y solo me lo muestra en la pantalla .. o que tengo que hacer??? o donde puedo encontrar algo paso a paso>??
adalid garcia
Thursday, May 15, 2008, 7:00 pm
gracias por tu apoyo .. no que si andaba bien perdido con mi post anterior jeje
Ramiro
Thursday, July 10, 2008, 12:03 pm
Gracias por el articulo me ha servido bastante pues estoy comenzando a trabajar con el ireport.
Saludos,
Ramiro
gabriel
Wednesday, July 23, 2008, 2:11 pm
Muchisimas gracias por el tema me ha ayudado bastante como principiante
Patricia
Friday, August 1, 2008, 1:18 pm
Muy buena pagin, no hay mucha documentacion en internet hasta q encontre este y muy bueno. Yo recien emoeze a investigar sobre jasper report y entendi gracias a este post. y ya pude hacer mis reportes con los ejemplo q hay aqui.
Jimmy
Tuesday, October 21, 2008, 6:23 am
Muchas gracias! más gente como tú es lo que hace falta
scaze
Sunday, November 30, 2008, 9:03 am
como le envio los parametros desde una base de datos de mysql en netbeans
Lewinsman
Friday, March 6, 2009, 1:32 pm
Colle de Verdad que para las personas que se estan iniciando en el mundo de jasper es bastante util los tutoriales que haz colocado en la pagina solo he realizado el de introduccion y este de parametros y funcionan al tiro, de verdad muchas gracias y seguire apoyando para que coloques nuevos tutoriales.
Desde Venezuela Bless…
Lemay
Sunday, March 8, 2009, 10:27 pm
Hola quisiera saber si se puede en Ireport pasar una query como parametro usando PHP.
Para usar PHP yo uso JAVA/Brige
Alguna idea por favor????
Crysfel
Monday, March 9, 2009, 6:51 pm
@Lemay
Hay una solución para generar PDFs en PHP, te recomiendo darle un vistaso.
saludos
Lemay
Monday, March 9, 2009, 11:38 pm
Gracias Crysfel ya resolvi, el problema era pasarle en el report query del ireport $P!{parametro} y luego desde php se definela consulta.
ejem:
$query = select .. from
y luego se le pasa como parametro:
$parameter = new java(”java.util.HashMap”);
$parameter->put(”parametro”,$query);
Lemay
Monday, March 9, 2009, 11:46 pm
Hola alguien sabe como funciona la clase JasperDesign,el problema es que necesito modificar el diseño(jrxml) en tiempo de ejecución y me dijeron que el JasperDesign tiene metodos para eso ,ya vi las características de los métodos pero no me funciona no me deja compilar el .jrxml cuando modifico el diseño desde codigo???
Por favor si me pueden ayudar me sería de mucha utilidad…
Que me dices CRYSFEL has trabajado con esto….ayuda
Crysfel
Wednesday, March 11, 2009, 8:15 pm
@Lemay
No, la verdad es que no he trabajado con JasperDesign :s
saludos y suerte
CARLOS
Thursday, May 14, 2009, 8:35 am
MUY BUENO EL ARTICULO
0610
Sunday, May 17, 2009, 2:46 pm
Hola, se genera el siguiente error:
Exception in thread “main” java.lang.NoClassDefFoundError: org/apache/commons/digester/Digester
at net.sf.jasperreports.engine.JasperCompileManager.compileReportToFile(JasperCompileManager.java:89)
at JasperReport2.main(JasperReport2.java:20)
CARLOS
Wednesday, May 27, 2009, 7:24 am
dfg