Crear Crystal Report

Reportes en .NET con Crystal Reports

Por Mauro Sant'Anna

Visual Studio .NET incluye Crystal Reports como un mecanismo "oficial" de creación de reportes.

Crystal Reports es un producto muy desarrollado y complejo para la creación de reportes, y

cuenta con una infinidad de opciones. En este artículo, nos vamos a concentrar en crear reportes

relativamente sencillos, pero mostrando los detalles específicos de la versión .NET, tanto en

aplicaciones WinForms como en aplicaciones WebForms (ASP.NET). Este artículo considera

que usted ya posee alguna familiaridad con Visual Studio .NET y también con ADO.NET.

Crear un reporte

Independientemente de cómo se hará la presentación, el reporte se define en un archivo ".RPT",

que forma parte de su proyecto. Ese archivo especifica el modo en que se hará la presentación

del reporte, pero no incluye los datos propiamente dichos. Los datos se definirán en el tiempo de

ejecución.

Crystal Reports se basa en un concepto muy común de la definición de reportes: los reportes se

componen de "secciones", y cada sección es un espacio horizontal en la página. Existen

diversos tipos de secciones, por ejemplo:

· Encabezado del reporte, aparece en la primera página.

· Encabezado de página, aparece en la parte superior de todas las páginas.

· Detalle: lo más importante. En el tiempo de ejecución, se genera una de estas secciones

para cada línea (registro) en la base de datos.

· Pie de página, aparece en la parte inferior de todas las páginas.

· Pie de reporte, aparece al final del reporte.

En un principio, todos los reportes presentan estas cinco secciones. Otras secciones son

opcionales, como por ejemplo:

· Encabezado de grupo, aparece antes de un grupo.

· Pie de grupo, aparece al final del grupo.

Se podrá omitir una o más secciones, en caso de que no sean necesarias.

Acceder a la base de datos

Antes de crear el reporte, hay que decidir cuál será el mecanismo utilizado para acceder a la

base de datos. Crystal Reports puede obtener datos de una infinidad de fuentes, pero una buena

cantidad de ellas, como DAO, ADO y OLE/DB, no está "administrada", o sea, es código .NET

"puro". En una aplicación .NET, probablemente sea deseable realizar el acceso a través de

ADO.NET. Para ello, lo más fácil es definir un Conjunto de datos tipificado, aun antes de crear el

reporte.

Crear un proyecto

Veamos cómo crear un reporte en un programa WinForms. Inicialmente, genere un proyecto en

C# de tipo "Windows Application".

Vamos a definir ahora el acceso a la base de datos. Como ejemplo, vamos a acceder a la base

de datos "Northwind", que se encuentra como ejemplo en SQL Server. Siga la siguiente ruta:

· Agregue un componente de tipo SqlDataAdapter.

· Seleccione la conexión con la base Northwind.

· Introduzca el comando SQL "select * from Products order by CategoryID, ProductName"

· Haga clic con el botón alterno del mouse sobre el componente DataAdapter, seleccione

"Create DataSet" y acepte el nombre sugerido ("DataSet1").

Ahora, agregaremos un reporte al proyecto. Haga clic en "Proyecto | Agregar elemento nuevo" y

seleccione "Crystal Report":

Acepte el nombre "CrystalReport1.rtp", al presionar Intro. Crystal Reports mostrará un asistente.

Marque "Usar el Experto en reportes" y "Estándar":

En este momento, cabe hacer algunos comentarios:

· El asistente puede ayudarle a crear diversos tipos de reportes, pero vamos a explorar

solamente algunas posibilidades más sencillas. Puede probar después con otros tipos de

reportes;

· Crystal Reports pedirá que realice el registro de su copia; mostramos el uso con una

copia ya registrada.

Presione "Aceptar" para pasar a la pantalla siguiente para la elección de la fuente de los datos.

Seleccione la tabla

...