Implementar informes y controles ReportViewer

Artículo
05/18/2015

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 descargar ReportViewer.exe 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 ClickOnce de Windows Forms, incluya los controles como un requisito previo de la aplicación con objeto de que se instalen automáticamente con la aplicación ClickOnce. 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 la pestaña Publicar y, a continuación, haga clic en el botón Requisitos previos.
3. Seleccione Visor de informes de Microsoft Visual Studio y Tipos de CLR de SQL Server, y, a continuación, haga clic en Aceptar.
4. Asegúrese de que Descargar los requisitos previos del sitio web del proveedor de los componentes está activada. Esta es la única opción admitida. A continuación, haga clic en Aceptar.
5. Haga clic en el botón Opciones.
6. En la pestaña Implementación, especifique una página web de implementación y active la casilla Generar automáticamente la página web de implementación después de cada publicación.
7. Haga clic en Aceptar y publique la aplicación.
Cuando obtiene acceso una aplicación ClickOnce, por ejemplo a través de una página web, se realiza una comprobación en el equipo cliente para ver si los requisitos previos de ReportViewer están ya instalados. Si no están instalado, el programa de instalación lo instalará.

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 instala una versión localizada de Visual Studio, puede descargar cualquier redistribuible de ReportViewer localizado desde el Centro de descarga de Microsoft.

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 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, consulta 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 informes. Para obtener más información, consulta 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, consulta Consideraciones de implementación para informes de servidor.