Déploiement de rapports et de contrôles ReportViewer

Article
05/09/2011

Vous pouvez librement distribuer des rapports et les contrôles ReportViewer en tant que partie intégrante de votre application. Les conditions de déploiement varient largement selon le type de contrôle et la configuration de votre rapport en vue d'un traitement local ou distant. Vous pouvez déployer des rapports traités localement et à distance dans la même application.

Redistribution des contrôles ReportViewer

Le contrôle ReportViewer redistribuable est un fichier auto-extractible nommé ReportViewer.exe qui inclut un fichier .msi ainsi que d'autres fichiers. Vous trouverez ReportViewer.exe à l'emplacement suivant : %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages\ReportViewer\ReportViewer.exe. Vous pouvez également le télécharger à partir du Centre de téléchargement Microsoft.

Notes

Différentes versions du contrôle ReportViewer redistribuable peuvent être installées sur le même ordinateur.

Lorsque vous exécutez ReportViewer.exe, les fichiers suivants sont installés dans le dossier GAC (Global Assembly Cache) sur l'ordinateur de déploiement.

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

Exécution de ReportViewer.exe

Le type de contrôle que vous utilisez détermine où ReportViewer.exe doit être exécuté.

Pour les applications ASP.NET, exécutez ReportViewer.exe sur le serveur Web qui héberge votre application. Cette opération doit être effectuée par un administrateur du serveur.
Pour les applications Windows Forms, incluez les contrôles en tant que composants nécessaires à l'application afin qu'ils soient installés automatiquement avec votre application. Vous pouvez utiliser l'application d'amorçage pour automatiser cette étape :
1. Ouvrez la page des propriétés du projet.
2. Cliquez sur Publier, puis sur Composants requis.
3. Sélectionnez Visionneuse de rapports de Microsoft Visual Studio 2010, puis cliquez sur OK.
4. Publiez l'application.

Pendant l'installation de l'application, un contrôle est effectué sur l'ordinateur local pour voir si ReportViewer est déjà installé. S'il n'est pas installé, le programme d'installation effectue l'opération.

Déploiement des versions localisées des contrôles ReportViewer

Le contrôle ReportViewer redistribuable est localisé dans dix langues Visual Studio : Chinois simplifié, Chinois traditionnel, Français, Allemand, Italien, Japonais, Coréen, Portugais (Brésil), Russe et Espagnol. Si vous installez une version localisée de Visual Studio, vous pouvez trouver le contrôle ReportViewer redistribuable localisé dans %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\BootStrapper\Packages\ReportViewer\<lang>. Vous pouvez également télécharger n'importe quel contrôle ReportViewer redistribuable localisé à partir du Web.

Pour utiliser la version localisée du contrôle ReportViewer redistribuable qui accompagne Visual Studio, procédez comme suit :

Exécutez ReportViewer.exe.
Ouvrez le dossier qui contient le module linguistique souhaité. Les dossiers des modules linguistiques sont situés à l'adresse %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\BootStrapper\Packages\ReportViewer\<lang>.
Exécutez ReportViewerLP.exe.

Pour utiliser d'autres langues dans un contrôle ReportViewer, vous pouvez implémenter l'interface IreportViewerMessages3 ou IreportViewerMessages3 pour créer des info-bulles et d'autres types de texte d'interface utilisateur dans une langue spécifique.

Détection des paramètres de langue et de culture du navigateur

Si vous utilisez le contrôle serveur Web ReportViewer pour héberger des rapports dans une application de navigateur, n'oubliez pas de définir la culture du thread si vous souhaitez fournir une interface utilisateur correspondant aux paramètres de langue et de culture du navigateur. ASP.NET ne définit pas la culture du thread en fonction des informations d'en-tête fournies par le client. Pour mettre votre application en adéquation avec les paramètres de culture du navigateur, vous pouvez définir les propriétés Thread.CurrentCulture et Thread.CurrentUICulture dans le code de votre application. Pour plus d'informations sur l'utilisation des paramètres de culture dans votre application, consultez System.Globalization.CultureInfo (page pouvant être an anglais).

Aspects de déploiement pour le contrôle de serveur Web de visionneuse de rapport

Le déploiement d'une application ASP.NET dans une batterie de serveurs Web nécessite une confirmation supplémentaire pour s'assurer que l'État d'affichage est maintenu dans l'ensemble de la batterie de serveurs. Si vous déployez le contrôle de serveur Web ReportViewer dans un environnement de batterie de serveurs Web, vous devez spécifier l'élément machineKey dans le fichier Web.config de votre application. Pour plus d'informations, consultez Paramètres Web.config pour ReportViewer.

Les rapports traités dans le contrôle serveur Web ReportViewer présentent différentes exigences relatives au navigateur. Les problèmes de compatibilité de navigateur peuvent affecter la disponibilité de certains types de fonctionnalités de rapport. Pour plus d'informations, consultez Prise en charge d'un navigateur pour les contrôles de serveur Web ReportViewer.

Distribution des fichiers de rapports

Sauf si vous générez dynamiquement des fichiers de définition de rapport client au moment de l'exécution à l'aide de la méthode LocalReport.LoadReportDefinition ou ServerReport.LoadReportDefinition, différentes options sont à votre disposition pour distribuer des fichiers de rapports avec votre application, selon le mode de traitement du contrôle de la visionneuse de rapports.

Les rapports traités localement peuvent être stockés dans un dossier réseau ou compilés dans le fichier exécutable de l'application. Les rapports qui sont traités sur un serveur distant sont en général stockés sur un serveur de rapports SQL Server Reporting Services. À moins que vous ne vouliez utiliser la méthode ServerReport.LoadReportDefinition pour charger manuellement un rapport à partir d'un emplacement autre que le serveur de rapports, il n'existe aucun fichier de rapport à inclure dans votre application. Pour déployer des rapports qui sont publiés sur un serveur de rapports, vous devez fournir un accès permanent à un serveur de rapports et garantir que les utilisateurs d'applications sont autorisés à afficher des rapports sur ce serveur. Le déploiement de rapports de serveur nécessite une compréhension de l'extension d'authentification utilisée par le serveur de rapports et du modèle d'autorisation basé sur les rôles qui donne accès au contenu et aux opérations. Pour plus d'informations, consultez Aspects de déploiement pour les rapports de serveur.