URL des fichiers de configuration (Reporting Services)

Reporting Services stocke les paramètres d'application dans un fichier RSReportServer.config. Ce fichier contient des paramètres de configuration pour les URL et pour les réservations d'URL. Ces paramètres de configuration ont des règles de modification et des objectifs très différents. Si vous êtes habitué à la modification de fichiers de configuration pour régler un déploiement, cette rubrique peut vous aider à comprendre comment chaque paramètre URL est utilisé.

Paramètres d'URL du fichier RSReportServer.config

Reporting Services stocke les URL pour l'accès aux applications et aux rapports, et pour connecter les composants Web frontaux à un serveur de rapports principal.

URL d'accès aux applications

Les URL permettent d'accéder au service Web Report Server et au Gestionnaire de rapports. Pour configurer les URL, vous devez utiliser l'outil de configuration de Reporting Services. L'outil crée les réservations d'URL pour chaque application dans HTTP.SYS et ajoute des entrées pour les URL dans la section URLReservations de RSReportServer.config.

URL d'accès aux rapports

Reporting Services inclut une extension de remise par messagerie de serveur de rapports que vous pouvez utiliser pour envoyer les liens de rapport ou les pièces jointes. Un lien de rapport est construit lorsque le rapport est remis. L'extension de remise par messagerie de serveur de rapports utilise le paramètre UrlRoot du fichier de configuration pour créer le lien. UrlRoot est également utilisé pour résoudre les liens d'un rapport rendu et généré via un traitement des rapports sans assistance.

UrlRoot est spécifié automatiquement dans le fichier RSReportServer.config lorsque vous configurez les URL pour l'accès aux applications. Si vous modifiez cette valeur dans le fichier de configuration, vous devez spécifier l'adresse URL valide d'un service Web Report Server connecté à une base de données de serveur de rapports qui contient les rapports que vous souhaitez remettre. Vous pouvez spécifier un seul élément UrlRoot pour une instance de serveur de rapports unique ; une seule entrée UrlRoot peut exister dans le fichier RSReportServer.config pour toute instance de serveur de rapports donnée. Si vous avez plusieurs URL réservées pour le service Web Report Server, vous devez choisir l'une des valeurs disponibles pour UrlRoot.

Dans la plupart des cas, vous n'avez pas besoin de modifier UrlRoot. Toutefois, si le serveur de rapports est accessible via une URL complète et que vous n'avez pas configuré une URL qui utilise l'en-tête de l'hôte sur le nom de site complet, vous devez modifier le fichier RSReportServer.config manuellement pour définir UrlRoot avec l'URL complète du serveur de rapports qui sera utilisée pour restituer le rapport (par exemple, https://www.adventure-works.com/mywebapp/reportserver).

URL connectant le Gestionnaire de rapports et les composants WebPart au service Web Report Server

Le Gestionnaire de rapports et les composants WebPart SharePoint 2.0 pour Reporting Services sont les composants Web frontaux qui se connectent à un serveur de rapports. Les URL utilisées pour se connecter à un serveur de rapports principal sont les suivantes :

  • ReportServerUrl (élément utilisé par le Gestionnaire de rapports)

  • ReportServerExternalUrl (élément utilisé par les composants WebPart)

Notes

Les versions antérieures de Reporting Services incluaient l'élément ReportServerVirtualDirectory. Cette valeur est obsolète dans SQL Server 2008. Si vous avez mis à niveau une installation existante et utilisez un fichier de configuration qui contient ce paramètre, le serveur de rapports ne lit plus cette valeur.

Le tableau suivant récapitule toutes les URL pouvant être spécifiées dans un fichier de configuration de Reporting Services.

Paramètre

Utilisation

Description

ReportServerUrl

Facultatif. Cet élément n'est pas inclus dans le fichier RSReportServer.config à moins que vous ne l'ajoutiez vous-même.

Définissez cet élément uniquement si vous configurez l'un des scénarios suivants :

  • Le Gestionnaire de rapports fournit un accès Web frontal à un service Web Report Server qui s'exécute sur un autre ordinateur ou sur une instance différente du même ordinateur.

  • Lorsque vous avez plusieurs URL vers un serveur de rapports et que vous souhaitez que le Gestionnaire de rapports utilise une URL spécifique.

  • Vous avez une URL du serveur de rapports spécifique que vous souhaitez voir utilisée par toutes les connexions du Gestionnaire de rapports.

    Par exemple, vous pouvez activer l'accès du Gestionnaire de rapports pour tous les ordinateurs du réseau, tout en requérant que le Gestionnaire de rapports se connecte au serveur de rapports à travers une connexion locale. Dans ce cas, vous pouvez configurer ReportServerUrl avec la valeur « https://localhost/reportserver ».

Pour obtenir des instructions sur l'implémentation de ces scénarios, consultez Procédure : configurer le Gestionnaire de rapports dans la documentation en ligne de SQL Server.

Cette valeur spécifie l'URL du service Web Report Server. Cette valeur est lue par l'application du Gestionnaire de rapports au démarrage. Si cette valeur est définie, le Gestionnaire de rapports se connecte au serveur de rapports spécifié dans l'URL.

Par défaut, le Gestionnaire de rapports fournit un accès Web frontal à un service Web Report Server qui s'exécute au sein de la même instance du serveur de rapports que le Gestionnaire de rapports. Toutefois, si vous souhaitez utiliser le Gestionnaire de rapports avec un service Web Report Server qui fait partie d'une autre instance ou s'exécute dans une instance d'un autre ordinateur, vous pouvez définir cette URL de façon à diriger le Gestionnaire de rapports pour qu'il se connecte au service Web Report Server externe.

Si un certificat SSL (Secure Sockets Layer) est installé sur le serveur de rapports auquel vous êtes connecté, la valeur de l'élément ReportServerUrl doit être le nom du serveur inscrit pour ce certificat. Si l'erreur « La connexion sous-jacente a été fermée. Impossible d'établir une relation de confiance pour le canal sécurisé SSL/TLS » s'affiche, définissez l'élément ReportServerUrl avec le nom de domaine complet du serveur pour lequel le certificat SSL a été émis. Par exemple, si le certificat est inscrit sur https://adventure-works.com.ventesenligne, l'URL du serveur de rapports sera https://adventure-works.com.ventesenligne/serveurderapports.

ReportServerExternalUrl

Facultatif. Cet élément n'est pas inclus dans le fichier RSReportServer.config à moins que vous ne l'ajoutiez vous-même.

Définissez cet élément uniquement si vous utilisez les composants WebPart de SharePoint 2.0 et que vous souhaitez que les utilisateurs soient en mesure d'extraire un rapport et de l'ouvrir dans une nouvelle fenêtre de navigateur.

Ajoutez l'élément <ReportServerExternalUrl> sous l'élément <ReportServerUrl>, puis définissez-le avec un nom de serveur de rapports complet qui se résout en une instance de serveur de rapports en cas d'accès dans une fenêtre de navigateur distincte. Ne supprimez pas <ReportServerUrl>.

L'exemple suivant illustre la syntaxe :

<ReportServerExternalUrl>http://myserver/reportserver</ReportServerExternalUrl>

Cette valeur est utilisée par les composants WebPart de SharePoint 2.0.

Dans les versions précédentes, il était recommandé que vous définissiez cette valeur pour déployer le Générateur de rapport sur un serveur de rapports Internet. Il s'agit d'un scénario de déploiement non testé. 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.