Accès URL (SSRS)

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. Par exemple, vous pouvez personnaliser le rendu d'un rapport sur un serveur de rapports en mode natif ou dans une bibliothèque SharePoint. Vous pouvez afficher le rapport à l’aide d’un ensemble de valeurs de paramètre de rapport, ou vous pouvez consulter une page spécifique digne d’intérêt dans le rapport. Vous pouvez encapsuler ces informations dans l'URL à l'aide de paramètres d'accès URL prédéfinis. Vous pouvez personnaliser davantage la façon dont le serveur de rapports traite le rapport en incorporant des paramètres pour les formats de rendu ou pour l'apparence de la visionneuse de rapports. Vous pouvez ensuite coller cette URL directement dans un courrier électronique ou une page Web pour permettre à d’autres utilisateurs d’accéder à votre rapport de la même manière dans le navigateur.

Autres actions que vous pouvez exécuter via l'accès URL :

  • Envoyer des commandes à la visionneuse HTML, notamment ajuster son apparence

  • Répertorier les enfants d'un dossier de catalogue

  • Récupérer la définition XML d'un élément de catalogue

  • Effectuer le rendu d'un instantané d'historique de rapport

  • Gérer les sessions de rapport

Pour obtenir la liste complète des commandes et paramètres disponibles via l’accès URL, consultez Référence de paramètre d’accès URL.

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 gère les demandes d'URL dépend des paramètres, des préfixes de paramètres et des types d'éléments qui sont 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 sont séparées par un signe égal (=).

  
rswebserviceurl  
?  
reportpath  
      [&prefix:param=value]...n]  
  

Description de la syntaxe

rswebserviceurl
URL du service web du serveurs de rapports. Pour le mode natif, il s’agit de l’URL du service web de l’instance du serveur de rapports configurée dans le Gestionnaire de configuration de Reporting Services (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  

&
Utilisé pour séparer les paires nom/valeur des paramètres d'accès URL.

prefix
facultatif. Préfixe de paramètre d’accès URL (par exemple, rs: ou rc:) qui permet d’accéder à un processus spécifique exécuté sur le serveur de rapports.

Notes

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.

param
Le nom du paramètre.

value
Texte d'URL correspondant à la valeur du paramètre utilisé.

Remarque : Pour obtenir la liste des paramètres d’accès URL disponibles, consultez Référence sur les paramètres d’accès URL. Pour obtenir des exemples où des paramètres de rapport sont passés sur l’URL, consultez Passer un paramètre de rapport dans une URL.

Descriptions de tâche Liens
Accéder aux éléments du serveur de rapports, tels que des rapports, des sources de données partagées, et des ressources. Accéder à des éléments de serveurs de rapports à l’aide de l’accès URL
Passer des paramètres de rapport à un rapport. Passer un paramètre de rapport dans une URL
Définir les paramètres régionaux des paramètres de rapport dans la chaîne d'accès URL, qui définit les traductions spécifiques aux paramètres régionaux des dates, des devises, et ainsi de suite. Définir la langue des paramètres de rapport dans une URL
Envoyer les paramètres spécifiques d'extension de rendu qui personnalisent le rendu du rapport. Spécifier les paramètres d’informations des périphériques dans une URL
Exporter un rapport directement vers un format de fichier sans l'afficher dans le navigateur. Exporter un rapport à l’aide de l’accès URL
Ouvrir un rapport et accéder directement à l'emplacement d'une chaîne. Rechercher un rapport à l’aide de l’accès URL
Effectuer le rendu d'un instantané d'historique de rapport. Rendre un instantané d’historique de rapports à l’aide de l’accès URL