Implementar informes y controles ReportViewer

Artículo
05/09/2011

Puede distribuir informes y controles ReportViewer libremente como parte de la aplicación. Los requisitos de implementación varían en gran medida en función del tipo de control y de que el informe esté configurado para un procesamiento local o remoto. Puede implementar informes procesados tanto local como remotamente en la misma aplicación.

Redistribuir controles ReportViewer

El componente redistribuible del control ReportViewer es un archivo autoextraíble denominado ReportViewer.exe que incluye un archivo .msi y otros archivos. Puede encontrar ReportViewer.exe en la ubicación siguiente: %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages\ReportViewer\ReportViewer.exe. También puede descargarlo desde el Centro de descarga de Microsoft.

Nota

Puede haber varias versiones del componente redistribuible del control ReportViewer instaladas en el mismo equipo.

Cuando se ejecuta ReportViewer.exe, se instalan los archivos siguientes en la carpeta de la caché global de ensamblados del equipo de implementación.

Microsoft.ReportViewer.Common.dll
Microsoft.ReportViewer.ProcessingObjectModel.dll
Microsoft.ReportViewer.WebForms.dll
Microsoft.ReportViewer.WinForms.dll
Microsoft.ReportViewer.DataVisualization.dll

Ejecutar ReportViewer.exe

El tipo de control que utilice determinará dónde debe ejecutarse ReportViewer.exe.

Para las aplicaciones ASP.NET, ejecute ReportViewer.exe en el servidor web que hospeda la aplicación. Esto debe hacerlo un administrador del servidor.
Para las aplicaciones de Windows Forms, incluya los controles como un requisito previo de la aplicación con objeto de que se instalen automáticamente con ella. Puede utilizar la aplicación de programa previo para automatizar este paso:
1. Abra la página de propiedades del proyecto.
2. Haga clic en Publicar y, a continuación, haga clic en Requisitos previos.
3. Seleccione Visor de informes de Microsoft Visual Studio 2010 y, a continuación, haga clic en Aceptar.
4. Publique la aplicación.

Durante la instalación de la aplicación, se realiza una comprobación en el equipo local para ver si ya está instalado ReportViewer. Si no está instalado, el programa de instalación lo instala.

Implementar versiones localizadas del control ReportViewer

Existen versiones localizadas del componente redistribuible del control ReportViewer en diez idiomas de Visual Studio: chino simplificado, chino tradicional, francés, alemán, italiano, japonés, coreano, portugués (Brasil), ruso y español. Si ha instalado una versión localizada de Visual Studio, puede encontrar el componente redistribuible del control ReportViewer localizado en %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\BootStrapper\Packages\ReportViewer\<lang>. También puede descargar de Internet cualquier componente redistribuible del control ReportViewer localizado.

Para usar la versión localizada del componente redistribuible del control ReportViewer que viene con Visual Studio, haga lo siguiente:

Ejecute ReportViewer.exe.
Navegue hasta la carpeta que contiene el paquete de idioma que desea utilizar. Las carpetas de los paquetes de idioma están ubicadas en %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\BootStrapper\Packages\ReportViewer\<lang>.
Ejecute ReportViewerLP.exe.

Para utilizar otros idiomas en un control ReportViewer, puede implementar la interfaz IreportViewerMessages3 o IreportViewerMessages3 para crear información sobre herramientas y otros textos de la interfaz de usuario en un idioma específico.

Detectar la configuración de idioma y de referencia cultural del explorador

Si usa el control de servidor web ReportViewer para hospedar informes en una aplicación de explorador, asegúrese de establecer la referencia cultural del subproceso si desea proporcionar una interfaz de usuario que coincida con la configuración de idioma y de referencia cultural del explorador. ASP.NET no establece la referencia cultural del subproceso basándose en la información de encabezado proporcionada por el cliente. Para que su aplicación se ajuste a la configuración de referencia cultural del explorador, puede establecer las propiedades Thread.CurrentCulture y Thread.CurrentUICulture en el código de la aplicación. Para obtener más información sobre cómo trabajar con la configuración de referencia cultural en la aplicación, vea System.Globalization.CultureInfo.

Consideraciones de implementación para el control de servidor web ReportViewer

La implementación de una aplicación ASP.NET en un grupo de servidores web requiere una configuración adicional para asegurar que el estado de vista se mantenga a lo largo del grupo de servidores. Si está implementando el control de servidor web ReportViewer en un entorno de servidores web, debe especificar el elemento machineKey en el archivo web.config de la aplicación. Para obtener más información, vea Configuración de web.config para ReportViewer.

Los informes que se procesan en el control de servidor web ReportViewer cuentan con una serie de requisitos del explorador que pueden variar. Los problemas de compatibilidad del explorador pueden afectar a la disponibilidad de algunos tipos de funciones de informe. Para obtener más información, vea Compatibilidad del explorador para controles de servidor web ReportViewer.

Distribuir archivos de informe

Salvo que se estén generando archivos de definición de informe del cliente (.rdlc) dinámicamente en tiempo de ejecución con el método LocalReport.LoadReportDefinition o ServerReport.LoadReportDefinition, tiene varias opciones para distribuir archivos de definición de informe con una aplicación, en función del modo de procesamiento del control ReportViewer.

Los informes que se procesan localmente se pueden almacenar en una carpeta de la red o compilarse en el archivo ejecutable de la aplicación. Los informes que se procesan en un servidor remoto normalmente se almacenan en un servidor de informes de SQL Server Reporting Services. A menos que desee utilizar el método ServerReport.LoadReportDefinition para cargar manualmente un informe desde una ubicación que no sea el servidor de informes, no es necesario que incluya ningún archivo de informe en la aplicación. Para implementar los informes que se publican en un servidor de informes, debe proporcionar un acceso continuo a un servidor de informes y asegurarse de que los usuarios de la aplicación estén autorizados para ver informes en dicho servidor. Para implementar informes del servidor es necesario entender la extensión de autenticación utilizada por el servidor de informes y el modelo de autorización basado en funciones que proporciona acceso al contenido y a las operaciones. Para obtener más información, vea Consideraciones de implementación para informes de servidor.