Fichier de configuration RSWebApplication

Mis à jour : 17 juillet 2006

Le fichier RSWebApplication.config stocke les paramètres de configuration du Gestionnaire de rapports. Il spécifie les paramètres utilisés pour la distribution de rapports et le nombre de connexions ouvertes par utilisateur.

Emplacement du fichier

Ce fichier est situé dans le dossier \Reporting Services\ReportManager.

Instructions de modification

Vous pouvez modifier ce fichier pour limiter le nombre de connexions ouvertes, changer l'extension de remise par défaut et modifier le format de rendu de chaque extension de remise.

Exemple de configuration par défaut.

L'exemple suivant illustre certains paramètres et valeurs par défaut du fichier RSWebApplication.config.

<Configuration>
     <UI>
     <ReportServerUrl></ReportServerUrl>
     <ReportServerVirtualDirectory>ReportServer</ReportServerVirtualDirectory>
     <ReportBuilderTrustLevel>FullTrust</ReportBuilderTrustLevel>
     </UI>
     <Extensions>
          <DeliveryUI>
               <Extension Name="Report Server Email" Type="Microsoft.ReportingServices.EmailDeliveryProvider.EmailDeliveryProviderControl,ReportingServicesEmailDeliveryProvider">
                    <DefaultDeliveryExtension>True</DefaultDeliveryExtension>
                    <Configuration>
                         <RSEmailDPConfiguration>
                              <DefaultRenderingExtension>MHTML</DefaultRenderingExtension>
                         </RSEmailDPConfiguration>
                    </Configuration>
               </Extension>
               <Extension Name="Report Server FileShare" Type="Microsoft.ReportingServices.FileShareDeliveryProvider.FileShareUIControl,ReportingServicesFileShareDeliveryProvider"/>
          </DeliveryUI>
     </Extensions>
     <Add Key="MaxActiveReqForOneUser" Value="20"/>
     <Add Key="DisplayErrorLink" Value="true"/>
</Configuration>

Exemple de configuration secondaire pour accéder au point de terminaison d'un serveur de rapports

Cet exemple illustre comment utiliser ReportServerUrl au lieu de ReportServerVirtualDirectory.

Important :
Les paramètres de configuration respectent la casse. Lorsque vous ajoutez de nouvelles entrées, veillez à taper le paramètre exactement tel qu'il apparaît. Si la casse n'est pas correcte, une erreur similaire à la suivante s'affiche : « Le fichier de configuration contient un élément qui n'est pas valide. » L'élément ElementName n'est pas un élément du fichier de configuration. »

<UI>
     <ReportServerUrl>https://www.adventure-works.com/ReportServer</ReportServerUrl>
     <ReportServerVirtualDirectory></ReportServerVirtualDirectory>
     <ReportBuilderTrustLevel>FullTrust</ReportBuilderTrustLevel>
</UI>

Paramètres de configuration

Le tableau suivant contient des informations sur les paramètres par défaut. Les paramètres sont présentés dans l'ordre dans lequel ils apparaissent dans le fichier de configuration. Si vous utilisez des extensions de remise personnalisées, votre fichier de configuration contiendra des paramètres supplémentaires.

Paramètre	Description
ReportServerVirtualDirectory	Spécifie le point de terminaison SOAP du serveur de rapports utilisé par le Gestionnaire de rapports. La valeur est le nom du répertoire virtuel du serveur de rapports. Par exemple, si l'URL du serveur de rapports est http://adventure-works.com/serveurderapports, la valeur du paramètre ReportserverVirtualDirectory est serveurderapports. Ce paramètre suppose que le Gestionnaire de rapports et le serveur de rapports soient configurés de manière à utiliser le même site Web. S'ils recourent à différents sites Web, supprimez la valeur de ReportServerVirtualDirectory et utilisez ReportServerURL à la place. Pour plus d'informations sur les URL et ce paramètre, consultez Configuration des répertoires virtuels du serveur de rapports et Configuration d'un serveur de rapports pour un accès à Internet.
ReportServerUrl	Offre une autre solution pour spécifier le point de terminaison SOAP du serveur de rapports utilisé par le Gestionnaire de rapports. Vous pouvez utiliser ce paramètre à la place de ReportServerVirtualDirectory lorsque les répertoires virtuels du Gestionnaire de rapports et du serveur de rapports sont hébergés sur des serveurs ou sites Web distincts, ou si vous devez spécifier un nom de domaine complet pour le serveur de rapports. ReportServerURL et ReportServerVirtualDirectory s'excluent mutuellement. Si vous spécifiez ReportServerURL, vous devez supprimer l'entrée de ReportServerVirtualDirectory. Pour spécifier ce paramètre, vous devez modifier le fichier RSWebApplication.config manuellement. Les valeurs valides comprennent http://<server>/<reportserver> ou https://<server>/<reportserver> si vous utilisez des certificats. Si le Gestionnaire de rapports est installé séparément sur un serveur Web exposé à Internet, cette valeur doit être un nom de domaine complet permettant d'accéder à une instance de serveur de rapports située derrière le pare-feu. Vous ne pouvez jamais attribuer à ce paramètre la valeur localhost. Si un certificat SSL (Secure Sockets Layer) est installé, cette valeur doit être le nom du serveur inscrit pour ce certificat. Si vous obtenez l'erreur « La connexion sous-jacente a été fermée : Impossible d'établir une relation de confiance pour le canal sécurisé SSL/TLS », attribuez à ReportServerUrl le nom de domaine complet du serveur pour lequel le certificat a été émis. Par exemple, si le certificat est inscrit sur https://adventure-works.com.onlinesales, l'URL du serveur de rapports est https://adventure-works.com.onlinesales/reportserver. Pour consulter un exemple présentant l'utilisation de ce paramètre, reportez-vous à l'exemple fourni dans cette rubrique. Pour plus d'informations sur les URL et ce paramètre, consultez Configuration des répertoires virtuels du serveur de rapports.
ReportBuilderTrustLevel	Spécifiez si le Générateur de rapports est lancé en mode confiance totale ou confiance partielle. Les valeurs possibles sont FullTrust et PartialTrust. La valeur par défaut est FullTrust. Pour plus d'informations sur ces niveaux de confiance, consultez Démarrage du Générateur de rapports.
PassThroughCookies	Ce paramètre n'est pas inclus dans le fichier de configuration par défaut. Pour l'utiliser, vous devez l'ajouter manuellement. Ce paramètre configure le Gestionnaire de rapports de manière à transmettre des cookies d'authentification personnalisée. Pour plus d'informations et pour afficher un exemple de la spécification des paramètres de configuration, consultez Configuration du Gestionnaire de rapports pour transmettre des cookies d'authentification personnalisée
ReportServerExternalUrl	Ce paramètre n'est plus utilisé. Dans les versions précédentes, il permettait de fournir une URL complète de serveur de rapports aux applications et aux processus internes qui devaient envoyer des demandes à un serveur de rapports situé derrière un pare-feu. Ce paramètre n'était pas inclus dans le fichier de configuration par défaut. Si vous l'ajoutiez manuellement, vous pouvez soit le laisser dans le fichier, soit le supprimer. Notez que le déploiement du Générateur de rapports sur un serveur de rapports exposé à Internet constitue un scénario de déploiement non testé dans cette version. Si vous utilisiez ce paramètre par le passé pour gérer l'accès Internet au Générateur de rapports, vous devez prévoir une autre stratégie.
DeliveryUI	Spécifie les extensions de remise qui peuvent être utilisées avec les abonnements. Les noms d'extension que vous spécifiez dans cette section apparaissent comme des options de remise dans les pages de définition d'un abonnement du Gestionnaire de rapports. Reporting Services comprend deux extensions de remise par défaut pour les abonnements : messagerie électronique Report Server et partage de fichiers du serveur de rapports. Pour plus d'informations, consultez Configuration d'un Report Server pour la remise du courrier électronique et Remise par partage de fichiers dans Reporting Services.
DefaultDeliveryExtension	Spécifie si une extension de remise est celle par défaut. La messagerie électronique Report Server est l'extension de remise par défaut. Les valeurs valides sont True ou False. Si plusieurs extensions contiennent une valeur True, la première extension est considérée comme l'extension par défaut.
Configuration	Spécifie les options de configuration d'une extension de remise. Vous pouvez définir un format de rendu par défaut pour chaque extension de remise. Les valeurs valides sont les noms d'extension de rendu de la section de rendu du fichier rsreportserver.config.
MaxActiveReqForOneUser	Spécifie le nombre maximal de connexions actives qu'un utilisateur peut ouvrir simultanément sur le Gestionnaire de rapports. Une fois la limite atteinte, les demandes de connexion de l'utilisateur sont refusées. Ce paramètre de configuration est prévu pour minimiser la possibilité d'une attaque par déni de service. Les valeurs valides s'étendent de 0 à un entier maximal. 0 correspond à l'absence de limite du nombre de connexions. La valeur par défaut est 20. Remarquez que le traitement de la plupart des requêtes est extrêmement rapide si bien qu'il est très improbable qu'un seul utilisateur puisse cumuler plus de 20 connexions ouvertes à un moment donné. Si les utilisateurs ouvrent simultanément plus de 15 rapports nécessitant un traitement intensif, vous serez amené à augmenter cette valeur.
DisplayErrorLink	Affiche un lien vers le site Aide et support de Microsoft. Ce lien apparaît dans les messages d'erreur. Les utilisateurs peuvent accéder au site afin d'afficher un contenu mis à jour pour le message d'erreur. Les valeurs valides sont true ou false. La valeur par défaut est true.

Voir aussi

Concepts

Fichiers de configuration de Reporting Services
Fichier de configuration RSReportServer

Autres ressources

Implementing a Delivery Extension

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Nouveau contenu : Ajout d'un exemple qui indique comment spécifier ReportServerUrl.