DISEÑO DE REPORTE CON REPORTVIEWER(C#)

Introducción

Sea muy bienvenido a un nuevo tutorial de Programación 4 en el cual estaremos explicando e implementando lo que son los reportes en C# de una manera muy sencilla y entendible.  Con la creación de un reporte tendremos la información de los productos que se han ingresado en el sistema. Esto es muy importante ya que usted podrá visualizar cada registro ingresado con sus respectivos datos luego proceder a imprimir lo que es el reporte.

Objetivos

• Recuperar información para:
• Visualizar la información de registros mediante el diseño de informes.
• Aplicar conocimientos de reglas básicas de análisis y diseño de salida de datos (título, contenido, fecha que se imprime, pagina.

Conocimientos previos

Para que usted pueda realizar y entender el siguiente trabajo que explicaremos debe tener los siguientes conocimientos:

• Diseños de tablas en dataset.
• Conexiones con MySql.
• Estructuras de control.

Requisitos

• Xampp.
• Gestor de bases de datos(MySql).
• Crud de datos ya elaborado en C#. Si aún no lo tienes te invitamos a ver el tutorial pasado en donde explicamos cómo crear un Crud da datos utilizando C# y MySql:
  https://proyectocrudcsharp04.blogspot.com
  O también puedes ver la serie de videos en donde hacemos la explicación de el mismo Crud:
  https://www.youtube.com/watch?v=d_wB_RpCuwM&t=5s.
• Origen de datos: dataset con la tabla Pulperia esto se encuentra dentro del Crud, pero lo mencionamos aquí porque es con quien se enlaza nuestro  reporte.

Este es nuestro Crud de Pulperia con el cual explicaremos como hacer el reporte:

Si ya viste el tutorial anterior esto lo reconocerás. En la ilustración hemos remarcado en un recuadro lo que es el “dsPulperia” ya que es con lo principal que trabajaremos. Para que el reporte pueda funcionar y mostrar registros de datos debe de haber un origen de datos, en este caso será la tabla pulpería que hemos creado en un dataset en el crud de ventas:

 Al habernos asegurados de que tenemos lo antes mencionado ahora empezamos con los pasos para la creación del reporte.

Pasos para la creación de un reporte en C#

1. Para empezar con la creación del reporte lo primero que debemos de hacer es agregar un nuevo elemento, cuando estamos en esta sección debemos de seleccionar la opción de “Reporting” al haber hecho esto nos aparecerán tres opciones de las cuales debemos seleccionar “Informe” y enseguida darle un nombre. Tal  y como se muestra en la siguiente ilustración:
   
   A nuestro reporte lo llamaremos “Report_inventario”. Por ultimo damos click en Agregar y nos aparecerá lo siguiente:
   

   

   Como se puede observar nuestro informe se ha creado. Y apareció una nueva pestaña llamada “Informe” esta aparecerá solamente cuando estemos trabajando en lo que es “Report_inventario”.
2. Ahora empezamos a aplicar las reglas de salida de datos en análisis y diseño. Debemos de agregar un encabezado en el cual estará lo que es el título del informe, luego agregamos el pie de página en el cual estará la fecha de impresión y el número del total de páginas.
   Para esto hacemos lo siguiente:
   

   

   
   Vamos a la pestaña informe y primero seleccionamos “Agregar encabezado de página”, se agregará el encabezado y para agregar el pie de página hacemos el mismo procedimiento y seleccionamos la opción de “Agregar pie de página” el resultado sería el siguiente:
   

   

   
   
3. Agregar título en el encabezado.
   Para poder agregar un título tomamos del cuadro de herramientas el objeto “Cuadro de texto” y lo situamos en el encabezado de la página. Con precaución escribimos el título del informe en el cuadro de texto, en este caso será: “Reporte de inventario de pulpería”, Damos el tamaño de letra, color, fuente, centramos el texto, y luego centramos el objeto tanto horizontal como verticalmente. El encabezado quedaría de esta manera:
   

   

   Como se observa en la imagen el título ya está listo. Aquí indicamos con un recuadro rojo dónde se encuentra la caja de texto, también indicamos donde se encuentre las herramientas del formato de texto y las herramientas para centrar un objeto en horizontal y vertical.
4. Agregar en el pie de página:  fecha de impresión y número del total de páginas.
   
   Para agregar la fecha de impresión hacemos lo siguiente:
   Agregamos dos cuadros de texto juntos, en el de la izquierda se escribirá “fecha de impresión:”, en el de la derecha  obtendremos la fecha actual, para esto debemos de dar click derecho sobre el cuadro de texto(esto cuando el cuadro no esté esperando que escribas en el) te aparecerán las siguientes opciones:
   

   Cortar
   Copiar
   Pegar
   Eliminar
   Diseño
   Seleccionar
   Expresión…
   Propiedades del cuadro de texto

   
   Remarcamos “Expresión” ya que es a la cual debemos dar click, esta nos llevará a la siguiente ventana en donde tenemos que hacer lo siguiente:
   

   

   
    1. Seleccionamos “funciones comunes”
   2. Se desplegarán varias opciones de las cuales daremos click en “&Fecha y hora”
   3. En el cuadro de la derecha de derecha aparecerán más opciones, buscaremos la que dice “Now” y damos doble click sobre ella 
   4. En el cuadro superior aparecerá “Now(” en la cual debemos escribir el paréntesis de cierre 
   5. Por ultimo damos click en Aceptar.
   
   Con esto ya tenemos la fecha de impresión.
   
   Para agregar el número y el total de páginas hacemos lo siguiente:
   Agregamos 4 cuadros de texto. En el primero escribiremos “Número de página”, en el segundo obtendremos mediante una expresión el número de página, en el tercero nada más se escribiremos una pleca y en el cuarto obtendremos el total de páginas. Para obtener el número de páginas en el segundo cuadro de texto seguimos los mismos pasos que  seguimos para obtener la fecha, hasta llegar a la misma ventana en la cual seleccionaremos “campos integrados” al hacer esto se desplegarán varias opciones de las cuales daremos doble click en “PageNumber” para obtener el número de páginas. Para obtener el total de páginas hacemos lo mismo sólo que en lugar de dar doble click en “PageNumber”  lo haremos en “TotalPages”. Al final de estos pasos en cada una daremos aceptar.
   

   

   Con esto ya tenemos la fecha de impresión, el número de páginas y el total de páginas.

   
   
   
5. Llamado del conjunto de datos “dsPulperia” .
   Para esto debemos de ir a “datos de informe” que sale en la parte izquierda nuestra.
   

   

   En esta sale un botón “Nuevo” al dar click sobre él aparecen las siguientes opciones:
   Conjunto de datos
   Parámetro
   Imagen
   Nosotros daremos click donde dice en la primera opción “conjunto de datos”. Al hacer esto nos llevará a la esta ventana:

   

   En Nombre podemos darle el nombre que queremos a nuestro dataset, en este caso lo dejaremos así como se muestra “DataSet1” en origen de datos seleccionamos el dataset que hemos creado “dsPulperia” y en Conjuntos de datos disponibles seleccionamos la tabla que está disponible para el conjunto de datos:

   

   Como se puede observar, al realizar esto se muestran los campos de la tabla “Pulperia”.
   Con esto ya hemos traído nuestro “dsPulperia” para poder utilizarlo en el informe.
6. Creación de tabla donde se visualizarán los datos:
   Para crear la tabla debemos ir al cuadro de herramientas y arrastrar el objeto Tabla a la superficie del diseño de nuestro informe.
   

   

   
   Ya en la imagen se puede observar que adentro de nuestro informe tenemos la tabla, ahora debemos de poner los campos que queremos mostrar.  Al pasar el cursor por la segunda fila de la tabla te aparecerá algo como lo que está en el recuadro rojo:
   
   

   

   Al dar click en él nos aparecerán los campos de nuestra tabla Pulperia si esto no es así es porque no se están vinculando los datos correctamente. Entonces agregamos cada campo en cada una de las columnas correspondientes:

   

   
   Como puedes observar ya hemos puesto los campos en  las tres columnas que nos dio la tabla, pero ahí nos faltan más campos que mostrar, entonces para esto debemos de agregar más columnas, para esto damos click derecho en la última columna y seleccionar “Insertar columna” al hacer esto te saldrá la opción si quieres insertar la columna a la izquierda o derecha, nosotros seleccionaremos a la derecha. Esto lo haremos las veces que lo necesitemos hasta ingresar los campos que queremos visualizar de nuestra tabla “Pulperia”. La tabla terminada quedaría de la siguiente manera:

   

   Nosotros hemos puesto la letra principal del título cada campo en mayúscula. Lo puedes hacer cuidadosamente.
   Ya aquí solo queda una cosa por hacer y es modificar el formato de la fecha. Para esto debemos se seleccionar la celda [fecha] luego ir a propiedades y buscar la propiedad “format” en esta escribiremos una “d” para que la fecha nos aparezca en este formato:

   

   
   
7. Visualizar nuestro reporte en un formulario
   Después que hemos terminado con nuestro informe de reporte ahora tenemos que crear un nuevo formulario y llamar a nuestro reporte. A este formulario lo llamaremos frm_reporte:
   

   

   Una vez creado el formulario debemos de arrastrar del cuadro de herramientas lo que es un “ReportViewer”. El objeto no aparecerá bien acoplado al formulario, por lo cual debemos de ir a una pequeña flechita que sale en la parte izquierda superior del objeto “ReportViewer” y dar click donde dice “Acoplar al contenido primario” con esto el resultado sería el siguiente:
   
   

   

   Como podemos observar el “ReportViewer” ya se ha acoplado al formulario. Ahora ya podemos hacer más grande el formulario. Ahora solo falta traer el informe que hemos creado anteriormente, para esto damos click en el ReportViewer y vamos a la misma flechita que aparece en la parte izquierda superior del objeto:
   

   

   
   

   Cuando damos click en ella nos aparecen varias opciones en las que esta una que dice “Elegir informe” y a su lado un cuadro de selección, en este nos tiene que aparecer el informe creado anteriormente, debemos seleccionarlo y con esto ya tenemos nuestro informe en el nuevo formulario.
   Nota: Para poder ejecutar el formulario de reporte debes ir a la clase “program” que está en el explorador de soluciones y en “Application.Run” debes especificar el nombre del formulario que quieres ejecutar: 

   

   Lo ejecutamos y si no hay ningún error, el resultado sería el siguiente:
   
   

   

   
   

   
   
8. Poblar tabla de informe con registros ingresados en el sistema
   Lo primero que debemos hacer aquí es agregar la librería:   using  MySql.Data.MySqlClient;
   
   
   
   
   
   En la imagen se puede ver que ya hemos agregado la librería antes mencionada. En el segundo recuadro se muestra el código generado por el reporte.
   
   Escritura de código para el poblamiento de información:
   
   
   
   

   

   
   

   
   

   Cada línea de código está explicada por comentarios…
   
   El resultado sería el siguiente:
   
   

   

   
   

   Como puedes observar la tabla ya me está mostrando los productos con cada uno de sus datos que hemos ingresado.
   Nota: No olvides tener funcionando la aplicación Xampp
   
   
   
   
   
   
   ¡Felicidades ya has creado un reporte en C#!

Conclusión

Esperamos que el tutorial haya sido de mucha ayuda para ti, ahora ya puedes crear reportes de tus Crud de datos en C# e imprimirlos o hacer lo que necesites con ellos. Te invitamos a que sigas viendo nuestros tutoriales de programación y a que te subscribas a nuestro canal en YouTube en donde subimos contenido de programación y diseño web todas las semanas. Y en este mismo Canal podrás encontrar este mismo tutorial explicado en video y así muchos tutoriales más.
https://www.youtube.com/channel/UCV3LU9oX8mcnVSnCD1KOSDg