Partager via

Accès URL (SSRS)

  • Article

L'accès URL du serveur de rapports dans SQL Server Reporting Services (SSRS) vous permet d'envoyer des commandes à un serveur de rapports par la biais d'une demande d'URL. Cette fonctionnalité vous permet de personnaliser le rendu des rapports sur un serveur de rapports en mode natif ou dans une bibliothèque SharePoint. Par exemple, vous pouvez visualiser le rapport en utilisant un ensemble spécifique de valeurs de paramètres de rapport, ou vous pouvez visualiser une page particulière d'intérêt dans le rapport. Vous pouvez définir ces paramètres dans une URL en utilisant des paramètres d'accès URL prédéfinis.

Vous pouvez personnaliser la manière dont le serveur de rapports traite le rapport en incluant des paramètres pour les formats de rendu ou pour spécifier l'aspect et la convivialité du visualiseur de rapports. Vous pouvez ensuite envoyer cette URL à d’autres personnes afin qu’elles puissent accéder à votre rapport de la même manière dans le navigateur.

L'accès à l'URL permet également d'effectuer d'autres actions :

Concepts de l’accès par URL

Le serveur de rapports traite les paramètres contenus dans les demandes d’URL adressées au serveur de rapports. La façon dont le serveur de rapports traite les requêtes URL dépend des paramètres, des préfixes de paramètres et des types d'éléments inclus dans l'URL. Les URL du serveur de rapports suivent les recommandations de mise en forme des URL indiquées dans la version préliminaire de la norme conjointe du W3C (World Wide Web Consortium) et de l'IETF. Les fonctionnalités d’URL de Reporting Services sont compatibles avec la plupart des navigateurs et applications Internet qui prennent en charge l’adressage URL standard.

Syntaxe de l’accès par URL

Les demandes d'URL peuvent contenir plusieurs paramètres, indiqués sans ordre précis. Les paramètres sont séparés par une esperluette (&) et les paires nom/valeur par un signe égal (=).

Comprendre les différents composants d’une chaîne d’accès URL est essentiel pour envoyer efficacement des commandes à un serveur de rapports SSRS. La chaîne d’accès URL inclut :

  • https://[rswebserviceurl] : URL du service web du serveurs de rapports.
  • ? : indique le début de la chaîne de requête qui contient des paramètres.
  • [pathinfo] : chemin d’accès au rapport ou à l’élément sur le serveur.
  • [&prefix:param=value] : Un ou plusieurs paramètres avec des préfixes facultatifs qui personnalisent le rendu ou le comportement du rapport.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Description de la syntaxe

La section suivante fournit une description détaillée de certains paramètres utilisés dans la chaîne d’accès URL. Pour obtenir une liste complète, consultez la référence des paramètres d’accès à l’URL.

rswebserviceurl

URL du service web du serveurs de rapports.

  • Pour le mode natif, il s’agit de l’URL du service web d’instance de serveur de rapports web configurée dans Reporting Services Configuration Manager. Pour plus d’informations, consultez Configurer des URL de serveurs de rapports (Gestionnaire de configuration du serveur de rapports).

    Par exemple :

    https://myrshost/reportserver
https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE

  • Pour le mode intégré SharePoint, il s’agit de l’URL du proxy Reporting Services sur un site SharePoint intégré à Reporting Services.

    Par exemple :

    https://myspsite/subsite/_vti_bin/reportserver

    Conseil

    Il est important que l'URL inclue la syntaxe de proxy _vti_bin pour acheminer la requête via SharePoint et le proxy HTTP Reporting Services. Le proxy ajoute à la requête HTTP le contexte nécessaire pour garantir une exécution correcte du rapport pour les serveurs de rapports en mode SharePoint.

pathinfo

Chemin relatif de l’élément dans la base de données du serveur de rapports en mode natif, ou URL complète de l’élément dans un catalogue SharePoint.

Chemin de l’élément du catalogue. Pour le mode natif, il s’agit du chemin d’accès relatif de l’élément dans la base de données du serveur de rapports, commençant par une barre oblique (/). Par exemple :

/AdventureWorks2022/Employee_Sales_Summary_2022

Pour le mode intégré SharePoint, il s’agit de l’URL complète de l’élément dans la bibliothèque SharePoint, y compris l’extension d’élément. Par exemple :

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl

&prefix :param=value

Dans une chaîne d’accès URL, vous ajoutez des paramètres et leurs valeurs correspondantes pour personnaliser le rendu ou le comportement du rapport. Vous construisez des paramètres dans des paires nom/valeur à l’aide de la syntaxe param=value, séparées par un ampersand (&).

Utilisez des préfixes facultatifs comme rs: ou rc: pour cibler des processus spécifiques au sein du serveur de rapports.

Remarque

Si aucun préfixe n'est spécifié pour un paramètre d'accès URL, ce dernier est traité par le serveur de rapports comme un paramètre de rapport. Les paramètres de rapport n'utilisent pas de préfixe de paramètre et respectent la casse.

L’exemple suivant montre l’URL complète, comme décrit dans cet article :

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008

Contenu connexe