Reportes, Pantallas y Etiquetas Instructor Ing. Diego Márquez Diseño de Reportes Jasper Agenda • Diseño de Reporte
Views 189 Downloads 7 File size 2MB
Reportes, Pantallas y Etiquetas Instructor Ing. Diego Márquez
Diseño de Reportes Jasper
Agenda
•
Diseño de Reportes Jasper •
Introducción a Jaspersoft
•
Instalación de iReport
•
Conexión MOCA
•
Creación de Reportes
•
Interfaz de iReport
•
Query del Reporte
•
Bandas o Secciones
•
Elementos del Diseño de Reportes
•
Agrupaciones
•
Implementación de Reportes
•
Ejercicios
Introduccion a Jaspersoft iReport Designer
Jaspersoft iReport.Designer
• Jaspersoft es el reportador de JDA que ha sido introducido como una solución común para todos los productos de JDA.
• Lo que permite: • • • •
Reducir los requerimientos de Soporte Reducir las necesidades de capacitación Reduce el costo comercial de las licencias Provee reportes compatibles para todas los productos
Ventajas de Jaspersoft iReport.Designer
• Es un Software Open Source bajo la licencia LGPL que permite a JDA modificar e incorporar su código en sus productos.
• Solución 100% Java, y puede ser utilizada en múltiples Sistemas Operativos. • La herramienta de diseño es open source y esta disponible para descarga gratuita.
Instalación de iReport
Instalación de iReport.
• iReport puede ser Descargado de forma gratuita desde el siguiente link. • http://sourceforge.net/projects/ireport/files/iReport/iReport-4.0.1
• Le versión que se debe utilizar es la 4.0.1. No se debe utilizar una versión diferente debido a dependencias entre el iReport y el plugin de JDA/RP. • Una vez descargado, se realiza la instalación de forma normal en Windows.
Instalación de iReport.
• Una vez instalado, es necesario agregar el plugin de MOCA para iReport.
Tools Plugins
Instalación de iReport. Pestaña Downloaded
Clic en Add Plugins
Instalación de iReport.
Buscamos el Plugin
Clic en Install
Reiniciamos iReport
Instalación de iReport.
• Si la instalación se realizo correctamente en Help About RedPrairie iReport Plugin mostrara lo siguiente:
Conexión MOCA
Conexión MOCA.
• Para crear una conexión MOCA seguimos los siguientes pasos:
Clic Create a Database Connection
Conexión MOCA.
Redprairie MOCA Connection
Next
Conexión MOCA.
• Completamos la información solicitada de la siguiente forma: Name: Nombre de la Conexión
MOCA Server URL: Url del servicio de RP
Username/Password: Usuario y Contraseña validos para RP
Creación de Reportes
Creación de Reportes
• Podemos crear un nuevo reporte des el Menu Archivo New o desde el “Welcome Tab”.
Clic Create a New Report
Creación de Reportes
• Elegimos el Template que deseemos utilizar.
Clic Open this Template
Creación de Reportes
• Completaremos la información requerida: Nombre del Reporte
Ubicación de Almacenamiento
Clic Next Clic Finish
Creación de Reportes
• Es necesario agregar los parámetros MOCA estándar del plugin de Redprairie: Herramientas Check Report Template
Try to Fix
Creación de Reportes
Ok
Los Parámetros Faltantes Serán añadidos de forma Automática
Interfaz iReport
Interfaz iReport
Paleta
Report Inspector Main Design Area
Ventana de Problemas del Reporte
Panel de Propiedades
Query del Reporte
Query del Reporte
• Para definir el query que obtendrá la información del sistema, buscamos el botón Report Query.
Report Query
Query del Reporte
Lenguaje MOCA
Sintaxis Local o comando MOCA
Vista Previa de los datos Obtenidos
Query del Reporte Lista de Parámetros Definidos
Nombre del Parámetro: como aparece en el Query
Tipo de Dato
Clic New Parameter
Valor Default utilizado solo para filtrar al ejecutarse en iReport
Query del Reporte
• Para que Redprarie detecte que el reporte cuenta con parámetros es necesario definir dos propiedades. Seleccionamos el parámetro
Use as a Prompt
Para definir una nueva propiedad
Query del Reporte Clic Add
Nombre de la Propiedad: prompt Valor: el nombre de la variable entre “^”
Bandas o Secciones
Bandas o Secciones
• iReport trabaja con el concepto de Bandas. • Cada Banda define un área horizontal en el reporte. • Una banda es tan ancha como el reporte, pero su altura puede crecer dependiendo de cuantos elementos están definidos en el, o de la información contenida.
Bandas o Secciones
Title
Esta sección solo es generada una vez durante la ejecución del reporte.
Page Header
Esta sección es generada por cada pagina como encabezado.
Column Header
Esta banda es impresa por encima de la banda de detalle, es usada para definir los nombres de las campos. Si el reporte tiene múltiples columnas se imprime una sola vez por cada columna,
Group Header
Define el encabezado de un grupo de Sumarizacion, siempre esta asociado con un Group Footer Band.
Detail
Contiene el detalle de los registros devueltos por el query o Comando MOCA, definidos en el reporte.
Group Footer
Define el Pie de un grupo de Sumarizacion.
Bandas o Secciones
Column Footer
Es la banda asociada con el Column Header band. Su funcionamiento es igual al Encabezado.
Page Footer
Esta banda se encuentra asociada con el Page Header y se imprime en cada pagina del reporte.
Last Page Footer
Esta sección solo es generada en la ultima pagina del reporte.
Summary
Esta sección muestra en caso de ser necesario un resumen del reporte al final del mismo.
Background
Permite definir marcas de agua u otro grafico que aparecerá en toda la pagina.
No Data
Aque se puede especificar, un mensaje en caso de que el query no regrese resultados.
Bandas o Secciones
• Las Bandas pueden ser eliminadas o creadas desde el Report Inspector.
Elementos de Diseño del Reporte
Elementos de diseño del Reporte
• Los elementos disponibles para el diseño de reportes para JDA/Redprairie son los siguientes: • • • • • • • •
Text Field Static Text Subreport Break Image Line Ellipse Rectangle
• • • •
Round Rectangle Barcode Checkbox Chart
Elementos de diseño del Reporte: TextField
• Los TextField es el elemento principal utilizado para desplegar texto de forma dinámica en los reportes. • La propiedad “Text Field Expression” puede utilizar scripts sencillos en lenguaje Java para ser completado, o solo hacer un llamado al valor de un campo.
Elementos de diseño del Reporte: TextField
• Algunos ejemplos que son comúnmente utilizadas son: • $F{client_id} – Devuelve el valor del campo client_id • $P{wh_id} – Devuelve el valor del parámetro wh_id • $R{^rptStdBillOfMaterial^} – Devuelve la traducción asociada al campo mls_id y el locale_id de la tabla les_mls_cat
• $V{PAGE_NUMBER} – Devuelve el valor de la variable predefinida en el reporte llamada PAGE_NUMBER • new java.util.Date() – Devuelve un nuevo objeto de la clase que contendrá el valor de la fecha actual.
Elementos de Diseño del Reporte: SubReporte
Elementos de diseño del Reporte: SubReportes
• Un subreporte permite añadir una consulta interna dentro del reporte principal. • Son diseñados, probados y compilados de forma independiente en un archivo .jasper. • Cuando se crea un subreporte los parámetros definidos en el subreporte deberán corresponder con los valores enviados desde el reporte principal. • El Subreporte posee características similares a las del reporte principal, como definición del query, parámetros y variables.
Elementos de diseño del Reporte: SubReportes
• Para añadir un subreporte es necesario considerar las siguientes propiedades: Ruta del Archivo Compilado
Tipo del valor de la propiedad “Subreport Expression” Permite que el subreporte sea cargado desde la chache del reportador
Elementos de diseño del Reporte: SubReportes
• Así mismo es necesario configurarle nuevos parámetros para el correcto funcionamiento: Todos los Parámetros MOCA estándar de Redprairie.
Así como todas los parámetros definidos en el subreporte, requeridos para la ejecución del Query
Agrupaciones
Agrupaciones
• Las agrupaciones con creadas dando clic derecho en el Reporte, en el Report Inspector, eligiendo la opción Add report group. • Un encabezado y pie son añadidos por default. • No es necesario mantener ambas secciones, un grupo puede solo contener una de estas. • El parámetro para agrupar el reporte se define en la propiedad Group Expression.
Agrupaciones
• El “New Group Wizard” solicitara un Nombre para el grupo y el campo o expresión que se utilizara para agrupar la información. Se puede utilizar un campo en especifico
O una expresión sencilla en lenguaje Java
Agrupaciones
• Se pueden añadir variables, las cuales puedes ser añadidas como campos para realizar cálculos en el encabezado o pie de grupo. Clic Agregar Variable
Agrupaciones
• Algunas propiedades que se pueden utilizar son: • Calculation: Determina que tipo de Calculo será realizado. • Reset Type: Como será realizado el calculo. • Reset Group Banda que será utilizado para realizar el calculo. • Increment Type: Determina cuando la variable deberá obtener un nuevo valor. • Increment Group: Banda que será utilizada para realizar el incremento. • Varaible Expression: Utiliza un campo de la consulta para realizar el calculo.
Agrupaciones
• Las variables pueden ser agregadas como TextFields como $V{nombre_de_la_variable}:
Implementación de Reportes
Configuracion del Servidor
• Política para búsqueda de reportes: • Policy Code: SYSTEMINFORMATION • Policy Variable: REPORTS • Policy Value: MOCA-REPORTSPATH
Implementación de Reportes
• Agregar un nuevo reporte al sistema consite en tres sencillos pasos: • Mover los archivos .JRXML .Jasper (y otros archivos adicionales, imágenes, subreportes, moca commands) al servidor de aplicación. • Crear reporte en el sistema (Report Maintenance) • Asignar permisos (Authorization Maintenance)
Implementación de Reportes
• Los archivos deben ser colocados en la ruta correspondiente en el servidor, basados en la política previamente configurada.
Implementación de Reportes
• Report Maintenance.
Descripción breve del reporte
Tipo Jasper Reports
New
Identificador del Reporte Los reportes personalizados deben comenzar con “usr-” o “var-”
Nombre del archivo jrxml con extension
Implementación de Reportes
• Asignación por Rol
Implementación de Reportes
• Asignación por Usuario
Ejercicios