O3 Report

Alcance de este mini tutorial.

Se prentende que con este tutorial que el usuario obtenga los conceptos necesarios para poder construir reportes básicos. En caso de precisar reportes mas complejos sugerimos leer documentación en libros.

Instalando Eclipse+BIRT

................

Vista general del proceso de diseño de un reporte

Detallamos los pasos para conseguir un diseño robusto y coherente de un reporte

• Planear el reporte.
• Especificar la información a usar.
• Diseñar la forma del reporte.
• Formatear la información.
• Diseñar la página maestra.
• Testear el reporte.

Construyendo un reporte simple

En esta seccion mostraremos como construir paso a paso un reporte sobre un listado.
Se realizarán las siguientes tareas para llevar acabo el reporte.

• Crear un nuevo proyecto (si se usa BIRT RCP no es necesario este paso).
• Crear un nuevo reporte.
• Construir una fuente de datos (data source).
• Construir un conjunto de datos (data set).
• Diseñar el roporte de modo de mostrar cada una de las columnas del conjunto de datos.
• Ordenar la información.
• Formatear los datos para mejorar la presentación de los mismos.
• Crear un título para el reporte

Creando un nuevo proyecto

Eclipse organiza los archivos por proyectos. Ud puede crear un proyecto para contener todos sus reportes, o bien puede crear un proyecto para cada reporte. Si usa BIRT RCP esta parte no aplica.

Para ello vamos a Archivo->Nuevo->Proyecto. Nos aparece la pantalla siguiente:

Expandimos donde dice Bussines Intelligence and Reporting Tools y seleccionamos Report Preject lugo Next.
Le pondremos por nombre Mi preyecto.

y apretamos el botón Finish, en la ventana de navegación veremos que apareció nuestro proyecto.

Creando un Reporte

Un reporte se puede crea de dos formas:

• Comenzando con un diseño en blanco.
• Usando una plantilla prediseñada de reporte.

A los efectos de este tutorial comenzaremos de un reporte en blanco.

Entences hacemos File->New->Report, elegimos el preyecto en el cual crearemos nuestro reporte, en este caso Mi Proyecto. Y por nombre le pondremos al reporte mi_reporte.rptdesign

Luego el sistema nos da a elegir entre usar un reporte en blanco o usar plantillas. Elegimos Blank Report y apretamos Finish

Construir una fuente de datos (data source)

Antes de poder entrar a diseñar el reporte es necesario especificar como BIRT se conectara a una base de datos, esto se hace definiendo una fuente de datos.
A los efectos de este tutorial, estableceremos una fuente de datos para O3. veamos este preceso en detalle.

Seleccionamos una nueva fuente de datos, Data->New Data Source

Elegimos JDBC y le damos next

Tenemos 2 opciones para conectarnos a O3:

• Acceder a una vista
• Acceder al cubo con MDX

Veamos como completar el formulario para una conexión a una vista

Y ahora veamos para el caso de MDX

Podemos testear la conexión apretando el botón Test Connection...

Construir un Set de datos (Data set)

En esta etapa es en la que definimos la consulta propiamente dicha.

En el menú vamos a Data->New Data Set y veremos el siguiente dialogo

• En Data Set Name le pondremos el nombre con que queremos llamar a este Set.
• En Data Source nos da a elegir un data source que ya hallamos definido.
• En Dara Type elegimos SQL Select Query.

En la siguiente pantalla es que se define la consulta
Veamos en primera instancia para consultar una vista definida en el server

Aquí es importante destacar en el SQL el FROM de la clausula

'Vinos/VinosPorVendedor#_public'

• Vinos - es el nombre del cubo con que se lo publica en el server.
• VinosPorVendedor - es la vista de la cual me interesa extraer datos.
• #_public - indica como esta guardada la vista

Estos datos pueden ser sacados de la barra de estado del navegador web, luego de source=Vinos/VinosPorVendedor#_public en la página de marcadores.

Acontinuación no aparece la misma pantalla, pero con un menú de opciones entre ellas podemos hacer un vista previa (preview) de los datos que se traen con la consulta.

Veamos ahoro como seria para MDX

¿Qué es MDX?

..............

En este caso la diferencia con el anterior es que debemos elegir un Data Source para MDX y la sintaxis de la consulta difiere de la anterior

SELECT 
	{[<measures>].[<measures>].[Litros Vendidos]
	,[<measures>].[<measures>].[Venta Bruta]} ON COLUMNS, 
	CROSSJOIN
	({[Vendedores].[Vendedores].[Distribuidor].children}
	,{[Vinos].[Vinos].children}) ON ROWS 
FROM [Vinos]

Para este ejemplo lo que estamos es trayendo en la columnas los litros vendidos y la venta bruta. Para las filas estamos trayendo los vendedores y los vinos.

Escribiendo consultas MDX

Por cuestiones de simpleza recomendamos el usa de las vistas sobre el uso mas complicado de MDX

Diseñando el Reporte

En esta parte del precedimiento insertaremos los elementos de nuestra consulta para realizar el reporte.
Comenzaremos por insertar un tabla, este elemento tiene la particualaridad que interactua con todo es set de datos que trae la consulta. Para colocar un tabla hacemos Insert->Table

No quedara según la siguiente imagen

Elegimos Data Explorer y comenzamos a arrastrar los campos a la tabla a la zona de detalle, el sistema pone en forma automático los títulos

veremos lo siguiente

Para ver lo construido hasta el momente tenemos varias posibilidades:

1. Cliquear el tab Preview de la ventana de diseño.
2. File->View Report-> y elegir alguna de las opciones que nos brinda el menú.

Ordenando la información

Cuando la información llega desde lo consulta, esta no tiene porque venir ordenada. Tenemos la posibilidad de ordenar la información con esta herramienta si ya no lo hicimos en la consulta misma.
Para esto usaremos el editor de propiedades

Bibliografía