Primeros pasos con los informes de jasper
Formatos de archivo de informe de Jasper
-
.jrxml
es el archivo de diseño del informe, su formato es XML legible por humanos, puede compilarse en un objetoJasperReport
y guardarse como.jasper
-
.jasper
es la versión compilada de.jrxml
y se puede cargar directamente en un objetoJasperReport
listo para llenarse con datos -
.jrprint
es el objetoJasperPrint
serializado, un informe que ya se ha llenado con datos y se puede cargar para imprimirlo, verlo y/o exportarlo al formato deseado. -
.jrpxml
es el XML rappresentativo de un objetoJasperPrint
, se puede modificar y luego desarmar para recuperar el objetoJasperPrint
Instalación o configuración
Biblioteca JasperReports
JasperReports es una herramienta de generación de informes basada en Java de código abierto. La biblioteca JasperReports se puede descargar desde la Comunidad de Jaspersoft para obtener la última [versión](http://community.jaspersoft.com/project/jasperreports-library/ comunicados).
En versiones recientes, los archivos jar de terceros en la carpeta lib no distribuidos, deben descargarse de repositorios públicos, consulte distribuido
pom.xml
para dependencias. Maven se puede utilizar para recuperar todas las dependencias, incluidas las transitorias en el carpeta de destino/dependencia.
mvn dependency:copy-dependencies
#Jaspersoft Studio (IDE)
Jaspersoft Studio es el cliente de diseño oficial de JasperReports, integrado en la plataforma Eclipse, para reemplazar a iReport Designer.
iReport Designer (IDE)
iReport Designer es el diseñador de informes anterior para JasperReports. La versión 5.6.0 (lanzada en mayo de 2014) fue la última versión oficial; el soporte del proveedor finalizó a fines de 2015.
JasperReport Recursos de la comunidad
Preguntas frecuentes sobre la biblioteca JasperReports
Código fuente
Tutoriales
Muestras
Referencias
Rastreador oficial de errores
Flujo de trabajo
El flujo de trabajo en jasper-reports es:
-
Diseñe el informe, cree el archivo jrxml que define el diseño del informe. El jrxml se puede crear usando un editor de texto simple, pero normalmente se usa un IDE (JasperSoft Studio o iReport) tanto para acelerar el desarrollo del informe como para tener una vista visual del diseño.
-
Compile el informe (el jrxml) para obtener un archivo .jasper o un objeto JasperReport. Este proceso se puede comparar con un archivo
.java
que se compila en.class
. -
Llene el informe, pase parámetros y una fuente de datos al informe para generar el objeto de impresión JasperPrint que también se puede guardar en un archivo
.jprint
-
Ver, imprimir y/o exportar JasperPrint. Los formatos de exportación más comunes son compatibles como pdf, excel, word, html, cvs, etc.
Comprender las diferentes bandas de informes
Título
Esta banda se muestra una vez al principio del informe. Se puede usar como primera página configurando el atributo isTitleNewPage="true"
Encabezado de página
Esto aparece al comienzo de cada página, excepto la primera página si se usa la banda Título y la última página si se usa la banda Resumen con la configuración isSummaryWithPageHeaderAndFooter="false"
Encabezado de la columna
Esto aparece antes de la banda de detalles en cada página.
Detalle
Esta sección se itera para cada registro en la fuente de datos suministrada. Se permite tener múltiples bandas de detalle (detalle 1, detalle 2 .. detalle n), se iteran de la siguiente manera
Row 1
detail 1
detail 2
detail n
Row 2
detail 1
detail 2
detail n
Pie de página de la columna
Esto aparece debajo de la banda de detalle en cada página donde está presente la banda de detalle. La configuración predeterminada es el final de la página (antes del pie de página), pero se puede cambiar a debajo de la última banda de detalles (último registro) configurando el atributo isFloatColumnFooter="true"
Pie de página
Esto aparece en la parte inferior de cada página, excluyendo la banda de título, la banda de resumen (sin pie de página) y la última banda no de resumen si se usa el pie de página de última página.
Pie de página de la última página
Esto aparece en la última página (si no es la banda de resumen sin el pie de página) en lugar del pie de página normal
Resumen
Esto aparece al final del informe en una nueva página si isSummaryNewPage="true"
está configurado y con encabezado y pie de página si isSummaryWithPageHeaderAndFooter="true"
Encabezado de grupo
Esta sección aparece si se define un grupo cada vez que cambia la expresión del grupo, antes de la banda de detalle.
Pie de página del grupo
Esta sección aparece si se define un grupo cada vez antes del cambio de expresión del grupo, después de la banda de detalle.
Fondo
Esta banda se muestra en todas las páginas como fondo para todas las demás bandas.
Sin datos
Esto aparece solo si no se pasó ninguna fuente de datos o si la fuente de datos está vacía (0 registros) y whenNoDataType="NoDataSection"
está configurado.