Crystal Reports NET (win y web) Crystal Reports. Sumario Este documento describe como se emplea el control Crystal Reports en Visual Basic NET

Transcripción

1 La Güeb de Joaquín Programación Visual Basic.NET Crystal Reports Como se utiliza Crystal Reports en VB.NET Sumario Este documento describe como se emplea el control Crystal Reports en Visual Basic NET Índice de contenidos Como se utiliza Crystal Reports en VB.NET... 1 En documentos Windows... 1 A) Utilizar un control CristalReportViewer... 2 b) Impresión directa en la impresora... 3 c) Generando un fichero con formato PDF... 3 En documentos ASP NET... 5 A) Utilizar un control CristalReportViewer... 5 b) Impresión directa en la impresora... 6 c) Generando un fichero con formato PDF... 6 Fecha de última impresión: 23/02/ :48:09 Autor.: joaquin Medina Serrano (joaquin@medina.name) URL de este documento: VBNet/VBN03/alg_CrystalReports/ CrystalReportsyNET.pdf En documentos Windows En principio para utilizar Crystal Reports hay que importar los espacios de nombres Imports CrystalDecisions.CrystalReports.Engine Imports CrystalDecisions.Shared A continuación hay que generar el informe, cosa que no voy a explicar aquí como se hace, porque si no sabes como se hace no debes leer este documento porque que no entenderás ni nada de nada Una vez generado el informe, para utilizarlo hay varias maneras, o bien se utiliza un control CristalReportViewer, y se realiza una vista previa del informe, o bien se imprime directamente el informe en la impresora. 1

2 A) Utilizar un control CristalReportViewer Después de haberlo dejado en el formulario, y suponiendo que el control se llame CristalReportViewer1, y que el informe se llame CrystalReportAutores el código que hay que incluir es el siguiente. La función siguiente es un poco especial, en el sentido de que los datos que se cargan en el control no son los que selecciona el informe, sino que los pasamos en un DataSet y ese conjunto de datos son los que se representan en el informe. Por ejemplo, supongamos que el informe imprime todos los autores de libros de España, con esta función podemos utilizar el mismo informe para imprimir únicamente los autores de Zaragoza, o los de Valencia, según los datos que se pasen en el DataSet del parámetro. Mostrar una vista previa con un control CrystalReportViewer Public Sub Accion_ImprimirDatosVistaPrevia( _ CrystalReportViewer1.Visible = True Dim miinforme As New CrystalReportAutores miinforme.setdatasource(conjuntodedatos) CrystalReportViewer1.ReportSource = miinforme El código siguiente es el que presenta la ayuda MSDN, realiza el mismo trabajo pero tiene el inconveniente de que estamos accediendo a un recurso que esta en una dirección física del disco, con lo que la portabilidad del código es menor Mostrar una vista previa según la ayuda MSDN (mejor no emplear) ' Ayuda MSDN, entrada ' Opciones de enlace de informes de Windows Forms Viewers ' Imports CrystalDecisions.CrystalReports.Engine Public WithEvents orpt As ReportDocument Public Sub Accion_imprimirDatos( _ CrystalReportViewer1.Visible = True orpt = New ReportDocument orpt.load("../informes/crystalreportautores.rpt") 'Utilizar el modelo de objetos Report Engine 'para pasar conjuntos de datos llenos al informe orpt.setdatasource(conjuntodedatos) ' enlazar el objeto de informe con datos a ' Web Forms Viewer CrystalReportViewer1.ReportSource = orpt 2

3 b) Impresión directa en la impresora Imprimir directamente en la impresora predeterminada Protected Overrides Sub Accion_ImprimirDirectoEnImpresora() Dim odataset As New DataSet odataset.merge(me.authordata) Dim MiInforme As New CrystalReportAutores MiInforme.SetDataSource(oDataSet) ' Imprimir el informe. Establecer los parámetros startpagen y endpagen en 0 para imprimir todas las páginas. MiInforme.PrintToPrinter(1, False, 0, 0) c) Generando un fichero con formato PDF Por ultimo tenemos otra opción que consiste en imprimir el informe en un documento PDF o RTF, y guardarlo en disco. La forma de hacerlo se muestra en la siguiente función, como en los ejemplos anteriores se pasa el conjunto de datos que se quieren imprimir Imprimir en un fichero PDF '/** ****************************************************** ' Función : InformeCrystal_Forms_ImprimirDatosFormatoPDF ' ' Propósito...: ' Genera un fichero FDF a partir de un informe Cristal ' Parámetros...: ' Necesita recibir a través de los parámetros ' * El conjunto de datos a imprimir (DataSet) ' * El informe que utiliza para imprimir(crystal Report) ' * El nombre del fichero para el documento PDF ' Observación...: ' Solo funciona con Formularios Windows ' Necesita una referencia al espacio de nombres ' * CrystalDecisions.Shared ' * CrystalDecisions.CrystalReports.Engine ' '*/ Public Sub InformeCrystal_Forms_ImprimirDatosFormatoPDF( _ ByVal pconjuntodedatos As System.Data.DataSet, _ ByVal pinformecrystal As _ CrystalDecisions.CrystalReports.Engine.ReportDocument, _ ByVal pnombrefichero As System.String) Try ' informacion para el control "SaveFileDialog" pinformecrystal.setdatasource(pconjuntodedatos) 3

4 ' indicamos que el destino será un archivo del disco Dim diskopts As New CrystalDecisions.Shared. _ DiskFileDestinationOptions ' establecer el nombre del archivo de disco diskopts.diskfilename = pnombrefichero 'establecer el formato de exportación With pinformecrystal.exportoptions 'opciones de archivo de disco.destinationoptions = diskopts ' documento PDF.ExportFormatType = CrystalDecisions.Shared. _ ExportFormatType.PortableDocFormat ' documento rtf '.ExportFormatType = ExportFormatType.RichText ' documento Doc '.ExportFormatType = ExportFormatType.WordForWindows ' en disco.exportdestinationtype = CrystalDecisions.Shared. _ ExportDestinationType.DiskFile End With ' exportamos el informe pinformecrystal.export() ' informar de que se ha hecho sin problemas MessageBox.Show( _ "Terminada la grabación en disco del fichero" & _ ControlChars.CrLf & "[" & pnombrefichero & "]", _ "Proceso de Grabacion", _ MessageBoxButtons.OK, _ MessageBoxIcon.Information, _ MessageBoxDefaultButton.Button1, _ MessageBoxOptions.DefaultDesktopOnly) ' continua en el Finally ' ' ayuda MSDN ' Entrada [ExportToDisk] 'El siguiente ejemplo exporta el informe a disco 'como documento RTF. '[Visual Basic] ' Report.ExportToDisk(ExportFormatType.RichText, "report.rtf") ' Catch ex As Exception ' informar de la excepcion antes de enviarla hacia arriba MessageBox.Show( _ "ERROR" & ControlChars.CrLf & _ "Durante el proceso de generación del documento PDF" & _ " ha aparecido el siguiente error:" & _ ControlChars.CrLf & ex.message, _ "Proceso de Grabacion", _ MessageBoxButtons.OK, _ MessageBoxIcon.Error, _ MessageBoxDefaultButton.Button1, _ MessageBoxOptions.DefaultDesktopOnly) 4

5 Crystal Reports NET (win y web) ' lanzar el error hacia arriba Throw Finally ' cargarme las variables empleadas ' cerrar el informe If Not pinformecrystal Is Nothing Then pinformecrystal.close() pinformecrystal = Nothing End If If Not pconjuntodedatos Is Nothing Then pconjuntodedatos = Nothing End If If Not pnombrefichero Is Nothing Then pnombrefichero = Nothing End If End Try En documentos ASP NET También se pueden emplear el control CrystalReport en documentos ASP Net pero el código tiene algunas diferencias sutiles. A) Utilizar un control CristalReportViewer Mostrar una vista previa con un control CrystalReportViewer Public Sub Accion_ImprimirDatosVistaPrevia( _ CrystalReportViewer1.Visible = True Dim miinforme As New CrystalReportAutoresWeb miinforme.setdatasource(conjuntodedatos) CrystalReportViewer1.ReportSource = miinforme 5

6 b) Impresión directa en la impresora ### FALTA ### Esta mal hay un error Public Sub Accion_ImprimirImpresora( _ ' ' no consigo hacerla funionar ' me da el problema de que no reconoce la impresora por defecto Exit Sub ' Dim miinforme As New CrystalReportAutoresWeb miinforme.setdatasource(conjuntodedatos) ' Seleccionar la impresora. miinforme.printoptions.printername = String.Empty ' Imprimir el informe. Establecer los parámetros ' startpagen y endpagen en 0 para imprimir todas las páginas. miinforme.printtoprinter(1, False, 0, 0) c) Generando un fichero con formato PDF En realidad no es un fichero, sino una descarga directa al navegador de un documento PDF Es una de las partes más difíciles Aún no estoy convencido de que este código este libre de errores, Funcion preparatoria Public Sub Accion_imprimirDatos_FormatoPDF() ' instancia de un nuevo informe Dim MiInforme As New CrystalReportAutoresWeb MiInforme.SetDataSource(oDataSet) ' llamar a la funcion que hace el trabajo ExportToPDF(MiInforme) 6

7 Exportar en formato PDF Private Sub ExportToPDF(ByVal orpt As ReportDocument) ' ' origen de este código (18/02/2005) ' ' Export Crystal Reports to PDF ' Use this code when you're developing Web pages and you need to ' export Crystal Reports to PDF without creating their own files. ' The undocument FormatEngine property of ReportDocument class ' (you can see it using ObjectBrowser or ILDASM) gets the job done: ' Dim crexportoptions As ExportOptions crexportoptions = orpt.exportoptions With crexportoptions.formatoptions = New PdfRtfWordFormatOptions.ExportFormatType = ExportFormatType.PortableDocFormat End With Dim req As ExportRequestContext = New ExportRequestContext req.exportinfo = crexportoptions Dim st As System.IO.Stream st = orpt.formatengine.exporttostream(req) Response.ClearContent() Response.ClearHeaders() Response.ContentType = "application/pdf" Dim ln As Integer = 0 ln = CInt(st.Length) Dim b(ln) As Byte st.read(b, 0, ln) Response.BinaryWrite(b) Response.End() Referencias Bibliográficas Liberia MSDN de Microsoft documento.: Export Crystal Reports to PDF 7