Manual De Ireport V10.1.0.0 3m2s70

)? : . Es extremadamente útil, y la buena noticia es que puede ser recursivo, lo que significa que el valor de verdadero y falso puede ser representado por otra expresión que puede ser una nueva condición: (($F{name}.length() > 50) ? (($F{name}.startsWidth(“A”)) ? “AAAA” : “BBB”):$F{name}) Esta expresión devuelve el String " AAAA " cuando el valor del nombre del campo tiene más de 50 caracteres y comienza con A, devuelve " BBB " si se trata de más de 50 caracteres , pero no comienza con A, y, por último , devuelve el valor del campo original, si ninguno de los dos estas condiciones es verdadera . A pesar de la posible complejidad de una expresión (que tienen múltiples instrucciones de ifelse y así sucesivamente), que puede ser insuficiente para definir un valor necesario. Por ejemplo, si desea imprimir un número en números romanos o devolver el nombre del día de la semana de una fecha, es posible transferir las elaboraciones a un método de una clase externa en Java, que debe ser declarado como estático, como se muestra: MyFormatter.toRomanNumber ($F {MyInteger}.intValue())

La función toRomanNumber es un método estático de la clase MyFormatter, que toma un int como argumento (la conversión de Integer a int se hace por medio del método intValue (); que sólo se requiere cuando se utiliza Java como el lenguaje) y devuelve la versión romana del número. Esta técnica se puede utilizar para muchos propósitos; por ejemplo, para leer el texto de un campo CLOB o para agregar un valor en un HashMap (un conveniente objeto de Java que representa un conjunto de pares llave / valor).

Capítulo 4. Estilos Se puede ahorrar tiempo al definir el aspecto de los elementos, incluido todos los ajustes de fuente, mediante el uso de estilos. Un estilo es un conjunto de propiedades predefinidas que se refieren al aspecto de los elementos (como el color de fondo, los bordes, y la fuente). En lugar de continuamente seleccionar los ajustes individuales, se puede definir un estilo predeterminado del informe, y todas las propiedades no definidas de sus elementos referirse a ella.

4.1 Trabajo con estilos El Inspector de reporte muestra los estilos disponibles en la vista de esquema, en el nodo etiquetado estilos. Para crear un nuevo estilo, clic derecho en el nodo Estilos y seleccione Agregar estilo en el menú contextual (vea la Figura 4-1).

Figura 4-1: Añadir un nuevo estilo al documento

Para un estilo se pueden definir muchas propiedades, que se muestra en la hoja de propiedades (Figura 4-2). El único valor de la propiedad de un estilo que se debe establecer es Nombre. Todas las demás propiedades son opcionales.

Deja el valor por defecto como está cuando no se desea establecer un valor específico para una propiedad. Para restaurar el valor por defecto, haga clic en el nombre de la propiedad y

seleccione Restablecer al valor por defecto. (Esto funciona con todas las propiedades de los elementos que soportan un valor por defecto.)

Figura 4-2: Todas las propiedades de un estilo

Para aplicar un estilo a un elemento, seleccione el elemento y establezca el estilo deseado en la hoja de propiedades (Figura 4-3).

Figura 4-3: Propiedad estilo de un elemento

Usted puede elegir un estilo específico que es el estilo predeterminado para el informe. Al establecer un estilo predeterminado, todas las propiedades de los elementos que tenga un valor no especificado heredará implícitamente su valor desde el estilo por defecto.

4.2 Creación de Condiciones de Estilo El reporte se puede diseñar, de modo que un estilo cambie dinámicamente. Por ejemplo, se puede establecer el color de primer plano (foreground) de un campo de texto para negro si un valor particular es positiva y rojo cuando es negativo. IReport crea estilos condicionales derivados de un estilo ya existente, para el que se crean las condiciones y se cambia algunas propiedades.

Para aplicar una condición a un estilo, haga clic en el nodo de estilo y seleccione Agregar Estilo condicional (vea la Figura 4-4).

Figura 4-4: Definición de un estilo condicional

Se puede volver a configurar todos los valores del estilo principal. Los nuevos valores se utilizaran en lugar de los definidos en el padre cuando la condición sea verdadera. El nuevo estilo condicional aparecerá en la vista de esquema. Tiene que establecer la condición (en realidad un Expresión que devuelve un valor booleano) que será evaluada durante la prestación de los elementos que utilizan el estilo. En la condición de expresión se pueden utilizar todas las propiedades del objeto de informe. Por favor, tenga en cuenta que las condiciones no pueden ser genéricos, por ejemplo, no se puede establecer una condición como "si el número es positivo" o "si la cadena es nula." Tienes que ser muy específico, especificando, por ejemplo, que un valor particular (campo, parámetro, variable o cualquier expresión que implique ellos) debe ser positivo o nula, y así sucesivamente.

Un estilo puede tener un número arbitrario de estilos condicionales. Un buen ejemplo de esto sería el diseño de un reporte para mostrar una campo determinado en un color diferente (digamos, dependiendo del número total de pedidos realizados). Se podría establecer que el color de primer plano sea rojo en el estilo de base, a continuación, agregar un estilo condicional que donde utilice que cuando la variable $ {V total_orders} sea menor que el 5 que el color sea rojo, y establecer otro estilo condicional con el color de primer plano en amarillo cuando el mismo valor este entre 6 y 10, y el verde para otro estilo condicional para cuando el número de orden sea mayor que 20.

Figura 4-5: Color alternado para cada fila

Veamos un ejemplo de uso de un estilo condicional para lograr el efecto de tener un fondo alterno para cada fila. El efecto se muestra en la Figura 4-5.

El truco es bastante simple. El primer paso es agregar un elemento de marco en la banda de detalle. El marco contendrá todos los elementos de la banda, por lo que estamos utilizando la trama como si fuera el fondo de la propia banda; De hecho, el marco debe tomar todo el espacio disponible en la banda. Entonces todos los campos de texto serán colocados en el interior del marco (véase la Figura 4-6 y la Figura 4-7).

Figura 4-6: Todos los elementos se colocan en el interior del marco

Figura 4-7: La vista de esquema muestra la jerarquía de los elementos

Esto debe quedar particularmente claro mirando la vista de esquema (Figura 4-7). Primero definimos un nuevo estilo (llamémoslo Style1). Vamos a dejar todos los valores por defecto, ya que no estamos interesados en cambiar cuando el número de fila sea impar (1, 3, 5, etc...). Ahora añadimos un estilo condicional y establecemos como condición la expresión: ($V {REPORT_COUNT} % 2) == 0

Lo que la expresión hace es calcular el resto del conjunto por 2 (el operador % tiene esta función). Tenemos que ver si el resto es 0. Si lo es, el número de fila actual (en poder del

variable incorporada) es par, se utiliza el estilo condicional Style1. Para este estilo, establecemos la propiedad de fondo a un gris claro (o cualquier otro color de nuestra elección) y marcar la propiedad opaco (de lo contrario la propiedad anterior no tendrá efecto). Finalmente, se aplica el estilo al elemento de marco al seleccionar el marco y estableciendo la propiedad estilo a Style1. REPORT_COUNT

Ejecute el informe. Los resultados deben ser exactamente lo que se presenta en la Figura 4-5.

4.3 Creación de una nueva plantilla Vamos a ver cómo crear y utilizar una plantilla personalizada desde cero, a partir de un informe vacío. En este ejemplo, vamos a crear una plantilla tabular llamada ejemplo_plantilla.jrxml. El nombre del archivo se utiliza como el nombre de la plantilla en el Asistente del Informe. Una vez que se crea el nuevo informe, vamos a añadirle cuatro grupos con nombre, Grupo 1, Grupo 2, Grupo 3 y Grupo 4, y las bandas de encabezado y pie de página. Los nombres de grupo pueden ser arbitrarios, pero es una buena práctica para el diseño de la plantilla establecer un número.

En primer lugar, vamos a crear el archivo JRXML. En el menú principal, haga clic en Nuevo y seleccione un informe vacío. Para crear un grupo, haga clic en el nodo raíz del reporte en el Inspector de Reporte y haga clic en Agregar Grupo al Reporte. La expresión de grupo puede estar vacío; el asistente creará un valor adecuado para ello si se requiere uno. La Figura 4-8 muestra un diseño simple con los cuatro grupos.

Figura 4-8: Reporte vacío con 4 grupos

Es momento de añadir los elementos de plantilla necesarios en la cabecera de grupo y bandas de detalle. Añadir un elemento de etiqueta en todas las cabeceras de grupo, ajustando una etiqueta de texto y un elemento de campo de texto como expresión del campo. En la Figura 49, las etiquetas y el campo de texto utilizan la sintaxis GnLabel y "GnField". La plantilla que estamos trabajando es un tipo de tabla, por lo que necesitamos proporcionar una etiqueta

elemento en el encabezado de la columna y un campo de texto en la banda de detalle (con el texto DetailLabel y la expresión "DetailField", respectivamente).

Figura 4-9: Su plantilla personalizada

La parte obligatoria se hace ahora, para que pueda proceder a la adición de algunos gráficos para conseguir una plantilla completa.

4.3 Instalación y Uso de la nueva plantilla Ahora que hemos creado el JRXML para la nueva plantilla, hay que añadirlo a la lista de plantillas disponibles. Haga clic en Herramientas → Opciones, vaya a la sección iReport, y seleccione la `pestaña Asistente para plantillas. En la pestaña, agregar el nuevo archivo (Figura 4-10).

Figura 4-10: Nueva plantilla agregada a la lista en el asistente

Una última opción es poner la plantilla en el directorio de plantillas de iReport.

Vamos a tratar de crear un archivo con la nueva plantilla. La nueva plantilla aparece en el selector de plantillas.

Figura 4-11: Nueva plantilla agregada en el Selector de plantillas

Seleccione la nueva plantilla (ejamplo_plantilla) e iniciará el asistente, siguiendo los pasos para crear un nuevo informe (2.4, "Creación de su primer informe"). Para probar la plantilla correctamente, debe utilizar todos los grupos en el asistente. La figura 4-12 muestra el informe que resulta:

Figura 4-12: Reporte creado con la nueva plantilla

Si el resultado es correcto, podemos producir una imagen que se utilizará como una vista previa (formato PNG o GIF). En el modo de vista previa (Figura 4-12), haga clic en el icono para guardar la imagen de la página actual. La imagen debe estar guardado en el mismo directorio que la plantilla y se le debe dar el mismo nombre que la plantilla (además de la extensión. png o. gif). Abrir el selector de plantillas de nuevo, debería ver la imagen en miniatura de la plantilla.

Capítulo 5. Subreportes Los subreportes representan una de las características más avanzadas de JasperReports. Permiten el diseño de informes muy complejos creados mediante la inserción de uno o más reportes en otro reporte. Todos los informes tienen que ser creados con modalidades similares. Usted ha visto que para generar un informe que necesita tres cosas: un archivo de Jasper, un mapa de parámetros (que puede estar vacía) para establecer un valor para los parámetros del informe, y una fuente de datos (o una conexión JDBC) que puede estar vacío. En este capítulo, voy a explicar cómo pasar estos tres objetos al subreporte a través del informe padre y cómo crear conexiones dinámicas que son capaces de filtrar los registros del subreporte basado en los datos del reporte padre. Este capítulo tiene las siguientes secciones:    

Crear un subreporte Un ejemplo paso a paso Devolución de valores de un informe integrado Uso del Asistente para subreportes

5.1 Creación de un subreporte Como se señaló anteriormente, un subreporte es simplemente un informe compuesto por su propia fuente JRXML y compilado en un archivo Jasper. En términos generales, la creación de un subreporte es muy similar a la creación de cualquier otro informe. Hay que prestar atención sólo a los márgenes de impresión, que se establecen por lo general a cero para subreportes porque un subreporte está destinado a ser una parte de una página, no un documento entero. La dimensión horizontal de la subreporte debe ser tan grande como el elemento en el que se coloca en el reporte padre. Para insertarlo, se utiliza el elemento de la paleta Subreporte (Figura 5-1).

Figura 5-1: Subreporte en la paleta

En tiempo de diseño del elemento se representa como un rectángulo (Figura 5-2).

Figura 5-2: Subreporte insertado en la banda de Detalles

No es necesario que el elemento de subreporte sea exactamente tan grande como el informe que vamos a utilizar como subreporte; las dimensiones del elemento no son realmente significativas porque el subreporte ocupará todo el espacio que necesita. Usted puede pensar en el elemento de subreporte como marcador de posición que define la posición de la esquina superior izquierda en la cual el subreporte se alineará. Sin embargo, para evitar resultados inesperados, siempre es mejor ser precisos.

5.1.1 Vincular un subreporte al reporte padre Para vincular el subreporte al informe de los padres tiene que definir tres cosas:   

Cómo recuperar el objeto Jasper que implementa el subreporte. Cómo alimentar al objeto con datos. Cómo establecer los valores de los parámetros del subreporte.

Toda esta información se puede definir a través de la hoja de propiedades de elemento de subreporte. (Figura 5-3)

Figura 5-3: Vista de propiedades del elemento Subreporte

En primer lugar, echemos un vistazo a cómo se establecen los parámetros del subreporte.

5.1.2 Especificación del subreporte Cuando añadimos un subreporte a un informe, tenemos que conocer la ubicación del archivo de Jasper que vamos a utilizar para generar el subreporte. Nosotros indicamos a JasperReports como localizar el archivo u objeto estableciendo la expresión subreporte. Como en muchos otros contextos en los que las expresiones están involucrados, tenemos que establecer su tipo, es decir, el tipo de objeto devuelto por la expresión. Es fácil de imaginar que JasperReports actuará de manera diferente según el tipo de expresión. El tipo se fija especificando un valor para la propiedad Clase de Expresión. Se debe seleccionar en el desplegable (Figura 5-3). La Tabla 5-1 enumera los posibles tipos de objetos. Tabla 5-1 Posibles valores para una Expresión de Subreporte Valor

Explicación

net.sf.jasperreports.engine.JasperReport

El archivo Jasper pre-cargado en JasperReport. Una corriente abierta del archivo Jasper.

java.io.InputStream java.net.URL

un

objeto

java.io.File

Un archivo URL que identifica la ubicación del archivo de Jasper. Un objeto de archivo que identifica el archivo de Jasper.

java.lang.String

El nombre del archivo de Jasper.

Si la expresión es una cadena (java.lang.String), JasperReports asumirán que el subreporte se debe cargar desde un archivo Jasper y tratará de localizar el archivo de la misma forma que se encuentran los recursos. Específicamente, la cadena se interpreta en un principio como un URL. En caso de fallo (un MalformedURLException será devuelto), la cadena se interpreta como una ruta física a un archivo; si el archivo no existe, la cadena se interpreta como un recurso ubicado en la ruta de clases. Esto significa que el uso de una expresión de tipo String significa que está de alguna manera tratando de especificar una ruta de archivos; opcionalmente, puede poner su archivo de Jasper en la ruta de clases y se refieren a ella como un recurso (es decir, su expresión será algo así como “subreporte.jasper”, suponiendo que el directorio que contiene el archivo subreporte.jasper está en la ruta de clases). El primer paso en la configuración de un elemento de subreporte debería estar claro: crear una expresión que se puede utilizar para cargar el objeto Jasper que debe utilizarse para completar la parte del subreporte en el documento. Por experiencia, el 99 por ciento de las veces será un archivo Jasper almacenado en algún lugar del sistema de archivos. Por lo tanto, si estamos cargando el subreporte desde el sistema de archivos, sugiero dos opciones para hacer el la vida del diseñador y el desarrollador un poco más fácil. Ambos son muy similares a los utilizados cuando se hizo referencia a las imágenes.





Primero, coloque el archivo subreporte en un directorio que se encuentra en la ruta de clases. Esto le permite utilizar expresiones de subreportes muy sencillas, como una cadena que contiene sólo el nombre del archivo subreporte (es decir, “subreporte.jasper”). iReport siempre incluye la ruta de clases al directorio del informe que se está ejecutando, por lo que todos los archivos de subreporte Jasper se pueden encontrar fácilmente si se encuentran en el mismo directorio. Segundo, parametrizar la ubicación del archivo Jasper y crear sobre la marcha la ruta absoluta real del archivo a cargar. Esto puede ser logrado con un parámetro que contiene el directorio principal del subreporte ( llamémoslo SUBREPORT_DIRECTORY ) y una expresión como esta: $P {SUBREPORT_DIRECTORY}

+ “subreporte.jasper”

5.1.3 Especificación del origen de datos Para que JasperReports recupere los datos y llene el subreporte, hay que configurar la fuente de datos del subreporte. Por lo general, tenemos tres opciones:  



Utilice una consulta SQL y la misma conexión JDBC como padre (caso súper fácil ); o Use otro tipo de fuente de datos (por ejemplo, un archivo XML) y algunos elementos de orígenes de datos para crear una expresión o pasar la instancia de origen de datos necesaria. En circunstancias muy especiales, podemos no pasar ningún dato al subreporte. Vamos a explicar esta última opción en profundidad ya que proporciona una forma de simular la inclusión de partes estáticas de los documentos (como encabezados, pies de página, fondos, etc.).

Las conexiones JDBC hacen el uso de subreportes bastante simple. Una expresión de conexión debe identificar un objeto java.sql.Connection. Por lo general, se ejecuta la consulta SQL usando la misma conexión de base de datos como que el reporte padre; la conexión puede ser referenciada con el parámetro integrado REPORT_CONNECTION .Debe quedar claro que si se pasa una conexión JDBC para el subreporte, es porque hemos definido una consulta SQL en el subreporte, una consulta que se utiliza para llenarlo. El uso de una fuente de datos diferente a veces es necesario cuando no se está utilizando una conexión como JDBC; es más complicado pero muy potente. Se requiere escribir una expresión de origen de datos que devuelva una instancia JRDataSource que será utilizada para llenar el subreporte. Dependiendo de lo que quiere lograr, se puede pasar la fuente de datos que alimentarán el subreporte a través un parámetro, o puede definir el origen de datos de forma dinámica cada vez que sea necesario. Si el informe de los padres se ejecuta utilizando una fuente de datos, esta fuente de datos se almacena en el parámetro integrado REPORT_DATASOURCE. Por otro lado, el REPORT_DATASOURCE nunca debe ser usado para alimentar a un subreporte; una fuente de datos es un objeto consumible que es utilizable para la alimentación de un informe sólo una vez. Por lo tanto, la técnica de parámetro no es adecuado cuando todos los registros del informe principal tienen su propio subreporte (a menos que haya

un solo registro en el informe principal). Cuando hablamos de las fuentes de datos se verá cómo este problema se resuelve fácilmente con fuentes de datos personalizadas.

5.1.4 Paso de Parámetros Cuando un informe se invoca desde un programa (usando uno de los métodos fillReport, por ejemplo), se pasa un mapa parámetros para darle valores a sus parámetros. Un enfoque similar se utiliza para definir el valor de los parámetros del subreporte. Con los subreportes no hay que definir un mapa (incluso, si es posible, la especificación de un Mapa Expresión de Parámetros). El motor de reportes se hará cargo de eso, pero usted todavía puede crear un conjunto de pares de parámetros nombre/ objeto que será utilizado para establecer los valores de los parámetros del subreporte. La principal ventaja de un mapa de parámetros es que los valores se pueden proporcionar como expresiones, haciendo el mapa potencialmente dinámico. Los parámetros del subreporte se establecen mediante la propiedad Parámetros (ver Figura 5-3). Haga clic en el botón para que aparezca el diálogo de parámetros (ver Figura 5-4). La interfaz se explica por sí: haciendo clic en el botón Añadir, aparecerá un cuadro de diálogo en el que puede agregar parámetros que alimentarán el mapa los parámetros del subreporte.

Figura 5-4: Parámetros del subreporte

El nombre de parámetro tiene que ser el mismo que el declarado en el subreporte. Los nombres distinguen entre mayúsculas y minúsculas, así que la capitalización cuenta. Si comete un error

al escribir el nombre o el parámetro insertado no se ha definido, no se genera ningún error (pero probablemente algo no funcionará, y usted se quedará pensando por qué). En el campo Expresión en el diálogo de parámetros del subreporte, debe proporcionar una expresión estándar JasperReports en el que se puede utilizar los campos, parámetros y variables. El tipo de retorno tiene que ser congruente con el tipo de parámetro declarado en el subreporte; de otro modo, una excepción de ClassCastException se producirá en tiempo de ejecución. Uno de los usos más comunes de los parámetros del subreporte es pasar la clave de un registro impreso en el informe padre con el fin de ejecutar una consulta en el subreporte a través del cual se puede extraer de los registros a que se refiere encabezados y líneas. Por ejemplo, digamos que usted tiene en el informe principal un conjunto de clientes, y desea mostrar información adicional sobre ellos, tales como su información de o. Los subreportes utilizarán el ID de cliente para obtener la información de o. El ID de cliente se debe pasar al subreporte como parámetro y su valor va a cambiar para cada registro en el informe principal. Según se cita a continuación, usted tiene la opción de proporcionar directamente un mapa de parámetros para ser utilizado con el subreporte; el Mapa Expresión de Parámetros le permite definir una expresión, el resultado de los cuales debe ser un objeto java.util.Map. Es posible, por ejemplo, preparar un mapa diseñado para el subreporte en la aplicación, pasarlo al informe principal utilizando un parámetro y utilizar este parámetro como una expresión (por ejemplo, $ P {myMap}) para pasar el mapa al subreporte. También es posible pasar al subreporte el mismo mapa de parámetros que se proporcionó al reporte padre mediante el parámetro integrado REPORT_PARAMETERS_MAP. En este caso la expresión es: $ P {REPORT_PARAMETERS_MAP} Puesto que los parámetros del subreporte se pueden utilizar en conjunto con este mapa, usted puede incluso utilizarlo para pasar parámetros comunes, tales como el nombre del que ejecuta el informe.

5.2 Un ejemplo paso a paso Vamos a poner en práctica lo que has aprendido hasta ahora. Digamos que usted quiere imprimir una lista de los países que han hecho pedidos y usar un subreporte con la lista de clientes en cada país. Vamos a utilizar una conexión JDBC a la base de datos de muestra de JasperReports; las únicas tablas involucradas son orders (para extraer los países) y address (para la información de los clientes). Por favor, tenga en cuenta que el informe que estamos creando podría realizarse sin necesidad de utilizar un subreporte, pero simplemente estamos tratando de mantener las cosas simples para ilustrar el procedimiento. 1. Primero, cree un nuevo reporte vacío llamado master.jrxml. Vamos a suponer que la conexión activa es a la base de datos de muestra JasperReports.

2. Ajuste la consulta de la siguiente manera; que está diseñada para extraer los nombres de países, ordenadas por nombre: select distinct shipcountry from orders order by shipcountry 3. El campo SHIPCOUNTRY debe aparecer en la vista de esquema. Arrastre el campo a la banda de detalle, ajuste del campo de texto y el tamaño de la fuente (Figura 5-5).

Figura 5-5: Campo SHIPCOUNTRY en la banda de Detalles

4. Pruebe el reporte haciendo clic en el botón Vista previa. Usted debe obtener algo similar a la Figura 5-6.

Figura 5-6: Lista de países

A continuación, vamos a crear el reporte que se utilizará como subreporte. El subreporte debe tener las siguientes características:

  

Sin márgenes (esto no es obligatorio, pero por supuesto que no son necesarios). Ningún parámetro debe tener el nombre del país. La anchura debe ser congruente con el espacio que queremos reservar para este en el informe principal; vamos a utilizar todo el ancho de la página menos los márgenes.



Un conjunto de campos de texto en la banda de detalle para mostrar el nombre y apellido de cada cliente.

1. Crear un nuevo reporte vacío llamado subreport.jrxml (si tienes que elegir un nombre diferente, tenerlo en cuenta, porque lo vamos a utilizar cuando se conecte el reporte principal al subreporte). 2. Eliminar los márgenes de la página y ajustar el ancho de página(es decir, una página A4 tiene un ancho de 595 píxeles, restando 20 píxeles del margen izquierdo y 20 del derecho, la nueva página debe establecerse en un ancho de 555 píxeles con márgenes de 0). 3. Añadir al presente reporte un parámetro que llamaremos PAÍS. El tipo debe ajustarse a java.lang.String y el valor por defecto a una cadena en blanco (“”) o, si lo prefiere, a un nombre de país como “Argentina”. Este valor predeterminado se puede anular con lo que sea que especificamos en el informe principal. Estamos asignándole al parámetro ahora sólo un valor predeterminado en iReport (no en JasperReports) porque es obligatorio cuando se utiliza un parámetro dentro de una consulta de reporte. 4. Abra el diálogo de consulta y escriba la consulta para seleccionar la información de los clientes basados en el orden de los países; puede ser algo como esto:

select distinct shipname, shipcity from orders where shipcountry =$P{PAÍS} Estamos recibiendo todas las distintas direcciones de los clientes que hacen pedidos en el país representados por el parámetro PAÍS. 5. iReport debería detectar los siguientes campos: SHIPNAME y SHIPCITY. 6. Pongamos ambos campos en la banda de detalle del reporte (Figura 5-7)

Figura 5-7: Diseño del subreporte

Ahora tenemos que probar este reporte. Tenemos que probar la forma en que iReport genera el archivo Jasper que necesitamos cuando utilizamos este informe como un subreporte. Cuando se ejecuta, preste atención a lo que muestra iReport en la vista de la consola (Figura 5-8). En particular, prestar atención a la ubicación donde se ha almacenado el archivo Jasper. De forma predeterminada, debe estar en la misma ubicación en la que ha guardado el archivo JRXML. En este ejemplo, he usado el mismo directorio para las plantillas del reporte principal y el subreporte, así que contendrá ambos master.jasper y subreport.jasper.

Figura 5-8: Salida de la ejecución del subreporte

Dependiendo del valor de PAIS, se puede obtener un informe vacío o un informe que muestra algunos artículos. No importa mucho en este punto, sólo comprobar que se generó el archivo Jasper. Lo que tenemos ahora son dos informes: el maestro que muestran los nombres de los países, y el que pronto será un subreporte, que muestra la los clientes de un país en particular. Vamos a ponerlos juntos.

Figura 5-9: Asistente de Subreporte

Al agregar un elemento de subreporte, el Asistente para Subreportes aparece (Figura 5-9). Cuando todos los conceptos sobre el uso de subreportes están claras, el asistente le proporciona una manera de ahorrar algo de tiempo. Sin embargo, por ahora vamos a omitir el asistente. 1. En el asistente, seleccione la opción Sólo crear el elemento de subreporte y haga clic en Terminar.

Figura 5-10: Elemento de subreporte en la banda de detalles

2. Ajuste el elemento de subreporte para utilizar todo el tamaño horizontal de la banda. La dimensión vertical no es importante porque, al imprimir el informe, JasperReports usará todo el espacio vertical necesario, sin importar el tamaño de elemento (ver Figura 5-10). 3. Seleccione el elemento de subreporte para que la hoja de propiedades muestre sus propiedades (Figura 5-11).

Figura 5-11: Propiedades del subreporte

4. Queremos utilizar la misma conexión de base de datos que se utiliza en el informe principal para rellenar el subreporte, por lo que pusimos en el la propiedad Tipo de conexión el valor Utilizar una expresión de conexión. La expresión será sólo $P {REPORT_CONNECTION}. Como se ha explicado, REPORT_CONNECTION es un parámetro integrado que hace referencia a la conexión utilizada en el informe.

5. A continuación, definir la expresión subreporte; esta es utilizada por JasperReports para localizar el informe que se inserta como un subreporte. Suponiendo que el archivo Jasper del

subreporte está en la ruta de clases (de una perspectiva iReport es suficiente que esté en el mismo directorio que el informe principal), la expresión vamos a utilizar es la siguiente: “subreport.jasper” 6. Finalmente, dado que el subreporte que estamos utilizando requiere el parámetro PAÍS, agregue un parámetro del subreporte (haciendo clic en el botón “…” de la propiedad Parámetros). Haga clic en Agregar y configure el nombre del parámetro de subreporte a PAÍS (el nombre debe coincidir con el nombre del parámetro que hemos definido en el subreporte); como expresión para el valor, elegimos el campo que contiene el nombre del país, es decir, $F {SHIPCOUNTRY}. 7. Vista previa del reporte. Si todo se ha hecho correctamente, usted debe obtener un resultado como el que se muestra en la Figura 5-12.

Figura 5-12: Resultado final

En este ejemplo hemos creado un informe básico y un subreporte. El número de subreportes que se puede colocar en un informe es ilimitado, y pueden ser utilizados de forma recursiva, lo que significa que uno subreporte puede contener otros subreportes. Usted puede crear muy subreporte s pequeños (sólo un campo de texto) y usarlos para buscar los valores, puede utilizar un diseño de página con dos subreportes uno al lado del otro que muestren dos listas diferentes de valores, y así sucesivamente.

Cuando usted tiene varios subreportes, uno tras otro, asegúrese de configurar el tipo de posición del elemento de informe a Float. De esta manera, se evita el riesgo de solapamiento de los subreportes cuando el espacio que requieren crece. Otra sugerencia es que, al utilizar los subreportes, uno tras otro, coloque cada subreportes en una banda diferente, la división de la banda de detalle utilizando lo que se llama un “grupo falso”. Este es un grupo que tiene como expresión, por ejemplo, el parámetro REPORT_COUNT, que asegura que obtendrá el encabezado de grupo falso y bandas de pie de página para cada detalle. De esta manera, usted optimizar la generación de informes.

5.3 Retornando valores desde un subreporte En un informe, a menudo es útil obtener el resultado de algún tipo de cálculo que se ha realizado en un subreporte (por ejemplo, el número de registros). JasperReports ofrece una función que permite a los s recuperar los valores desde el interior de subreporte. Este mecanismo funciona del mismo modo que el paso de parámetros de entrada para los subreportes. La idea es guardar los valores calculados durante el llenado del subreporte en variables en el informe principal. Las vinculaciones entre los valores calculados y las variables locales se pueden establecer en el subreporte la propiedad del subreporte Valores de Retorno. Vamos a ver cómo usarlo con la muestra que hemos creado en la sección anterior. Supongamos que queremos imprimir en el informe principal el número de ciudades que hemos encontrado para cada país. Desde la perspectiva del subreporte, este valor está representado por la variable REPORT_COUNT, que no es accesible directamente desde el informe principal. Así que el primer paso es crear una variable para albergar este valor al final de la elaboración del subreporte. La variable debe ser consistente con el valor que almacenará. En este caso, es un número entero. 1. En el informe principal, crear una nueva variable (llamémosla SUBREPORT_COUNT) que sea de tipo java.lang.Integer y tipo de cálculo del Sistema. 2. Seleccione el elemento de subreportes y abra el diálogo de propiedades Valores de Retorno haciendo clic en el botón correspondiente “…” Figura 5-13).

Figura 5-13: Diálogo de Valores de retorno

3. Haga clic en el botón Agregar para crear el nuevo valor de retorno y aparecerá el diálogo Agregar/Modificar variable (Figura 5-14).

Figura 5-14: Diálogo de Agregar/Modificar variable

4. Seleccione un valor calculado a partir de las variables integradas del subreporte (REPORT_COUNT), así como la variable local que contendrá los valores devueltos por la variable (SUBREPORT_COUNT). 5. A continuación, seleccione un tipo de cálculo. Si desea que un valor de un subreporte sea

devuelto tal como es, seleccione el tipo Nada. De lo contrario, varios tipos de cálculo pueden ser seleccionados. Por ejemplo, si el valor deseado es el promedio de la cantidad de registros dentro de un informe integrado que se invoca repetidamente, establezca el tipo de cálculo a Promedio. El valor que viene del subreporte sólo está disponible cuando se imprimen todas las bandas que contiene el subreporte. Si necesita imprimir este valor utilizando un campo de texto colocado en la misma banda que el subreporte, defina el Tiempo de evaluación del campo de texto en Banda (Figura 5-15).

Figura 5-15: Un campo de texto que muestra un valor de retorno del subreporte

La vista previa del reporte debe ser así (Figura 5-16):

Figura 5-16: Resultado final

5.4 Uso del Asistente de Subreporte Para simplificar la inserción de un subreporte, un asistente para la creación de subreporte se inicia automáticamente cuando se agrega un elemento subreporte a un informe.

Figura 5-17: Asistente para la creación de subreportes

Usted puede utilizar el Asistente de Subreporte, que se muestra en la Figura 5-17, para crear un nuevo informe que será referenciado como subreporte o para hacer referencia a un informe existente. En este último caso, si el informe que usted elija contiene uno o más parámetros, el asistente proporciona una manera fácil de definir valores para ellos.

5.4.1 Crear un nuevo reporte mediante el Asistente de Subreporte Si va a agregar un subreporte al informe actual, el Asistente de Subreporte puede crear el informe que se utilizará como subreporte. Los pasos para crear el nuevo informe son muy similares a los que se siguen en el Asistente para informes: 1. Seleccione una conexión u origen de datos. Si el origen de datos requiere una consulta (tales como JDBC o una conexión Hibernate), puede escribir en el área de texto o cargarlo desde un archivo. 2. Seleccione los campos. 3. Defina agrupación. 4. Seleccione el diseño. 5. Defina la expresión de subreporte. 6. Defina la expresión de conexión.

La expresión de subreporte se utiliza para hacer referencia al archivo Jasper del subreporte. El asistente le permite hacer esto de dos maneras:



Guarde la parte de la ruta de la URL subreporte en un parámetro, como se muestra en la Figura 5-18, para que sea modificable en tiempo de ejecución estableciendo un valor diferente para el parámetro (el camino del subreporte es el valor predeterminado); o



Guardar la ruta completa en la expresión.

Figura 5-18: Expresión de Subreporte

Si elige la segunda opción, la expresión almacenará toda la ruta absoluta al archivo Jasper del subreporte. Esto asegura que todo va a trabajar en iReport, pero no es muy conveniente en otros entornos. Por esta razón, sugiero que modifique la expresión utilizando el método que descrito en la sección 5.1.2 “Especificación del subreporte”. El subreporte no se compila al crearlo. Para probar su informe, primero debe obtener una vista previa. Esto obliga a ser compilado. Cuando se crea un nuevo subreporte, no puede especificar los parámetros utilizando el asistente. Usted será capaz de añadir parámetros y utilizar en la consulta subreporte después que el informe se crea. Así que en este punto, para filtrar la consulta subreporte siga estos pasos: 1. Añadir un parámetro al informe que implementa el subreporte.

2. Utilice este parámetro en la consulta con la típica sintaxis $ P {MyParam} (o $!P {MyParam} si el parámetro debe ser concatenado con la consulta como está). 3. En el informe principal, seleccione el elemento de subreporte y añadir una entrada en la lista de parámetros del subreporte. El nuevo parámetro del subreporte debe ser llamado, como la contraparte en el subreporte, y su valor debe ser definido mediante una expresión (véase el sección 5.1.4, “Paso de parámetros). 4. Si el subreporte no se basa en una sentencia de SQL o una consulta HQL, aún tiene que establecer la expresión del origen de los datos del subreporte para ejecutar correctamente su informe. 5. Como se mencionó anteriormente, puede utilizar el Asistente de Subreporte para crear un nuevo informe que se referenciará como subreporte o para hacer referencia a un informe existente. En este último caso, si el informe elegido contiene uno o más parámetros, el asistente proporciona una manera sencilla de definir un valor para cada uno.

5.4.2 Especificación de un reporte existente en el Asistente de Subreporte Puede apuntar a un informe existente como subreporte con el Asistente de Subreporte. El primer paso es seleccionar un JRXML o Jasper en la primera pantalla del asistente. El segundo paso del asistente gestiona expresiones para la conexión o la fuente de datos utilizada para llenar el subreporte (Figura 5-19).

Figura 5-19: Segunda pantalla del asistente

Para seleccionar una conexión:



Usted puede seleccionar Usar la misma conexión que se utiliza para rellenar el informe principal cuando se usa un subreporte basado en JDBC. La conexión JDBC se pasa al subreporte para ejecutarlo.

 

Para especificar una conexión JDBC diferente, seleccione Utilizar otra conexión.



Seleccione Usar una fuente de datos vacía para definir la expresión de origen de datos a la nueva JREmptyDataSource (). Eso crea una fuente de datos especial que proporciona (cuando se declaran de esta manera) un registro único con todos los valores de los campos establecidos en null. Es muy útil cuando se utiliza el subreporte para mostrar contenido estático. En algunos casos es posible que desee evitar el uso de cualquier conexión o fuente de datos, como por ejemplo cuando se está visualizando el contenido estático. Por lo general, una fuente de datos o una conexión siempre es necesario para evitar que el subreporte esté en blanco. Cuando un subreporte no requiere una fuente de datos, sin embargo, se da a entender que la propiedad de informe Cuando ningún tipo de datos se establece en Sin Detalles o no Sección de Datos para garantizar que al menos una parte del documento se imprime en realidad.

Para utilizar un objeto JRDataSource para llenar el subreporte, seleccione Usar una expresión JRDataSource y escribir una expresión capaz de devolver un objeto JRDataSource.

Si el reporte seleccionado contiene parámetros, se muestran al lado (Figura 5-20). Para cada parámetro, se puede establecer un valor por la elección de un objeto a partir del combo. Por supuesto, usted puede escribir su propia expresión, pero no se proporciona ningún editor de expresiones en este contexto.

Figura 5-20: Establecer los parámetros del subreporte usando el asistente

Puede omitir este paso y editar los parámetros del subreporte posteriormente utilizando el método canónico explicados anteriormente en este capítulo (5.1.4, "Paso de Parámetros"). Por último, debe designar la forma de generar la expresión del subreporte. Del mismo modo que para un nuevo subreporte, hay dos opciones: almacenar el camino en un parámetro para ajustar de forma dinámica o establecer una ruta no modificable (ver Figura 5-21). Una vez más, todas las opciones se pueden modificar después de salir del Asistente para subreportes.

Figura 5-21: Último paso en el asistente de subreporte

Capítulo 6. Gráficos JasperReports proporciona la capacidad de hacer los gráficos dentro de un reporte de diferentes maneras. Usted puede utilizar JFreeChart, una poderosa biblioteca de generación gráfica de código abierto, o partir de la versión 5.0 se puede utilizar gráficos de HTML5.

En un gráfico, es posible imprimir los datos procedentes de la base de datos principal o de un sub conjunto de datos (vamos a tratar con sub conjunto de datos en Capítulo 14). Esto le permite incluir diferentes graficos en un documento sin utilizar subreportes. JasperReports es compatible con una amplia variedad de tipos de gráficos: Área, Bar, Bar en 3D, burbuja, línea, circular, circular 3D, gráfico de dispersión, barras apiladas, Barra apilada en 3D, Series de Tiempo, etc. Un gráfico de múltiples ejes se puede utilizar para agregar múltiples gráficos en uno solo.

6.1 Creación de un gráfico simple En esta sección, aprenderá cómo utilizar la herramienta para gráficos para crear un reporte que contenga un gráfico circular 3D.Se utilizará la base de datos de ejemplo de JasperReports para este ejemplo:

1. Cree un nuevo documento vacío. 2. Abra el cuadro de diálogo Consulta del reporte (Figura 6-1) haciendo click en el botón que representa un cilindro en la barra de herramientas de diseño.

Figura 6-1: Ventana de la consulta

3. Utilice esta consulta sencilla para mostrar el número de pedidos en diferentes países: select COUNT (*) as orders, shipcountry from orders group by shipcountry

4. Confirme la consulta haciendo clic en Aceptar. IReport registrará los campos de consultaseleccionado. 5. Coloque los campos en la banda de detalle arrastrándolos desde la vista de esquema (Figura 6-2). Esto creará una pequeña tabla con los valores que queremos mostrar en el gráfico.

Figura 6-2: Diseño inicial

6 Reorganizar las bandas y ampliar el resumen; aquí es donde vamos a colocar nuestro nuevo gráfico. 7. Seleccione la herramienta Gráfico y arrástrela hasta la banda de resumen. Cuando se agrega un nuevo elemento gráfico a un informe, iReport muestra una ventana de selección de grafico desde la que se puede elegir el tipo de gráfico (Figura 6-3).

Figura 6-3: ventana de selección de grafico

8. Seleccione el icono Pie 3D y haga clic en Aceptar. Figura 6-4 es un ejemplo de una imagen genérica para mostrar más o menos donde el gráfico se mostrará. IReport no muestra datos en tiempo real y gráficos en el diseñador.

Figura 6-4: El gráfico se coloca en la banda Resumen

Ahora tenemos que configurar el grafico. 9. Haga clic en el gráfico y seleccione la opción del menú Datos del gráfico para que la ventana Detalles de Gráfico se abra (Figura 6-5). En esta ventana puede seleccionar los datos que se utilizará con el fin de crear el gráfico. 10. En el combo box Tipo Conjunto de datos, seleccione conjunto de datos del Pie. Esta lista desplegable le permite especificar los tipos de conjuntos de datos para generar el gráfico. Por lo general, un solo tipo de conjunto de datos está disponible, excepto cuando se genera un gráfico XY de barras. 11. En la pestaña Conjunto de datos, se puede definir el conjunto de datos en el contexto del informe. Específicamente, restablecer Tipo y restablecer grupo lo que permitirá restablecer periódicamente el conjunto de datos. Esto es útil, por ejemplo, al resumir los datos en relación en una agrupación especial. Incrementar Tipo e Incrementar Grupo específica los eventos que determinan cuándo se deben añadir nuevos valores al conjunto de datos .Por defecto, cada

registro del conjunto de datos se utiliza para rellenar el grafico, cada uno corresponde a un valor impreso en el gráfico. Este comportamiento se puede cambiar, forzando el motor a recoger los datos del grafico en un momento determinado (por ejemplo, cada vez que se alcanza el final de un grupo). La expresión de filtro permite añadir un indicador para determinar si se debe agregar un registro al conjunto de registros diseñado para llenar el gráfico. Esta expresión debe devolver un valor booleano. IReport considera que una cadena en blanco significa "agregar todos los registros”.

Figura 6-5: Ventana Detalles del grafico

Para este ejemplo, establezca el tipo de restablecimiento al reporte ya que no desea que los datos se restablezcan, y deje el Tipo Incremento establecido en Ninguno para que cada registro se añada al conjunto de datos. 12. En la pestaña Detalles, escriba una expresión para asociar cada valor con el origen de datos. Para el tipo de gráfico 3D, se pueden introducir tres expresiones: llave, el valor y la etiqueta (Figura 6-6).



 

Llave: debe ser un valor único para identificar un segmento del gráfico circular. Si un valor llave se repite, la etiqueta y valores previamente asociados con esa llave se sobrescribe. Una llave no puede ser nulo. Valor: especifica el valor numérico asociado a la llave. Etiqueta: le permite especificar una etiqueta para cada sector del gráfico circular. Esta expresión es opcional, y el valor predeterminado es el valor de la llave.

Figura 6-6: Configuración del conjunto de datos

13. La configuración de este simple grafico ya está completa, y podemos obtener una vista previa del reporte para ver el resultado, como se muestra en la Figura 6-7.

Figura 6-7: Reporte Final

14. En este ejemplo, entre las expresiones que se muestran en la Figura 6-6, y a continuación, cierre el cuadro de diálogo.

En este caso, cada sector representa un país, y el valor de la porción es el total del envío para ese país. El cuadro en sí se encarga de calcular el envío total para todos los países y la creación del tamaño del segmento con respecto al total.

6.2 Valor hipervínculos Algunos tipos de conjuntos de datos proporcionan una forma de asignar un hipervínculo al valor representado en el gráfico, permitiendo al abrir una página web o navegar a través del reporte haciendo clic en el gráfico. Para establecer los parámetros de hipervínculo, vaya a la pestaña Hipervínculo en la pestaña Detalles del cuadro de diálogo Detalles de gráfico, como se muestra en la siguiente figura.

Figura 6-8: HiperEnlace para una porción del conjunto de datos del grafico

El área de clic-habilitado depende del tipo de gráfico. Los gráficos de sectores, el hipervínculo está vinculado a cada parte del pastel; para los gráficos de barras, las áreas de clic habilitadas son las propias barras. Recordemos que los hipervínculos incluyen expresiones para hacer referencia a todos los campos, variables y parámetros del conjunto de datos utilizado por un gráfico.

Capítulo 7. Tablas Cruzadas 7.1 Uso del Asistente de tablas de referencias cruzadas Cuando se agrega un elemento de tabla de referencias cruzadas a un informe, iReport muestra el Asistente de tablas de referencias cruzadas automáticamente. Para entender cómo trabajar con tablas de referencias cruzadas, le guiará a través de la creación de una con el asistente. 1. Comience con un reporte en blanco que contenga esta consulta: select * from orders

Incluir la tabla de referencias cruzadas al final del informe, en la banda de resumen. 2. Arrastre la herramienta de referencias cruzadas en la banda de resumen. Aparece la primera pantalla del Asistente para tablas de referencias cruzadas.

Figura 7-1: Primer paso en el asistente de Tabla cruzada

3. Seleccione el conjunto de datos para llenar la tabla de referencias cruzadas. Especifique el conjunto de datos del reporte principal (como se muestra en la Figura 7-1). 4. Haga clic en Siguiente para ir al siguiente paso. 5. En la segunda pantalla, usted tiene que definir al menos un grupo de filas. Para los propósitos de este ejemplo, vamos a agrupar todos los registros por País Destinatario, como se muestra en la Figura 7-2.

Figura 7-2: Segundo paso: definición de los grupos de filas

Agrupar los resultados por País Destinatario en cada fila de la tabla de referencias cruzadas en referencia a un país específico. Al contrario que en el reporte principal, JasperReports ordenar los datos uno mismo, aunque se puede desactivar esta función para acelerar el proceso de llenado si sus datos están ya ordenados. 6. Haga clic en Siguiente para pasar a la tercera fase (Figura 7-3). Agrupar los datos por el campo Fecha Envío. En concreto, se utiliza una función que devuelve el año de la fecha, por lo tanto la agrupación de los pedidos por año.

Figura 7-3: Definición de los grupos de columnas

Como se puede ver en la Figura 7-3, siempre que tenga un campo de tiempo (fecha, hora), se puede utilizar una función de agregación basada en el tiempo (como año, mes, semana o día), o se puede tratar como un valor normal (en cuyo caso se puede usar la función de agregación única para agrupar los registros que tienen el mismo valor). 7. Haga clic en Siguiente para pasar a la siguiente etapa. 8. Es el momento de definir los datos de detalle. Normalmente, el detalle (o medida) es el resultado de una función de agregación como el conteo de las órdenes por país por año, o la suma de la carga para la misma combinación (país / año). Tendrán que elegir para imprimir el número de pedidos realizados especificando ORDERID (campo) en el combo box Medida y COUNT en el combo box Función (vea la Figura 7-4). 9. Una vez más, haga clic en Siguiente para continuar.

Figura 7-4: Definición de la medida

10. En el último paso, puede configurar las opciones para el diseño de tabla de referencias cruzadas. Puede indicar si desea ver las líneas de cuadrícula, el uso del color establecido para distinguir los totales, encabezados y celdas de detalle, y el total de las filas y columnas. Para este ejemplo, seleccione todas las opciones del cuadro de control, como se muestra en la Figura 7-5, y haga clic en Finalizar.

Figura 7-5: Algunas opciones de la tabla cruzada

Tenga en cuenta que al agregar una tabla de referencias cruzadas en el informe, iReport crea una ficha correspondiente en la ventana de diseño. Esta ficha es la del diseñador de tabla de referencias cruzadas para el nuevo elemento de tabla de referencias cruzadas.

Figura 7-6: Vista Esquema en árbol - detalles de la tabla cruzada

En la vista de esquema, el elemento de tabla de referencias cruzadas muestra toda la estructura de tabla de referencias cruzadas, incluyendo los parámetros de referencias cruzadas y la fila y grupos de columnas, las medidas y las celdas (ver Figura 7-6).

Figura 7-7: Nuestro primer Tabla cruzada

Cuando se ejecuta el nuevo reporte que debe obtener un resultado similar al que se muestra en la Figura 7-7. La última columna contiene el total de cada fila, a través de todas las columnas. La última fila contiene el total de cada columna, a través de todas las filas. Finalmente, la última celda (en la esquina de abajo a la derecha) contiene el total combinado de todos los pedidos (830).

7.2 Trabajar con columnas, filas y Medidas Una tabla de referencias cruzadas debe tener al menos un grupo de filas y un grupo de columnas. Las filas y columnas se definen por estos grupos. Cada grupo de filas y columnas puede ser totalizado. La siguiente es una tabla de referencias cruzadas de base con un grupo de la columna y un grupo fila; los grupos se totalizaron:

Cuando se agrega un grupo de filas, iReport añade la fila con una cabecera y subtotal. La tabla de referencias cruzadas aparece como sigue:

Agregar un grupo de columnas muestra un resultado similar, con una nueva columna, encabezado y subtotal:

Figura 7-8: Agregar grupo de fila

Los grupos de filas y de columnas se muestran en la vista de esquema. Para agregar un grupo de filas, por ejemplo, haga clic en el nodo filas y seleccione Agregar grupo de filas (ver Figura 7-8). El nuevo grupo aparece en la vista de esquema y las celdas relativas se crean en el diseñador de tabla de referencias cruzadas. Tiene que establecer una expresión Bucket que es una expresión

utilizada para agrupar las filas. Por ejemplo, se puede agregar un grupo de filas para mostrar las ciudades de cada país. En ese caso, una expresión válida podría ser el campo SHIPCITY (la expresión se vería como $ F {SHIPCITY}). La expresión se debe establecer en las propiedades de grupo de filas.

Figura 7-9: Layout después de la nueva fila

La expresión es la única información que se debe establecer para cada nuevo grupo. Otras de las configuraciones de tablas de referencias cruzadas son las siguientes: Posición total Define la presencia de una fila para mostrar los subtotales Orden Orden de los valores del grupo (ascendente o descendente) Expresión Comparador Devuelve una instancia de java.util.Comparator que debe utilizarse para ordenar los valores Utilizando el diseñador, los tamaños de columna y fila se pueden modificar directamente arrastrando los bordes de las celdas. El contenido de cada celda debe estar completamente contenida en la celda (más o menos como ocurre con las bandas en el reporte principal). Cuando se agrega una fila o una columna a una tabla de referencias cruzadas, iReport crea una variable especial que se refiere al valor de la expresión bucket. Tiene el mismo nombre que el grupo nuevo. Cuando se edita la expresión de un campo de texto de los elementos en una celda, la expresión editor aparece. Enumera todos los objetos que se pueden mostrar en una celda de tabla de referencias cruzadas (ver Figura 7-10).

Figura 7-10: Los objetos que se pueden utilizar en una expresión de campo de texto de una tabla cruzada

Cuando se crea un nuevo grupo, iReport crea la nueva celda de encabezado para el grupo; en el grupo, iReport utiliza un nuevo campo de texto para mostrar el valor del grupo (usando una variable incorporada que tiene el mismo nombre que el grupo) y se llena la nueva celda con un campo de texto para que aparezca la primera medida disponible en la tabla de referencias cruzadas. Si la posición total se establece en un valor distinto de Ninguno (por lo general fin), iReport inserta otras celda como sede de los subtotales. Aquellas celdas se crean vacíos, así que de nuevo debe arrastrar un elemento de campo de texto en cada celda y establecer una adecuada expresión de los datos a mostrar (ver Figura 7-11).

Figura 7-11: celdas y filas totales vacía

El orden de los grupos se puede cambiar arrastrando en la vista de esquema. Tenga en cuenta que el diseño de tablas de referencias cruzadas es estrictamente atado a los ajustes de orden de grupo.

7.2.1 Modificando las celdas Las Tabla de referencias cruzadas tienen encabezado de celdas, totales de celdas, detalle de celdas, y celdas sin datos (opcional). Cada intersección entre una fila y una columna define una celda. Las celdas pueden contener un conjunto de elementos, tales como campos de texto, textos estáticos, rectángulos y las imágenes, pero no pueden contener un subreporte, un gráfico u otra tabla de referencias cruzadas. La figura 7-11 muestra una tabla de referencias cruzadas con algunas celdas de color y varios campos de texto. Puede modificar el color de fondo y los bordes de cada celda: haga clic en la celda que desea cambiar para mostrar en el menú y seleccione Relleno y bordes para modificar los bordes de la celda (ver Figura 7-12).

Figura 7-12: Modificando bordes de las celdas

El fondo de la celda y el estilo se pueden modificar en la hoja de propiedades cuando se selecciona un nodo de celda en la vista de esquema (ver Figura 7-13).

Figura 7-13: Estilo y fondo de celda

7.2.2 Comprendiendo las Medidas Una medida es un objeto similar a una variable. Siempre es, de alguna manera, el resultado de un cálculo realizado en un valor para cada una fila y columna de grupo que se cruzan en una celda. Expresiones de elementos en una tabla de referencias cruzadas, tales como imprimircuando y expresiones de campos de texto, sólo pueden contener medidas. En este contexto, no

se puede utilizar campos, variables o parámetros directamente; Siempre tenga que utilizar una medida. Para crear una medida, haga clic en el nodo medidas en la vista de esquema y seleccione Agregar Medida (ver Figura 7-14). IReport añade la nueva medida a la vista de esquema.

Figura 7-14: Agregar medida

Del mismo modo que cuando se crea un nuevo grupo, que tendrá que definir una expresión para la medida. La forma más sencilla de mostrar una nueva medida es utilizar un campo de texto. Arrastre un elemento de campo de texto en una celda y establezca la expresión de campo de texto adecuado (por ejemplo, con una medida de nombre como $V {Promedio_mercancia}) y la clase de expresión apropiada para el campo de texto, el cual debe ser coherente con el tipo de medida.

Hay varias opciones que puede utilizar para establecer una medida. Además del nombre, clase, y la expresión, se puede establecer el tipo de cálculo. Si los tipos de cálculo disponibles no son suficientes, se puede proporcionar una clase personalizada Incrementador por medio de una Factory que devuelve una instancia de esa clase (factory debe implementar la interfaz net.sf.jasperreports.engine.fil.JRIncrementerFactory).

Figura 7-15: Agregar medida

Si desea mostrar su medida como porcentaje general del total, se puede establecer la propiedad Porcentaje de tipo Gran Total.

Por último, se puede especificar una clase del calculador personalizado para realizar el cálculo de porcentaje (la clase debe usar la interfaz net.sf.jasperreports.crosstabs.fill.JRPercentageCalculator).

7.3 Modificación de las Propiedades de una tabla de referencias cruzadas Para ver las propiedades de la tabla de referencias cruzadas en la hoja de propiedades, seleccione el nodo de la tabla de referencias cruzadas en la vista de esquema (ver Figura 15-16).

Figura 7-16: Propiedades de la tabla cruzada

A continuación se presenta un breve resumen de algunas de las opciones de este cuadro de diálogo: Repetir encabezados de columna Si se selecciona, los títulos de las columnas se imprimen en cada página cuando la tabla de referencias cruzadas se extiende por páginas adicionales. Repetir encabezados de fila Si se selecciona, los encabezados de fila se imprimen en cada página cuando la tabla de referencias cruzadas se extiende por páginas adicionales. Salto de columna Offset

Especifica el espacio entre dos trozos de una tabla cruzada cuando la tabla de referencias cruzadas excede el ancho de página (ver Figura 7-17).

Figura 7-17: Salto de columna Offset

7.4 Parámetros en las tablas de referencias cruzadas Los Parámetros en las tablas de referencias cruzadas pueden usarse en las expresiones de los elementos que se muestran en la tabla de referencias cruzadas. Pueden ser definidos y gestionados a través de la vista de esquema (ver Figura 7-18).

Figura 7-18: Parámetros de la tabla cruzada

Para agregar un parámetro, haga clic en el nodo Parámetros en el elemento de tabla cruzada y seleccione Agregar parámetros. La expresión de parámetro para un parámetro de tabla de referencias cruzadas sólo puede utilizar los objetos del reporte principal, no desde un sub conjunto de datos opcional utilizado para alimentar a la tabla de referencias cruzadas. Una vez más, estos parámetros están diseñados para ser utilizados en los elementos de tabla de referencias cruzadas. Ellos no son el mismo que los parámetros de conjunto de datos que se utilizan en las expresiones, en el contexto tabla de referencias cruzadas, para filtrar una consulta y calcular los valores.

Puede utilizar el mapa para establecer el valor de los parámetros de referencias cruzadas declaradas en tiempo de ejecución. En este caso, tendrá que proporcionar expresión de un mapa de parámetros válida en las propiedades de referencias cruzadas.

7.5 Trabajar con los datos de las tablas de referencias cruzadas Como se mencionó anteriormente, puede llenar una tabla de referencias cruzadas con datos del reporte principal o desde un subconjunto de datos. En este último caso, se debe especificar el conjunto de datos de gestión en la ventana de datos de la tabla de referencias cruzadas, al que se accede haciendo clic derecho en el nodo de tabla de referencias cruzadas (o en el Elemento de tabla de referencias cruzadas en el diseñador) y seleccionando la opción de menú de datos de la tabla de referencias cruzadas (ver Figura 7-19).

Figura 7-19: Datos de la tabla cruzada

La interfaz de la ventana es similar a la utilizada para proporcionar datos para un gráfico. El mecanismo para proporcionar los datos a una tabla de referencias cruzadas es muy similar. Si los datos están previamente ordenados, puede seleccionar la opción de datos pre-ordenados para acelerar el proceso de llenado. Puede utilizar Reset Type/Reset Group and Increment Type/Increment Group para definir el momento para restablecer los datos recopilados o agregar un registro a su conjunto de datos. La expresión Incremento Cuando es un indicador para determinar si se debe agregar un registro al conjunto de registros que se alimenta de la tabla. Esta expresión debe devolver un valor booleano. IReport considera que una cadena en blanco significa “agregar todos los registros."

7.6 Uso de las variables totales en las tablas de referencias cruzadas Las variables totales de las tablas de referencias cruzadas (ver Figura 7-20) están incorporadas en objetos que se pueden usar dentro de expresiones de campos de texto de tablas de

referencias cruzadas para combinar los datos a diferentes niveles de agregación (por ejemplo, para calcular un porcentaje). Para cada medida, JasperReports crea variables que almacenan el valor total de la medida por cada grupo de filas / columnas.

Figura 7-20: Las variables totales se sugieren en el editor de expresiones

El siguiente ejemplo es un reporte simple que muestra el número de pedidos enviados en varias regiones durante varios años. La figura 7-21 muestra el diseño de tabla cruzada simple para el ejemplo, y en la figura 7-22 muestra los resultados de la impresión.

Figura 7-21: Layout simple de tabla cruzada

Figura 7-22: Resultado del Layout simple

Para calcular el porcentaje de los pedidos realizados en cada región y por año, añadir un campo de texto con la siguiente expresión Java: new Double( $V{ORDERIDMeasure}.doubleValue() / $V{ORDERIDMeasure_ORDERDATE_ALL.doubleValue() )

La fórmula básica para implementar es: (Número de los pedidos realizados en esta región y en este año) / (Todas las órdenes enviadas en esta región) Un porcentaje debe ser tratado como un número de punto flotante. Por esta razón, extraer los valores de doble escalares de las medidas ORDERIDMeasure y ORDERIDMeasure_ORDERDATE_ALL objetos incluso si hay objetos de tipo de clase Entero (en realidad, un porcentaje deriva de un número entre 0 y 1, multiplicado por 100). Para incluir el valor de la expresión en forma de porcentaje, establezca el valor del atributo de patrón de campo de texto a #, # # 0,00%. La figura 7-23 muestra la tabla de referencias cruzadas modificado en la ventana de diseño, y en la figura 7-24 muestra el resultado final impreso.

Figura 7-23: Un segundo campo se ha añadido en la celda de medida para mostrar el porcentaje

Figura 7-24: Reporte final con porcentajes incluidos

Manual De Ireport V10.1.0.0 3m2s70

Overview 26281t

More details 6y5l6z

Related Documents 3h463d

Manual De Ireport V10.1.0.0 3m2s70

Manual Ireport u2w1v

Manual De Ireport 1591g

Ireport Manual 485l2r

Curso De Ireport 4h6u46

Ireport 3.7 3h6j3s

More Documents from "Oswaldo Perez" 3n481n

Command Overview With Short Description Elcad.pdf g6b6k

Modulo Metodos Cuantitativos 621v4p

Consultapuntospago (2) v1j28

Manual De Ireport V10.1.0.0 3m2s70

4p345f

Arteche Rf4 6wp6z