GUIA PARA PRODUCIR REPORTES EN C# A TRAVÉS DE REPORTVIEWER
Los reportes son informes de presentación de resultados finales. Usted no puede presentar a su
cliente o empleador tablas o consultas con cientos o miles de registros. Necesita darle un toque
pedagógico para que el resultado del procesamiento de las bases de datos sean transformados en
cuadros fáciles de entender.
A partir de los cuadros se realizan gráficos e
infografías, siendo esto lo que finalmente los usuarios
de la información valoran todo lo que ha realizado el
programador.
Visual Studio contiene algunas extensiones para
preparar reportes. Uno de ellos es ReportViewer.
Luego de haber realizado su instalación siguiendo la
guía preparada por separado, asegúrese que xampp
esté funcionando en modo administrador, de tal
forma que su base de datos pueda ser conectada
desde Visual Studio.
Cree un proyecto de Visual Studio. Aquí, por ejemplo,
se ha creado uno llamado misReportes del tipo Windows Forms dentro de la solución
sln_misReportes.
Una vez creado el proyecto, siga los etapas descritas más adelante.
PRIMERA ETAPA
• Posicione el cursor sobre el proyecto misReportes y con click derecho adicionar un nuevo
elemento (New Item).
• Agregue un elemento de Tipo DataSet y asigne un
nombre al elemento. En mi caso, yo asigné
miDataset.
• Tenga presente que estamos creando la
infraestructura para importar tablas o vistas
desde la base de datos de MySql.
SEGUNDA ETAPA
• Posicione el cursor dentro del entorno
miDataSet.xsd. Con click derecho observará
que hay 3 opciones. Yo escogí TableAdapter.
• Aparecerá una caja de diálogo para iniciar el
proceso de conexión con su base de datos.
• Oprima nueva conexión.
• Oprima Cambiar (Change) porque por defecto su conexión estará con SQL Server y nosotros
necesitamos trabajar con MySql.
• En la caja de diálogo seleccione MySQL Base de datos y luego OK.
• En la nueva caja de diálogo Adicionar Conexión,
coloque:
− Nombre de Servidor: localhost (o como se llame)
− Nombre de usuario: root (o como usted lo tenga)
− Contraseña: ******, o déjela en blanco si no ha
tiene asignado una.
• Marque la casilla “salvar mi contraseña” para que
más adelante el programa no pida a cada momento.
• Oprima Test de Conexión. Se abrirá una caja de
diálogo indicando si su conexión ha sido exitosa.
• Finalmente oprima OK.
• Notará que ha vuelto a la caja de diálogo de
configuración. Aquí sólo presión Siguiente (Next)
• Continúe
presionando
siguiente, en éste y
el próximo cuadro de
diálogo.
• En el siguiente cuadro de diálogo presione Constructor de Consultas (Query Builder)
• Luego saldrá otra caja de diálogo con todas
las tablas y vistas de su base de datos.
Escoja 1, o varias y oprima Adicionar (Add).
Yo escogí sólo la tabla cliente.
• Ahora en la caja del constructor de
consultas puede aplicar las sentencias SQL
que usted desee, en mi caso yo seleccione
que muestre todos los registros de la tabla
cliente.
Presione OK.
• Ahora presione Finalizar
• Observará la siguiente pantalla. Si es así, entonces ya tiene una tabla en el DataSet. Puede
agregar más tablas o vistas, o procedimientos almacenados, si usted así lo desea. Siguiendo los
mismos pasos anteriores. ¿Por qué más tablas, vistas, etc.? Porque aquí podrá hacer relaciones
o consultas para generar nuevos reportes, o se valdrá de las que ya existen si usted las ha
diseñado antes.
TERCERA ETAPA
• Ahora requerimos un elemento de
informe. Posicionado sobre el proyecto
misReportes, con doble click agregue un
nuevo elemento o item de tipo Report,
asignando un nombre. En mi caso, coloqué
miPrimerReporte.rdlc.
• Aparecerá un esquema tal como la figura
que se muestra a continuación. Allí mismo,
posicionado sobre DataSets con click
derecho seleccione Agregar Dataset
• En la caja de diálogo asigne un nombre a su primer
DataSet (yo puse DataSetReport), defina el origen
de sus datos, en mi caso es miDataset. Y fíjese bien
para escoger la tabla que quiere trabajar, en caso
que tenga varias. Luego presione OK
• Observe que, en la parte izquierda o intermedia de su pantalla, el
ambiente del Reporte de Datos (Report Data) mostrará los
campos de la Tabla cliente.
• Ahora estos pueden ser arrastrados con el mouse sin problemas
hasta el ambiente de miPrimerReporte.rdlc, pero antes de
hacerlo vamos a insertar una tabla vacía de manera que
tengamos un reporte más ordenado. En miPrimerReporte se
pueden agregar dibujos, imágenes, tablas, gráficos, etc. Todo
para que el usuario pueda hacer diseños sin mayores problemas.
• Posicionados dentro del ambiente de miPrimerReporte, insertemos una tabla con click derecho.
• Arrastramos los campos del DataSetReport hasta colocarlos dentro de la tabla.
• Por ahora no haremos ningún diseño, eso queda bajo responsabilidad de usted, indicándole que
aquí podemos agregar encabezado, pie de página, fórmulas, etc. Este reporte todavía no se
puede imprimir, aún tenemos que traspasarlo a un formulario de Windows Form
• Nos posicionamos sobre el formulario de Windows Form y verificamos si en la Caja de
Herramientas (ToolBox) tenemos un ícono de ReportViewer. Si no es así tiene requiere ser
instalado. Favor revise la guía de instalación que fue preparada anteriormente.
• Una vez instalado deberíamos ver los íconos así, dentro de nuestro ToolBox:
CUARTA ETAPA
• Posicionado sobre un formulario de Windows Form, nos desplazamos hacia la Caja de
Herramientas y desde allí arrastramos el ícono ReportViewer hacia el interior del formulario
(punto 1).
• Aparecerá una página en blanco. En su esquina superior derecha tenemos disponible una
flechita para escoger alguna opciones. Allí seleccionamos el reporte que hemos creado (punto
2), en mi caso miPrimerReporte.rdlc. Y finalmente ampliamos (punto 3) la ventana del reporte
para que ocupe el 100% del tamaño de nuestro formulario.
• El Formulario seguirá en blanco o vacío. No se preocupe, así es, no hay ningún problema. Usted
verá el reporte cuando haga correr el programa con F5 o iniciar
Aquí el resultado. No está nada bonito por cierto, porque no hemos hecho ningún diseño. Mas
abajo, a manera de ejemplo, le muestro uno que yo hice la semana pasada, porque todo se puede
acomodar.
Lo demás corre por su cuenta.
