Report ULTIMATE IReport novedosa guaGUIDEthat el autor del informe, ha puesto en marcha ) . Por ejemplo, el encabezado de la pgina se repite al principio de cada pgina , mientras que la banda de detallese repite para cada registro elaborado sola .

Bandas de un documento Figura 4-1 predefinido

El tipo de pgina se divide en nueve bandas predefinidas a las que se agregan nuevos grupos. De hecho, iReport maneja una banda de partida (Cabecera de grupo) y una banda de recapitulacin (Grupo de pie de pgina) para cada grupo.Una banda es siempre tan ancha como la anchura til de la pgina (mrgenes derecho e izquierdo excluido). Sin embargo, su altura, incluso si esestablecido durante la fase de diseo, pueden variar durante la creacin de impresin de acuerdo con los elementos contenidos; puede "alargar"hacia la parte inferior de la pgina de forma arbitraria. Esto suele ocurrir cuando las bandas contienen sub-informes o campos de texto que tienen queadaptarse al contenido verticalmente. En general, la altura especificada por el usuario se debe considerar "la altura mnima" de lagrupo musical. No todas las bandas se pueden reorganizar dinmicamente segn el contenido, en particular, el pie de pgina de columna, pie de pginaltimos bandas y pie de pgina.La suma de todas las alturas de la banda (excepto para el fondo) tiene que ser siempre menor o igual a la altura de la pgina menos la parte superiory los mrgenes inferiores.Las siguientes secciones describen brevemente cada una de las bandas predefinidas.4.1.1 TtuloLa banda ttulo es la primera banda visible. Se crea una sola vez y se puede imprimir en una pgina aparte. En cuanto a la definidadimensiones, no es posible durante el tiempo de diseo para exceder la altura de la pgina de informe (mrgenes superior e inferior se incluyen). Si elttulo se imprime en una pgina aparte, esta altura banda no est incluido en el clculo de la suma total de todas las alturas de la banda, quetiene que ser menor o igual a la altura de la pgina, como se mencion anteriormente4.1.2 Cabecera de pginaLa banda de encabezado de la pgina le permite definir un encabezado de pgina. La altura especificada durante la fase de diseo por lo general no lo hacecambiar durante el proceso de creacin (excepto para la insercin de re-importante verticalmente componentes, como los campos de texto que contienen

texto largo y sub- informes ) . El encabezado de la pgina aparece en todas las pginas impresas en la misma posicin definida durante la fase de diseo .Ttulo y Resumen bandas no incluyen el encabezado de la pgina cuando se imprimen en una pgina aparte.

4.1.3 Encabezado de columnaLa banda de cabecera de la columna se imprime al principio de cada columna detalle. (La columna concepto se explicar en elSeccin "Columnas" ms adelante en este captulo). Por lo general, las etiquetas que contienen los nombres de las columnas del informe de tabla se insertan en estegrupo musical.4.1.4 Encabezado de grupoUn informe puede contener cero o ms bandas de grupo, lo que permite la recopilacin de registros de detalles en los grupos reales. Un encabezado de grupo essiempre acompaado por un pie de grupo (ambos pueden ser, independientemente, visible o no). Diferentes propiedades se asocian con unagrupo. Ellos determinan su comportamiento desde el punto de vista grfico. Es posible forzar siempre un encabezado de grupo en una nueva pginao en una nueva columna y para imprimir esta banda en todas las pginas si las bandas por debajo de lo desbordan la pgina nica (como un encabezado de pgina, pero alnivel de grupo). Es posible fijar una altura mnima necesaria para imprimir un encabezado de grupo: si supera esta altura, el encabezado de grupobanda ser impreso en una pgina nueva (tenga en cuenta que un valor demasiado grande para esta propiedad puede crear un bucle infinito durante elletra de molde). (Voy a hablar de los grupos con mayor detalle ms adelante en este captulo).

4.1.5 DetalleUna banda de detalle corresponde a cada registro que se lee por la fuente de datos que alimenta la impresin. Con toda probabilidad, la mayora de laelementos de impresin se pondr aqu.4.1.6 Pie de grupoLa banda de pie de grupo completa un grupo. Por lo general, contiene campos para ver subtotales o elementos grficos de separacin, tales comolneas.4.1.7 Pie ColumnaLa banda de la columna de pie de pgina aparece al final de cada columna. Sus dimensiones no son ajustables en tiempo de ejecucin (ni siquiera sicontenida elementos volver a considerables como sub-informes o campos de texto con un nmero variable de lneas de texto).4.1.8 Pie de pginaLa banda de pie de pgina aparece en todas las pginas donde hay un encabezado de pgina. Al igual que el pie de pgina la columna, no se vuelve a considerable en carrerael tiempo.4.1.9 ltima Pgina Pie de pginaSi usted desea hacer el ltimo pie de pgina diferente de los otros pies de pgina, es posible utilizar el especial de la banda de pie de pgina ltima pgina.Si el alto de banda es 0, se ignora por completo y el diseo establecido para la pgina comn se utiliza tambin para el ltimopgina. Esta banda apareci por primera vez en JasperReports versin 0.6.2.

4.1.10 ResumenLa banda de resumen le permite insertar campos en relacin con los clculos totales, significa , o lo que usted quiere insertar al finaldel informe. En otros sistemas , esta banda es a menudo llamado "informe de pie de pgina " .4.1.11 AntecedentesLa banda de fondo apareci por primera vez en JasperReports versin 0.4.6 . Fue introducido despus de insistentes peticiones demuchos usuarios que queran ser capaces de crear marcas de agua y efectos similares (como un marco alrededor de toda la pgina ) . se puedetener una altura mxima igual a la altura de la pgina y su contenido aparecer en todas las pginas sin ser influencias de la pginacontenido definido en las otras bandas.

4.1.12 No DataLa banda No Data es una seccin de informe opcional que se imprime slo si la fuente de datos no devuelve ningn registro y el informeCuando la propiedad ningn tipo de datos debe estar en " Ninguna seccin de datos" . Desde esta banda ser impreso en lugar de todas las otras bandas, sualtura puede tener el mismo tamao de la pgina del informe (mrgenes excluidos) .04/01/13 Informe de PropiedadesAhora que usted ha visto las partes individuales que componen un informe , se proceder a la creacin de una nueva. Seleccione Nuevo vacaInforme en el men Archivo , elija un nombre para el documento y pulse el botn Finalizar . Un nuevo informe vaco aparecer enla ventana de diseo principal.los Las

Figura 4-2 Un nuevo informe vaco

La vista de propiedades ( en el lado derecho de la ventana principal ) muestra las propiedades del objeto que est seleccionado actualmente en laVer informe Inspector ( en el lado izquierdo de la ventana principal ) o en el rea de diseo ( como una banda o un elemento ) . Cuando un nuevoSe crea el informe , la hoja de propiedades muestra las propiedades del informe . Puede recuperar las propiedades del informe en cualquier momento seleccionandoel nodo raz en el Informe Inspector (mostrando el nombre del informe ) o haciendo clic con el ratn cualquier rea fuera del documentoen la ventana de diseo .La primera propiedad es el nombre del informe . Es un nombre lgico , independiente del nombre del archivo de origen , y se usa slo por elBiblioteca JasperReports (por ejemplo , como nombre base para el archivo Java temporal produce cuando se realiza un informe ) .Las dimensiones de la pgina son probablemente las propiedades ms importantes del informe. La unidad de medida utilizada por iReport yJasperReports es el pxel (que tiene una resolucin de 75 dpi , o puntos por pulgada) .

Tabla 4-3 enumera algunos formatos de pgina estndar y sus dimensiones en pxeles.

Tabla 4-3 Formatos de impresin estndar

Al modificar la anchura y la altura , es posible crear un informe de cualquier tamao que desee. La opcin de orientacin de la pgina ,horizontal o vertical , en realidad no es significativo, porque las dimensiones de la pgina se caracterizan por la anchura y la altura ,independientemente de la orientacin de la hoja . Sin embargo, esta propiedad puede ser utilizada por algunos exportadores de informe para decidir cmo imprimirel informe usando una impresora.Las dimensiones margen de la pgina se establecen por medio de las cuatro entradas de la seccin de mrgenes

04/01/14 ColumnasComo hemos visto , un informe se divide en secciones horizontales : bandas .La pgina, que compone el informe , presenta porciones que son independientes de los registros que provienen de los datosfuente (como la seccin del ttulo , o los pies de pgina ) , y otras secciones que son impulsados por que registra (como el grupoencabezados / pies de pgina y el detalle) . Estas ltimas porciones se pueden dividir en columnas verticales a fin de optimizar el espacio disponible en la pgina.

En este contexto, el concepto de " columna" puede ser fcilmente confundido con el de "campo" . Una columna no est conectado a una campo de registro , slo estamos definiendo aqu el diseo de la pgina , no una mesa o algo atado al formato de los datos que letra de molde. Esto significa que si usted quiere imprimir los registros que tiene, por ejemplo, diez campos , y desea crear un informe que que parece una mesa, que no necesita de diez columnas del informe , pero que tendr que colocar los elementos del informe (etiquetas y textocampos ) en un solo informe de columna con el fin de conseguir un efecto de mesa

Utiliza columnas cuando se necesita una distribucin similar a la de los peridicos , donde las lneas de texto se presentan en varios columnas para mejorar la legibilidad y utilizan mejor el espacio en la pgina.

Figura 4-4 Objetos de informe en la vista de esquema

En las siguientes figuras se presentan dos ejemplos. El primero muestra cmo configurar el informe para utilizar una sola columna ( en realidad el por defecto y la configuracin ms comn ; en este caso particular, el tamao de la pgina es un A4 regular) .

Figura 4-5 Estructura de un nico informe columna que muestra un conjunto de nombres Solicitar ID :

Los valores se establecen en el informe de vista de propiedades . El nmero de columnas es 1 y la anchura es igual a toda la pgina con ,a excepcin de los mrgenes (que es 535 pxeles). Dado que slo hay una sola columna , el espacio entre las columnas no es significativa yque se ajusta a cero ( que la propiedad est desactivado en realidad cuando el nmero de columna es 1 ) .

Figura 4-6 Resulta do de un informe mediante el diseo de una sola columna

Como se puede ver en la Figura 4-6 , la mayor parte de la pgina no se utiliza ( la figura muestra slo la primera pgina , pero el informe se compone deotras pginas que son muy similares ); en hechos cada registro requiere todo el ancho horizontal de la pgina. As que la idea es tratar dedividir las pginas en dos columnas , de modo que cuando la primera columna de llegar al final de la pgina, podemos empezar a imprimir en esta pgina de nuevoen la segunda columna . Figura 4-7 muestra las dimensiones utilizadas para un informe de dos columnas .

Figura 4-7 Configuracin para informar de un dos columnas

En este caso la propiedad de nmero de columnas se establece en 2. iReport calcular automticamente el ancho mximo de la columnade acuerdo con los mrgenes y al ancho de pgina . Si usted desea aumentar el espacio entre las columnas , slo aumentar el valorde la propiedad del espacio de columnas.

Figura 4-8 Disposicin de un dos columnas del informe que muestra un conjunto de nombresFigura 4-9 Resultado de un informe mediante el diseo de dos columnasSolicitar ID :

El diseador mostrar los lmites de columna y el espacio entre las columnas ..

Figura 4-9 Resultado de un informe mediante el diseo de dos columnas

Como vemos en la figura 9.4 , ahora se utiliza mejor el espacio de la pgina .Varias columnas son de uso general para impresiones de listas muy largas (por ejemplo la gua telefnica ) . La suma de los mrgenes ,anchos de columna y cada espacio entre columnas , tiene que ser menor o igual a la anchura de la pgina . Si esta condicin no se verificala compilacin puede dar lugar a error.Cuando se trabaja con ms de una columna , usted debe poner elementos (campos , imgenes, etc ...) justo dentro de la primera columna. el otrocolumnas se muestran en el diseador slo para referencia , pero cualquier elemento colocado aqu en tiempo de diseo seran tratados como parte dela primera columna ( en los hechos slo estn definiendo una plantilla de detalles, no hay restricciones sobre la colocacin de elementos fuera de lalmites de banda horizontal, pero sera como poner los elementos fuera de la pgina ) .

Figura 4-10 Zona segura para colocar los elementos del informe ( campos de texto , imgenes, etc ... )

La siguiente imagen muestra las zonas " inseguras" : son esencialmente los mrgenes y todo lo que queda a la derecha de la primeracolumna.Por supuesto, las mismas reglas acerca de dnde colocar los elementos se aplican al informe incluso si hay una sola columna.

1.4.15 Opciones de informe AvanzadaHasta ahora hemos visto slo las caractersticas bsicas relativas al diseo. Ahora vamos a ver algunas opciones avanzadas. algunos deellos sern examinados a fondo y se explican con todo detalle en los siguientes captulos , y algunos de ellos sern totalmenteentendido y utilizado de una manera til slo despus de haber adquirido familiaridad con el uso de JasperReports .

4.1.15.1 ScriptletUn scriptlet es una clase Java cuyos mtodos se ejecutan de acuerdo a eventos especficos durante la creacin de informes , como elcomienzo de una nueva pgina o al final de un grupo. Para aquellos que estn familiarizados con herramientas visuales tales como MS Access o MS Excel , unscriptlet se puede comparar con un mdulo, en el que algunos de los procedimientos asociados con eventos particulares o funciones recuperables enotros contextos de informes ( por ejemplo, la expresin de un campo de texto ) se insertan . Discuto scriptlets extensamente en subdatasets

4.1.15.2 Recursos BundleEl paquete de recursos es una propiedad utilizada cuando se quiere internacionalizar un informe. Un paquete de recursos es el conjunto de archivos que contendr el texto traducido de las etiquetas, frases y expresiones de uso dentro de un informe en cada idioma definido. cada Uno lenguaje corresponde a un archivo especfico. Lo que se establece en la propiedad del paquete de recursos es el nombre base del paquete de recursos que es el prefijo a travs del cual se puede encontrar el archivo con la traduccin correcta . Con el fin de reconstruir el nombre del archivo requerido para una idioma en particular , unas iniciales idioma / pas (por ejemplo , _it_IT para el italiano - Italia ) y la extensin .properties se aaden a este prefijo. ( " Internacionalizacin ", voy a explicar la internacionalizacin en mayor detalle en el captulo 14 , en la pgina 231. ) Si un recurso no est disponible , se puede especificar qu hacer por la eleccin de una opcin en la propiedad marcada Cuando faltan recursos escriba . Las opciones disponibles se muestran en la Tabla 2 :

Figura 4-11 Tabla 2 : Opciones para el tipo Cuando faltan recursos

4.1.15.3 consultaLa propiedad de consulta se utiliza para establecer una consulta para seleccionar datos. El lenguaje de la consulta se establece a travs de la propiedad marcada Elidioma para la consulta de datos . Aunque la consulta y su lenguaje se presentan en la hoja de propiedades , es mucho ms editar conveniente usando el editor de consultas que acceden por va el botn dedicado barra de herramientas.

Expresin 4.1.15.4 FiltroLa expresin de filtro es otra propiedad que puede ser editado desde el editor de consultas . Es una expresin booleana que se puede utilizar como habituales todos los objetos del informe (parmetros , variables y campos) para decidir si los registros actuales leen desde la fuente de datos se debe utilizar o no. He aqu algunos ejemplos de expresiones de filtro .

Filter only records where the field FIRSTNAME starts with the letter L JavaScript$F{FIRSTNAME}.substr(0,1) == "L" Groovy$F{FIRSTNAME}.startsWith("L")Filter only records where the field FIRSTNAME length is less than 5 JavaScript$F{FIRSTNAME}.length < 5 Groovy$F{FIRSTNAME}.length() < 5Filter only records where the field FIRSTNAME is the one provided by the parameter NAME JavaScript$F{FIRSTNAME} == $P{NAME} Groovy$F{FIRSTNAME} == $P{NAME}

4.1.15.5 PropiedadesEs posible definir un conjunto de pares de nombre / valor a un informe. Estos pares es lo que llamamos propiedades del informe . El nombre y el valor de las propiedades son cadenas slo simples y se utilizan para muchos propsitos , incluyendo conducir exportador especial

Figura 4-12 Dilogo de Propiedades

Al editar las propiedades , el dilogo de la Figura 4.12 aparece ..

Pulse el botn " Aadir" para crear una nueva propiedad . Una nueva ventana se abrir (Figura 4-13 ) .El cuadro de dilogo le permite especificar un nombre de propiedad y el valor .En la parte inferior de la ventana hay una lista de las propiedades especiales de significado . Puede hacer doble clic en un elemento para establecer la propiedadNombre de campo con la especificada por el artculo.

La lista no es exhaustiva , pero contiene los nombres de las propiedades ms importantes con un significado especial entendido por JasperReports . Si se desplaza la lista, te dars cuenta de que estas propiedades especiales pueden ser usados para una gran cantidad de diferentes tareas comoespecificando atributos particulares , cuando el informe se exporta en un formato especfico (es decir, evitar la paginacin al exportar en XSL ) ,activar directivas especiales exportador (es decir, a

4.1.15.6 Ttulo y resumen en una nueva opcin de la pgina .

Figura 4-14 Ttulo Band

El ttulo de una nueva opcin de pgina especifica que la banda ttulo se va a imprimir en una pgina nueva , lo que obliga a un salto de pgina al finalde la banda ttulo. Por defecto esta opcin no est activada. A modo de ejemplo , echar un vistazo a la figura 4-14 , que muestra un sencilloinforme.Cambio de la opcin no afecta a la ventana de diseo : en el editor de la banda ttulo siempre se dibuja en la parte superior de los otros(excepto, cuando est presente, el fondo).Cuando se ejecuta el informe de la banda ttulo ir en una pgina independiente basado a este valor de la opcin ..

Figura 4-15 y la Figura 4-16 muestra el mismo informe, el primero impresos sin ajustar el ttulo de una nueva opcin de pgina , la segundaque con true .

Figura 4-15 impresin predeterminado de la banda ttulo

Como se puede ver en la figura 4-16 , cuando se activa el ttulo en una nueva opcin de pgina , nadie otra banda se imprime en la pgina del ttulo,ni siquiera el encabezado o pie de pgina. Sin embargo , esta pgina est todava contaba en el total pginas numeracin ..

Figura 4-16 Ttulo banda en una nueva pgina

Esta opcin est disponible para la banda de resumen tambin, la diferencia es que la banda de resumen se imprime en la ltima pgina . Ahora, sinecesita imprimir esta banda en una nueva pgina , la nueva pgina slo contendr la banda de resumen.4.1.15.7 Opcin Pie Columna flotante Esta opcin permite forzar la impresin de la banda de la columna de pie inmediatamente despus de la ltima banda de detalle (o pie de grupo ) y no al final de la columna. Esta opcin se utiliza , por ejemplo, cuando se quiere crear tablas utilizando los elementos de informe(vase el ejemplo tables.jrxml JasperReports para ms detalles).4.1.15.8 orden de impresin La opcin Pedido de impresin determina cmo se organiza los datos de impresin en la pgina cuando se utilizan mltiples columnas . el valor por defecto ajuste es vertical , es decir, los registros se imprimen una despus de la otra , pasando a una nueva columna slo cuando la columna anterior ha llegado al final de la pgina ( como lo que sucede en un peridico o un libro de telfono) ..

Figura 4-17 Vertical orden de impresin

Figura 4-18 Horizontal orden de impresin

Orden de impresin Horizontal imprime los diferentes registros horizontalmente a travs de la pgina, ocupando todas las columnas disponibles antespasar a una nueva lnea . Consulte la Figura 4-17 y la Figura 4-18 para ejemplos de orden de impresin vertical y horizontal.Las impresiones en estas dos figuras deben clarificar el concepto de orden de impresin. Como se puede ver , los nombres se imprimen en orden alfabticoorden. En la figura 4-17 , que se imprimen en orden vertical ( relleno en la primera columna y luego pasar a la siguiente columna) ,y en la figura 4-18 , que se imprimen en orden horizontal ( llenar todas las columnas horizontalmente antes de pasar a la siguiente lnea ) .

4.1.15.9 Imprimir sin datos ( cuando no hay datos )Cuando un conjunto de datos vaco se suministra como el nmero de impresin (o la consulta SQL asociada con el informe da la espalda hay datos) , unase crea un archivo vaco (o una corriente de longitud cero bytes se devuelve ) . Este comportamiento por defecto se puede modificar especificando loque hacer en el caso de ausencia de datos ( es decir, cuando no hay datos ) . La Tabla 3 resume los valores posibles y su significado.

Figura 4-19 Opciones para la Cuando ninguna propiedad datos

4.1.15.10 Formato Clase de fbrica

Una clase de fbrica formato es una clase que implementa la interfaznet.sf.jasperreports.engine.util.FormatFactory . Puede configurar una implementacin personalizada de esa clase , que lo harse utiliza para definir la plantilla de formato predeterminada de los nmeros y fechas.

4.2 Trabajar con vendas .

Figura 4-20 Propiedades Band

Al crear un nuevo informe vaco, la plantilla predeterminada pone a su disposicin un conjunto de bandas predefinidas (fondo, ttulo, pgina cabecera, cabecera de la columna, detalle, columna pie de pgina, pie de pgina y el resumen). En particular, la altura de la banda de fondo en el plantilla es cero, por lo que en realidad no lo veo en el diseador. En el Informe Inspector puedes ver todas las bandas disponibles, la que se muestran en gris (ltima Pgina Pie de pgina y no hay datos) no estn presentes en el informe, esto significa que si usted desea utilizarlos, es necesario agregar explcitamente el informe haciendo clic en el nodo de banda, haga clic derecho y seleccione la opcin Aadir Band. En las misma manera se agrega una banda no est presente en el informe, puede eliminar uno. Otra de las opciones es establecer la altura de un no deseado banda a 0. Slo hay un caso en el que esto no iba a funcionar: con la banda ltima Pie de pgina. En efecto esta banda de forma automtica sustituye a la banda de pie de pgina en la ltima pgina del informe cuando se define, as que para evitar que usted necesita para sacarlo si no lo quieren y es por eso que no est presente en la plantilla

Las propiedades de una banda se pueden modificar seleccionando el nodo banda o simplemente haciendo clic con el ratn en una zona libre de la banda enel diseador principal ( por lo que no ms de un elemento o fuera de los lmites de la banda

Band altura La altura Band es la altura de diseo de la banda. Como se explic anteriormente en este captulo , el alto de banda puede cambiar durante elproceso de llenado. La altura de una banda , en general no consigue inferior del valor especificado , incluso si esto es posible cuando elQuitar lnea Cuando la opcin en blanco se encuentra en uno o ms elementos en esa banda y todas las condiciones para eliminar la horizontalespacio ocupado por estos elementos en el momento de llenado se verifican ( Remove Line Cuando la opcin en blanco se explica en la siguientecaptulo) .Cuando se modifica esta propiedad , iReport comprueba si el valor establecido es aceptable (calculando el espacio disponible enla pgina y teniendo en cuenta las opciones como el ttulo en una nueva pgina y resumen en una pgina nueva . Si el conjunto de valores no encajalos requisitos , iReport sugiere el rango de valores posibles.

Imprimir Cuando Expresin

La impresin cuando expresin es una expresin booleana ( por lo que debe devolver verdadero o falso) que se puede utilizar para ocultar la banda yevitar que sea incluida en el informe de salida. La expresin se evala cada vez que la banda hace referencia en un informe. Y Bueno,por ejemplo, en una pgina de informe de la banda ttulo se evala slo una vez , para la cabecera de la pgina que se evala cada vez que una nueva pgina esproducido por la banda de detalle se evala todas las veces que se procesa un nuevo rcord .Como en toda la expresin , usted es libre de utilizar todos los objetos de informe disponibles (campos, parmetros y variables)

Dividir permitidoLa opcin Separar permitido se utiliza para especificar qu hacer si la banda no se ajusta al espacio disponible que queda en la pgina.Teniendo en cuenta que las bandas pueden crecido dinmicamente durante el proceso de llenado, es fcil llegar a la situacin para la queno hay suficiente espacio para imprimir la banda actual. Por lo general, JasperReports divide la banda de impresin en la pgina actual slo loencaja all, y el resto en las pginas siguientes. Sin embargo puede ser all los casos en que este enfoque no es bueno para nosotros, y nosle gustara tener juntos todo el contenido de la banda. Para ello, basta con desactivar la condicin de Split permitido. JasperReportscomprobar si hay suficiente espacio en la pgina para imprimir toda la banda de lo contrario, lo imprimir en una pgina nueva. En este punto eldividida condicin permitido ya no se considera. Esto para evitar una situacin de bucle infinito, donde JasperReports mantiene saltandopginas con el fin de encontrar un punto en el que la banda puede caber, una condicin que podra estar nunca satisfecho descanso.En el prximo captulo veremos cmo utilizar el encabezado de grupo y las bandas de pie de pgina de grupo, y qu otras opciones se pueden configurar paracolocar grupos de la banda en una nueva columna o en una pgina nueva. En este punto, usted debe entender la estructura de una pgina y cmo esdividido en varias bandas (o secciones). Tambin debe comprender la naturaleza condicional de bandas, y cmo iReportevala si y cmo incluir una banda en una pgina del informe. En las bandas vamos a poner el contenido a imprimir.

5 elementos de informe

En este captulo, voy a explicar los principales objetos que se pueden insertar en un informe y hablar de sus caractersticas.Por "elemento", me refiero objeto grfico, como una cadena de texto o un rectngulo. A diferencia de lo que ocurre en un programa de procesamiento de textos,en iReport no existe el concepto de lnea o prrafo; todo se crea por medio de elementos, que pueden contener texto,crear tablas cuando estn oportunamente alineados, y as sucesivamente. Este enfoque sigue el modelo utilizado por la mayora de informeherramientas de autor.Nueve elementos bsicos son ofrecidos por la biblioteca JasperReports: Lnea Rectangle Ellipse texto esttico Campo de texto (o simplemente Field) Imagen Frame Sub-informe Matriz Grfico RecesoA travs de una combinacin de estos elementos, es posible producir cada tipo de informe.Adems de los nueve elementos bsicos, hay un elemento especial para crear saltos manuales (columna o de salto de pgina). Al Fin,JasperReports permite a los desarrolladores implementar sus propios elementos genricos y componentes personalizados para los cuales es posible sumarel apoyo en iReport para crear un buen complemento.Cada tipo de elemento tiene algunas propiedades comunes, como la altura, el ancho, la posicin y la banda a la que pertenece. Otropropiedades son especficas para el tipo de elemento (por ejemplo, la fuente o, en el caso de un rectngulo, espesor de la frontera). Ya Estvarios tipos de elementos; los elementos grficos se utilizan para crear formas e imgenes de pantalla (que son lnea, rectngulo,elipse, imagen), los elementos de texto se utilizan para imprimir cadenas de texto, como etiquetas o campos (son texto esttico y campo de texto), laelemento de estructura se utiliza para agrupar un conjunto de elementos y, opcionalmente, dibujar un borde alrededor de ellos. Sub-informes, Grficas y Tablasson elementos ms complejos, as que voy a referirme brevemente a ellos ms adelante en el presente captulo, y discutirlos en ms detalle en separadocaptulos. Finalmente, hay un elemento especial que se utiliza para insertar una pgina o columna descanso.Los elementos se insertan en bandas. En particular, cada elemento est asociado indisolublemente a una banda. Si un elemento no escompletamente contenida dentro de la banda que es parte de, el informe compilador devolver un mensaje que le informa sobre elposicin incorrecta del elemento; el informe se compilar a pesar de un error de este tipo, y en el peor de los casos, el "fuera de banda"elemento no ser impreso.

5.1 Trabajo con elementos

Los elementos se presentan en una paleta , que normalmente se encuentra en la parte superior derecha de la ventana principal ( vase la figura 5-1).

Figura 5-1 Herramientas Paleta

Para insertar un elemento en el informe , arrastre desde la paleta en una banda informe. El nuevo elemento se crear con un estndartamao y aparecer en el inspector de informe. Para seleccionar el elemento basta con hacer clic sobre ella en el diseador, o haga clic en el nodo relativa enel inspector informe. Puede ajustar la posicin del elemento seleccionando y arrastrando ; a modificar su tamao arrastre una esquina de larecuadro de seleccin naranja .

Figura 5-2 sugerida alineacin con otros elementos

Al arrastrar o cambiar el tamao de un elemento, iReport sugiere lugares para alinearlo con base en los elementos que ya estn en el panel de diseo , los lmites de la banda y ( si est presente ) lneas de gua . Para obtener una mayor precisin en el movimiento , utilice las teclas de flecha para mover el elemento 1 pixel a la vez; de manera similar , utilizando elteclas de flecha mientras presiona la tecla Mays se mover el elemento 10 pxeles.

Si necesita una referencia a los elementos de posicin en la pgina, se puede activar la cuadrcula en el panel de diseo seleccionando el menartculos Ver Diseador de informes Mostrar cuadrcula. Para obligar a los elementos para ajustar a la cuadrcula , seleccione Ver Diseador de informes Ajustar a la cuadrcula .

Figura 5-3 Lneas GuaLas lneas de gua tambin son tiles para colocar sus elementos en el informe. Con efecto magntico de la lnea de gua , es fcil colocar elelementos en la posicin correcta . Para crear una lnea gua , simplemente haga clic en una regla (vertical u horizontal ) y arrastre la lnea gua en elposicin ( ver Figura 5-3 ) quera . Por defecto gobernantes usan pulgadas como unidad. En el panel de opciones (Herramientas > Opciones) puede establecer launa unidad diferente (como pxeles, centmetros y milmetros ) .Usted puede arrastrar y cambiar la posicin de una lnea gua en cualquier momento , esto no tendr ningn efecto sobre la posicin de los elementos . Para quitar una lnea gua , slo tienes que arrastrar en la esquina superior / izquierda del panel de diseo .Los valores superior e izquierdo que definen la posicin del elemento son siempre relativos a la banda de los padres , o mejor a los padres contenedor, que suele ser una banda, pero podra ser un elemento de marco

61Si necesita una referencia a los elementos de posicin en la pgina, se puede activar la cuadrcula en el panel de diseo seleccionando el menartculos Ver Diseador de informes Mostrar cuadrcula. Para obligar a los elementos para ajustar a la cuadrcula, seleccione Ver Diseador de informes Ajustar a la cuadrcula.Las lneas de gua tambin son tiles para colocar sus elementos en el informe. Con efecto magntico de la lnea de gua, es fcil colocar elelementos en la posicin correcta. Para crear una lnea gua, simplemente haga clic en una regla (vertical u horizontal) y arrastre la lnea gua en elposicin (ver Figura 5-3) quera. Por defecto gobernantes usan pulgadas como unidad. En el panel de opciones (Herramientas> Opciones) puede establecer launa unidad diferente (como pxeles, centmetros y milmetros).Usted puede arrastrar y cambiar la posicin de una lnea gua en cualquier momento, esto no tendr ningn efecto sobre la posicin de los elementos.Para quitar una lnea gua, slo tienes que arrastrar en la esquina superior / izquierda del panel de diseo.Los valores superior e izquierdo que definen la posicin del elemento son siempre relativos a la banda de los padres, o mejor a los padresrecipiente, que es por lo general una banda, pero podra ser un elemento de marco.Figura 5-3 Lneas GuaFigura 5-4 Mover un elemento de una banda a otra

Si desea mover un elemento de su banda inicial a otro, o en un bastidor y vice versa, es necesario utilizar el informeinspector y arrastre el nodo de elemento en el nodo de nueva banda (o marco) como se muestra en la Figura 5-4.En la ventana de diseo, puede arrastrar un elemento de una banda a otra, pero la banda elemento padre no va a cambiar: nosotrosdijo que un elemento debe estar contenido en su banda, bueno, esto no es siempre true.There varias excepciones a esta regla yesta es la razn por iReport permite mover un elemento en cualquier parte del informe sin que le impide hacer eso y sincambiar o actualizar la banda de los padres de acuerdo a la nueva posicin del elemento.Como regla general, no se puede colocar un elemento en virtud de la parte inferior de su banda de padre (aunque sea parcialmente). Si esto sucede, un diseoerror se mostrar en la vista de los problemas de informe y el informe no va a funcionar. En la Figura 5-5 tenemos un elemento de texto quetiene el ttulo como banda principal. Desde la altura del elemento abarca ms de la banda de encabezado de pgina (que sigue la banda ttulo), una advertenciasobre la posicin del elemento no vlido aparece en la vista reportar problemas.

Figura 5.5 El elemento no en posicin correcta.

Para editar las propiedades de los elementos , puede utilizar la hoja de propiedades que normalmente se encuentra en la parte derecha de la ventana de diseo. los Las hoja de propiedades no slo se utiliza para los elementos , que puede ser utilizado para editar las propiedades de todos los componentes que componen el informe, Figura 5.5 El elemento no en posicin correcta Solicitar ID :como el formato de pgina , las opciones de banda, parmetros , variables y opciones de campos , etc. Cuando se selecciona algo en eldiseador o en la vista Informe Inspector , la hoja de propiedades muestra las opciones adecuadas para el objeto seleccionado .

Figure 5-7 Selection right to left

Figure 5-8 Only elements fully contained inthe selected area are selected

Alternativamente, es posible seleccionar ms de un elemento al mismo tiempo de mantenimiento presionada la tecla " Shift" y haciendo clic con el ratn sobre todos los elementos interesados .

Si se seleccionan dos o ms elementos, slo las propiedades comunes se visualizan. Si los valores de estas propiedades son diferentes, que aparecern en blanco (por lo general el campo se muestra vaco). Al especificar un valor para una propiedad particular, se aplica ese valor a todos elementos seleccionados.

5.2 Formateo Herramientas

Figura 5-9 Formato Herramientas Ver

Para organizar mejor los elementos de la ventana de diseo, se proporciona un conjunto completo de herramientas. Para acceder al formato herramientas de visualizacin, seleccione el men Ventana > Formateo de herramientas. Aparecer la vista de herramientas. Slo cuando el Cada herramienta est habilitado seleccin coincida con sus requisitos mnimos (individuales o de seleccin mltiple).Figura 5-10 enumera todas las herramientas disponibles, especificando qu tipo de seleccin requiere cada herramienta (seleccin simple o mltiple ) y explicando brevemente la funcin de cada herramienta.

Figura 5-10 herramientas de formato - Definiciones

5.3 Gestin de elementos con el Informe InspectorEl Informe Inspector muestra la estructura del informe completo. El nodo raz representa la pgina y puede ser seleccionado para modificartodas las propiedades de informe generales como hemos visto en el captulo anterior. Los siguientes nodos se utilizan para el estilo, laparmetros, los campos y las variables y otros objetos de informe si est presente (como sub conjuntos de datos).Despus de estos nodos no son las bandas. Cada banda contiene los elementos. Elementos contenedores (como cuadros) pueden tener otraelementos representados como nodos sub. El orden de los elementos en el Inspector es importante porque es la que se suelellamado el orden z (la posicin desde el punto de vista de la profundidad), en otras palabras, si un elemento precede a otros elementos en elvista inspector, que ser impreso delante de ellos. Si un elemento se superpone algunos predecesores, los cubrir. Tenga en cuenta quealgunos exportadores (como el exportador HTML) no es compatible con elementos superpuestos para que se saltan durante la prestacin,otras veces se puede tener dos o ms elementos superpuestos y de impresin slo uno de ellos utilizando la "letra cuando la condicin": esto esun simple truco para imprimir contenido diferente basndose en una condicin.Para cambiar el orden z, puede mover los elementos arrastrndolos con el ratn en el inspector, o puede usar el MoveAbajo y en Subir elementos del men. Recuerde que los elementos en la parte superior de la lista se imprimen primero, as que traer un elemento de frontal,tiene que mover hacia abajo en la lista.Todos los elementos se pueden copiar y pegar, a excepcin de los grficos y tablas de referencias cruzadas. Cuando se pega un elemento, que mantiene la parte superior / izquierdacoordenadas utilizadas en su envase anterior (una banda, una clula o un marco). Si el nuevo contenedor es menor que la anterior, sepuede ser necesario ajustar la posicin del elemento, ya que podra estar fuera de los nuevos lmites de contenedores.El inspector informe le permite seleccionar elementos dentro del informe, incluso si estos elementos no son visibles en el diseador oincluso si son difciles de seleccionar debido a la complejidad del informe.

5.4 Atributos de Basic ElementTodos los elementos tienen un conjunto de atributos comunes que se presentan en la vista de propiedades de los elementos (como se muestra anteriormente en la Figura 5-1 ) .Estos atributos se refieren a la informacin sobre el elemento de posicionamiento en la pgina : la lista siguiente se describen los diferentes atributosesta disponible.Coordenadas y las dimensiones se expresan siempre en pxeles en relacin con una resolucin de 72 pxeles por pulgada .

Top Esta es la distancia de la esquina superior izquierda del elemento de la parte superior del contenedorel elemento pertenece .Izquierda Esta es la distancia de la esquina superior derecha del elemento desde el margen izquierdo de larecipiente.Ancho Esta es la anchura del elemento .Altura Esta es la altura de los elementos ; en realidad, esto indica un valor mnimo que puede aumentardurante la creacin de impresin de acuerdo con el valor de los otros atributos.Figura 5-11 muestra cmo iReport posiciona un elemento con respecto a la banda ( o, ms ampliamente , a su contenedor ) a la que elelemento pertenece . El ancho de banda es siempre igual a la anchura de pgina del documento ( menos el margen izquierdo y derecho) ; alternativamente,su altura puede cambiar dependiendo del tipo de banda y por los elementos que contiene .

Figura 5-11 Posicionamiento de elementos

Primer plano Este es el color con el que se imprimen los elementos de texto y las lneas y la esquinas de elementos se dibujan .Antecedentes Este es el color con el que el elemento de fondo se llena . Ya que por defecto algunos elementos son transparentes , no olvide que el elemento opaco.Opaco Esta opcin controla si el fondo elemento tiene que ser transparente o no ; los las transparencia implica slo las partes que deben ser llenados con el fondo.

No todos los formatos de exportacin soportan el atributo transparencia.

Estilo Si el usuario ha definido una o ms estilos en el informe, es posible aplicar un estilo al elemento seleccionndolo de la lista.Clave Es el nombre del elemento , que tiene que ser nico en el informe ( iReport lo propone automticamente) , y que es utilizado por los programas que necesitan para modificar el campo propiedades en tiempo de ejecucinTipo de Posicin Esta opcin determina los mejores coordenadas tienen que ser considerados en el caso que la banda cambia su altura durante el proceso de llenado. Los tres posiblesLos valores son los siguientes:FixRelativeToTop Este es el tipo de posicin predefinida; el coordinan valores no cambian nunca .Flotador El elemento es empujado progresivamente hacia la parte inferior de los anteriores elementos que aumentan su altura.FixRelativeToBottom La distancia del elemento de la parte inferior de la banda se mantiene constante; por lo general esto se utiliza para las lneas que separan los registros.Tipo de Stretch Este atributo define la forma de calcular la altura de los elementos durante la impresin elaboracin; los tres valores posibles son los siguientes:NoStretch Este es el tipo de extensin predefinida, y dicta que la altura del elemento debe ser mantenido igual.RelativeToBandHeight La altura de los elementos se incrementa proporcionalmente al aumento del tamao de la banda; esto es til para las lneas verticales que simulan bordes de la tablaRelativeToTallestObject El elemento modifica su altura de acuerdo con la deformacin del ms cercano elemento: esta opcin tambin se utiliza con el grupo de elemento, que es un grupo de elementos mecanismo no gestionada por iReportImprimir valores repetidos Esta opcin determina si se imprime el elemento cuando su valor es igual a la que se utiliza en el registro anterior.Retire lnea cuando en blanco Esta opcin quita el espacio vertical ocupado por un objeto, si no es visible; la visibilidad elemento est determinado por el valor de la expresin contenida en el Imprimir cuando atributo de expresin o en el caso de los campos de texto por el blanco cuando nulo atribuir tambin. Piense en la pgina como una cuadrcula donde se colocan los elementos, con una lnea siendo el espacio del elemento ocupa. Figura 5-12 destaca el elemento de una lnea; en a fin de eliminar realmente esta lnea, todos los elementos que comparten una parte de la lnea de tiene que ser nulo (es decir, que no se imprimirn)

Figura 5-12 Elemento Una lnea

Imprimir en primera banda Toda esta opcin asegura que un elemento se imprime en la pgina siguiente (o columna ) si el banda desborda la pgina (o la columna) ; este tipo de garanta es til cuando el Imprimir atribuyen valores repetidos.Imprimir cuando detalle desborda Esta opcin imprime el elemento en la siguiente pgina o columna , si la banda no es todo imprimible en la presente pgina o columna.Imprimir cuando los cambios de grupo En este cuadro combinado, se presentan todos los grupos de informes . Si se selecciona uno de ellos, el elemento slo se imprimir cuando la expresin asociada al grupo cambios , es decir, cuando se crea una nueva ruptura del grupo seleccionado.Imprimir cuando la expresin Esta es una expresin como los descritos en el captulo 3 , y tiene que devolver un Objeto Boolean; adems de estar asociado a los elementos , esta expresin se asocia a las bandas , tambin. Si la expresin devuelve true, el elemento est oculto. Un vaco expresin o un valor nulo implcitamente identifica una expresin como nuevo Booleano (true ), que se imprimir el elemento incondicionalmente .Inmuebles expresiones Son un conjunto de pares clave / valor que se puede definir para cada elemento.

5.5 Elementos Propiedades personalizadasPara cada elemento, es posible definir un conjunto de simples propiedades personalizadas: cada propiedad es un par de claves / valor, donde tanto clave y el valor son cadenas de texto simples. El valor puede ser dinmica y generada mediante una expresin (que claramente tendr que devolver una cuerda).

Element propiedades personalizadas se configuran modificando el atributo expresiones Inmuebles en la hoja de propiedades muestra cuando se selecciona el elemento (vase la figura 5-13):

Figura 5-13 propiedades de los elementos personalizados

Las propiedades de los elementos de encargo se pueden utilizar para muchos propsitos , como para especificar el comportamiento especial para el elemento cuando se exportado en un formato particular o para establecer cmo los personajes tienen que ser tratados en un campo de texto o de nuevo para fijar etiquetas como los requerida Standard 508 para definir la estructura de un documento.

Figura 5-14 dilogo personalizado Propiedad

Cuando se crea una propiedad, el dilogo de propiedades sugiere algunas de las claves ms importantes de propiedad comn con un poco descripcin del significado propiedad.Para utilizar una expresin, comprobar el uso de una casilla de verificacin expresin: el rea de texto se convertir en un espacio de expresin y el botn para abrir aparecer el editor de expresiones

5.6 Elementos GrficosLos elementos grficos se dibujan objetos tales como la lnea y el rectngulo; no muestran los datos generalmente, pero se utilizan para hacer impresiones ms legible y agradable desde el punto de vista esttico. Todos los tipos de elementos tienen la pluma y el relleno propiedades.El lpiz se utiliza para dibujar una forma ( o slo las fronteras del elemento en caso de imgenes ) . Esta propiedad se edit con la pluma de dilogo (ver Figura 5-15 ) .

Figura 5-15 Pen Definicin

Es posible establecer un ancho de lnea en particular ( un ancho de lnea cero significa que no hay lneas sern pintados ) y elegir entre 4 diferentes estilos : normal , de trazos , de trazos y dobles.Por defecto, el color utilizado para pintar las lneas es el color elemento de primer plano, pero es posible anular ese valor por la especificacin de un valor diferente. Para restablecer el color del valor por defecto tiene que rearmar todo el derecho pluma clic en el elemento de la pluma en la hoja de propiedades y seleccionando Restaurar valor predeterminado.Los valores predeterminados de la pluma (como para muchas otras propiedades de los elementos comunes) dependen del elemento especfico. lneas, rectngulos y elipses tienen un ancho predeterminado de 1 pxel , mientras que para las imgenes de la anchura de lnea por defecto es cero .La propiedad de relleno tiene un nico valor posible: Slido.

5.6.1 LneaEn JasperReports , una lnea est definida por un rectngulo para el que la lnea representa la diagonal ( vase la figura 5-16) .

Figura 5-16 elemento de lnea de tipo top-down

La lnea se dibuja utilizando la configuracin del lpiz. Si no estn configurados, el color de primer plano se utiliza como el color predeterminado y una normal de 1lnea de ancho de pxel se utiliza como el estilo de lnea .La nica propiedad especfica de una lnea es la direccin de la lnea, que se utiliza para indicar cul de las dos diagonales del rectngulo representa el lnea ; los valores posibles son de arriba abajo y de abajo hacia arriba .5.6.2 RectangleEl elemento rectngulo se utiliza generalmente para dibujar marcos alrededor de otros elementos ( incluso si es preferible el uso de un elemento de marco paraeste propsito especfico con el fin de evitar elementos superpuestos ) . Al igual que el elemento de lnea , la frontera rectngulo se dibuja utilizandola configuracin del lpiz . Si no estn configurados, el primer plano se utiliza como color de (que es negro por defecto) y una lnea de ancho de 1 pxel normalesse utiliza como estilo de lnea. El fondo se llena con el color especificado con el ajuste de fondo si el elemento no ha sidodefinido como transparente.

Elemento de la figura 5-17 rectngulo con radio ajustado a 20En JasperReports , es posible tener un rectngulo con esquinas redondeadas ( vase la figura 5-17 ) . Las esquinas redondeadas se definen por mediante el atributo RADIUS, que representa el radio de curvatura de las esquinas , expresada en pxeles.

5.6.3 Ellipse

La elipse es el nico elemento que no tiene atributos que le son propias . La elipse se dibuja en un rectngulo que se acumula en el cuatro lados que son tangentes a la misma ( ver Figura 5-18 ) . La frontera se dibuja utilizando la configuracin del lpiz. Si no se establecen, la El primer plano se utiliza como el color (que es negro por defecto) y una lnea de ancho de 1 pxel normal se utiliza como estilo de lnea. El fondo es lleno de la configuracin de color de fondo si el elemento no se ha definido como transparente.

5.7 Trabajar con imgenes

Una imagen es la ms compleja de los elementos grficos (ver Figura 5-19). Se puede utilizar para insertar imgenes de trama (como GIF,PNG y JPEG) en el informe, pero tambin se pueden utilizar como un objeto de lona para hacer por ejemplo un componente Swing opara aprovechar algn cdigo de renderizado personalizado.Al arrastrar un elemento de imagen en el diseador, iReport aparece un cuadro de dilogo de seleccin de archivos. Esta es la forma ms conveniente para especificaruna imagen a utilizar en el informe. iReport no va a salvar o guardar la imagen seleccionada en cualquier lugar, slo se utilizar la ubicacin del archivo,traducir la ruta absoluta de la imagen seleccionada en una expresin para localizar el archivo cuando se ejecuta el informe. Los Lasexpresin se establece entonces como valor para la propiedad Expression Imagen. He aqu una expresin de ejemplo:"C: splashscreen.png \\ Documents and Settings \\ gtoffoli \\ \\ Escritorio"Como se puede ver, se trata de una aplicacin Java real (o Groovy o Javascript) expresin, no slo el valor de una ruta de archivo, se inicia y termina concomillas dobles y el carcter de barra invertida (\) se escaparon con otra barra invertida (\\).La Expresin Image Class define qu tipo de objeto se devuelve por la Expresin Imagen. En este caso es del tipo dejava.lang.String, pero hay varias otras opciones.Figura 5-20 resume los valores que la expresin Image Class puede adoptar y describe cmo el resultado Expresin Imagense interpreta y utiliza.

Figura 5-20 clases de expresin de imagen

Usted es libre de aadir una imagen definiendo explcitamente la ruta absoluta completa de un archivo en su expresin. En efecto, esto es una realidadforma fcil de aadir una imagen al informe , pero en general tiene un gran impacto en la portabilidad informe , ya que el archivo no se puede encontraren otra mquina (es decir , despus de desplegar el informe en un servidor web o ejecutar el informe en un equipo diferente ) . haydos mejores prcticas aqu : la primera consiste en parametrizar la expresin de imagen mediante un parmetro (posiblemente con un valor por defecto )que contiene la carpeta donde reside con sus imgenes , y luego componer la expresin con algo como:

$P{MY_IMAGES_DIRECTORY} + myImage.png

En tiempo de ejecucin en una aplicacin hipottica, el valor para el parmetro MY_IMAGES_DIRECTORY se puede ajustar por la aplicacins mismo. Si no se proporciona un valor para el parmetro, todava podemos devolver un valor por defecto (ya veremos cmo crear un parmetro yestablecer un valor predeterminado en el siguiente captulo). La ventaja de esta solucin es que la ubicacin del directorio donde las imgenesresiden no se define de forma discreta en el informe, pero se puede proporcionar de forma dinmica.La segunda opcin es utilizar la ruta de clases. La ruta de clases es un conjunto de directorios y ubicaciones de los archivos JAR en el que un Javaaplicacin (como JasperReports) busque las clases y recursos. Por lo general es fcil de aadir directorios a la ruta de clases de unaaplicacin que utiliza una mquina virtual Java. En iReport la ruta de clases se puede extender desde el cuadro de dilogo Opciones (Ventana>Opciones> iReport> rutas de clases). Cuando una imagen se encuentra en la ruta de clases, la nica informacin requerida necesitada por JasperReports aencontrar y hacen que la imagen es el nombre del recurso (que es otra vez una especie de camino, pero con relacin a un directorio de ruta de clases). Por defecto,al ejecutar un informe, iReport aade el directorio en el que reside el informe a la ruta de clases. Suponga que tiene un informe en undirectorio determinado, digamos "c: \ test \ myReport.jrxml", y en el mismo directorio que haber una imagen llamada"MyImage.png". Para usarlo en el informe se puede establecer valor de x de Expresin de imagen de ser "myImage.png". Desde el informedirectorio se aade a la ruta de clases, la imagen se encontrar automticamente.Este proceso todava es vlida si la imagen reside en un subdirectorio de un directorio incluido en la ruta de clases. En ese caso, usted necesitarpara especificar la ruta completa de recursos mediante una ruta de estilo Unix notation.For ejemplo, si su imagen reside en el directorioc: \ prueba \ images, el recurso se encontr con la expresin "/images/myImage.png". Lo que sucede aqu es queJasperReports comprobar en el directorio c: \ test (que est en la ruta de clase) si la va de recurso especificado (en este caso /existe images / myImages.png).Este mtodo para resolver la ubicacin de recursos se aplica en muchas otras partes de JasperReports, (por ejemplo, para localizar un JASPER sub-informearchivo, un paquete de recursos, una clase scriptlet y as sucesivamente).

Tiempo de evaluacin se define en ese momento de la creacin de informes de la Expresin La imagen tiene que ser procesado; de hecho, la evaluacin de una expresin se puede hacer cuando el informe motor "se encuentra con" el elemento durante la creacin del informe (evaluacin tiempo "ahora") o puede ser tambin pospuso por ejemplo, porque la imagen depende por algunos clculos que no han sido todava completadas. El tiempo de evaluacin se aplica a la evaluacin de muchas otras expresiones (como campos de texto y variables). Una explicacin ms profunda del tiempo de evaluacin es disponible en el siguiente captulo. Los valores posibles para el tiempo de evaluacin son:Ahora Evala la expresin inmediatamenteInforme Evaluar la expresin al final del informePgina evaluar la expresin al final de la pginaColumna evaluar la expresin al final de esta columnaGrupo evaluar la expresin del grupo que se especifica en Evaluacin grupoBanda evaluar esta expresin despus de la evaluacin de la banda actual (usado para evaluar expresiones que tienen que ver con los valores de retorno sub-informe)Grupo de Evaluacin Ver la descripcin de los valores de grupo anterior para el ajuste del tiempo de evaluacin. 5.8 Relleno y FronterasPara el elemento de imagen (y para los elementos de texto) es posible visualizar un marco o para definir un acolchado particular para los cuatro lados. Es un espacio entre el borde del elemento y su contenido. Fronteriza y el relleno se especifican haciendo clic derecho en el elemento (o el nodo de elemento en la vista de inspector) y seleccionando el relleno y Fronteras elemento de men. Esto abrir la cuadro de dilogo que se muestra en la Figura 5-21. Figura 5-21 Relleno y Fronteras Echemos un vistazo a las opciones restantes:Escalar la imagen Define cmo la imagen tiene que adaptarse a la dimensin de elemento; la posible los valores son tres: Clip La dimensin de la imagen no es cambiada FillFrame La imagen se adapta a la dimensin elemento (convirtindose deformada)

RetainShape La imagen se adapta a la dimensin elemento manteniendo las proporciones originales Por tipo de error Define qu hacer si la carga de imgenes falla:Error (predeterminado) emite una excepcin java detener el proceso de llenadoEn blanco la imagen no se imprime, y un espacio en blanco se coloca en el informe en su lugarIcono un icono se imprime en lugar de la imagen originalEs perezoso evitar la carga de la imagen en tiempo de llenado, se cargar la imagen cuando el informe exportado: es til cuando una imagen se carga desde una URLEl uso de cach Permite guardar la imagen en la memoria con el fin de utilizarlo de nuevo si el elemento est impreso recientemente; la imagen se mantiene en la memoria cach slo si la imagen Clase Expression se establece en java.lang.StringLa alineacin vertical Define la alineacin vertical de imagen de acuerdo a la zona de elemento; los las los valores posibles son:Arriba la imagen se alinea en la parte superior Medio la imagen se pone en el medio verticalmente de acuerdo con el rea del elementoParte inferior de la imagen se alinea en la parte inferiorAlineacin horizontal este atributo define la alineacin horizontal de la imagen de acuerdo con el elemento la zona; los valores posibles son:Izquierda Sali de la imagen se alinea a la izquierdaCentrar la imagen se coloca en el centro horizontal de acuerdo con el rea del elementoDerecho en la imagen est alineado a la derecha

Como siempre, todas las medidas deben establecerse en pxeles.Los cuatro lados de la frontera se pueden modificar individualmente seleccionndolos en el cuadro de vista previa. Cuando no se seleccionan lados, los cambios se aplican a todos ellos.

5.9 Cargando una imagen de la base de datos (BLOB Field)Si usted necesita para imprimir las imgenes que se almacenan en una base de datos (es decir, utilizando una columna BLOB) lo que tiene que hacer es asignar el campo que obtendr el valor BLOB tipo java.awt.Image (campos de informe se explicarn en el captulo siguiente). Crear una imagen elemento arrastrando la herramienta de elemento de imagen de la paleta en el diseador (es decir, en la banda de detalle), cancele cuando el selector de archivos solicita; en la imagen de las propiedades del elemento de hoja de cambiar la expresin Image Class a java.awt.Image y conjunto como expresin de imagen del objeto de campo (es decir $ F {MyImageField}).

5.10 Creacin de una imagen dinmicaPara crear una imagen dinmica requiere algunos conocimientos de Java. Aqu vamos a mostrar la mejor solucin para modificar o crear una imagen a imprimir en un informe.Hay varias maneras de crear una imagen dinmica en JasperReports. La primera opcin es escribir una clase que produce una java.awt.image objeto y llamar a un mtodo de esta clase en la expresin de imagen del elemento de imagen. La expresin hara parece:

MyImageGenerator.generateImage()

Donde MyImageGenerator es una clase con el mtodo esttica generateImage() que devuelve el objeto java.awt.Image.El problema con esta solucin es que, puesto que la imagen creada sera una imagen de trama con un especfico con y altura, en el resultado final podra haber all una prdida de calidad, sobre todo cuando el documento est ampliada, o cuando el resultado final es un archivo PDF presentar.En trminos generales, el mejor formato de una imagen que se debe dejar en un documento es un SVG, que proporciona una imagen de alta calidad, independientemente de la resolucin captura original. Con el fin de facilitar la generacin de una imagen personalizada, JasperReports ofrece una interfaz llamado JRRenderable que un desarrollador puede aplicar para obtener el mejor resultado de renderizado. Una clase prctica de la instruccin inicialEl uso de este interfaz es JRAbstractSVGRenderable. El nico mtodo para aplicar aqu es:public void render (Graphics2D G2D, Rectangle2D rect)