En esta entrada les muestro los pasos para crear un reporte
con parámetros y cómo pasarlos de los TextBox del formulario a Report
Viewer, utilizando Visual Studio 2015 y SQL Server 2012.
Esta es la forma más cómoda y
sencilla que he descubierto para trabajar con parámetros y espero que les pueda
ser útil.
Para este ejemplo deberás crear una tabla llamada Ventas con la siguiente estructura e
información:
A partir de esta tabla genera un procedimiento almacenado
(SP) llamado reporteventas, el cual
será el encargado de recibir los parámetros de tipo fecha y recopilar la
información que deseamos plasmar en el reporte.
Observa que he creado dos variables de tipo Date
(FechaInicial y FechaFinal) las cuales, al ejecutar el SP harán referencia al
campo Fecha de la tabla Ventas.
Es importante que te asegures de que el SP funciona:
Ahora pasemos a nuestro proyecto en Visual Studio.
Tengo creado un formulario con los siguientes controles:
Dos label, dos DateTimePicker y un botón desde el cual se
imprimirá el reporte.
El siguiente paso será agregar el diseñador de reporte de
Report Viewer. Para ello, agrega un nuevo ítem al proyecto y da clic en
Reporting/Report y asígnale un nombre, para este ejemplo lo he llamado DiseñoReporte.
Nota: Si no te aparece la presente opción es necesario que
corras el ejecutable de Visual Studio e instales DataTools.
Posteriormente se mostrará el diseñador de reportes de
Report Viewer.
El primer paso es configurar un origen de datos, es decir,
indicarle desde qué instancia, base de datos y tabla (En nuestro caso SP)
deberá traer la información.
Da clic derecho sobre Datasets/Add Dataset, si el diseñador
detecta que aún no tienes configurado un origen de datos (Como en este ejemplo)
solicitará que configures uno.
Se mostrará la siguiente ventana donde hay que seleccionar
el origen de datos, en este caso es DataBase/Next.
En el siguiente apartado indica el nombre de la instancia de
SQL/ credenciales de autenticación por SQL, así como el nombre de la base de
datos de la cual se consultará la información.
Selecciona la base de datos:
Luego se mostrará la estructura de la base de datos
seleccionada (Tablas, Vistas, SP, Funciones).
Selecciona Stored Procedures/y
marca el SP creado inicialmente. Por último es necesario asignar un nombre al origen de datos.
Si has seguido los pasos hasta aquí, tendrás una vista del
origen de datos. Para este ejemplo el SP
y los respectivos campos que lo conforman.
De lado izquierdo se mostrará esta misma información para
poder utilizarla en el diseñador del reporte.
El siguiente paso, es comenzar a dar forma al reporte que se
presentará.
Agrega los parámetros (Parameters/Add Parameter) que en este
caso serán la fecha inicial y fecha final y asígnales un nombre.
Una vez capturados los parámetros, selecciónalos y
arrástralos hasta el diseño del nuevo reporte como se muestra en la imagen.
Agrega una tabla al diseño del reporte que es donde se
mostrarán los datos que contiene el DataSet.
Una vez que se agrega posiciónate sobre el lado derecho de
cada celda para seleccionar el campo que deseas se muestre en cada espacio,
como se muestra en la imagen.
Si lo prefieres también puedes agregar una fila para mostrar
totales de las columnas.
Una vez que el diseño del reporte esté listo, pasemos al
formulario desde el cual se capturarán los parámetros y se mostrará la
información del reporte.
En el formulario es necesario agregar un elemento de tipo
ReportViewer. Una vez agregado, en la esquina superior derecha deberás
seleccionar el formato de reporte (.rdlc) que se creó anteriormente.
Una vez seleccionado el reporte, es importante verificar que
en la parte inferior del formulario se agreguen automáticamente el DataSet,
BindingSource y el TableAdapter con el nombre del SP.
Ahora pasemos al código del formulario. Observarás que de
forma automática se agregaron dos líneas de código en el evento load del mismo.
Es necesario pasarlas al evento click del botón.
La primer línea es la encargada de recibir los parámetros y
pasárselos al DataSet para que éste se encargue de traer la información que
ocupamos visualizar. Inicialmente marca un error en Fill, esto se debe a que aún no le hemos indicado de qué campos
deberá tomar los valores de los parámetros que ocupa el SP.
El código, ya con campos de parámetros incluidos deberá
quedar de la siguiente forma:
Entre las dos líneas de código anteriores he codificado la
forma como se deberá pasar el rango de fecha, proveniente del DateTimePicker, a
Report Viewer.
Observa que he indicado el número de parámetros que se
pasarán, en este caso son dos y por eso he puesto 1(El conteo comienza desde
cero). En la línea siguiente se manda llamar el nombre textual de cada
parámetro que se definió anteriormente en el diseño del reporte y se asocia con
el campo del cual tomará su valor.
Es importante mencionar que en el formulario donde se
cargará la información deberás agregar la siguiente referencia, de lo contrario
marcará un error en Parameters:
Imports Microsoft.Reporting.WinForms
Una vez hecho lo anterior solo queda ejecutar el desarrollo
y deberás obtener algo muy parecido a lo que se muestra en la siguiente imagen
donde el rango de fechas capturado en los DateTimePicker se visualizan
también en el reporte:
Ahora solo queda que adaptes el código a tu desarrollo y
listo.
¡Hasta la próxima!
Ing. Guadalupe López
"Ningún conocimiento es válido sino se comparte"
