Accès URL (SSRS)URL Access (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.URL access of the report server in SQL Server Reporting Services (SSRS) enables you to send commands to a report server through a URL request. Par exemple, vous pouvez personnaliser le rendu d'un rapport sur un serveur de rapports en mode natif ou dans une bibliothèque SharePoint.For example, you can customize the rendering of a report on a native mode report server or in a SharePoint library. Vous avez peut-être affiché le rapport à l'aide d'un ensemble de valeurs de paramètre de rapport, ou vous avez peut-être consulté une page spécifique digne d'intérêt dans le rapport.You may have viewed the report using a specific set of report parameter values, or you may have been viewing a particular page of interest in the report. Vous pouvez encapsuler ces informations dans l'URL à l'aide de paramètres d'accès URL prédéfinis.You can encapsulate this information in the URL using predefined URL access parameters. 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.You can further customize how the report server processes the report by embedding parameters for rendering formats or for the look and feel of the report viewer. 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.You can then paste this URL directly into an email or Web page to let others to access your report in the same manner in the browser.

Autres actions que vous pouvez exécuter via l'accès URL :Other actions you can perform through URL access are:

  • Envoyer des commandes à la visionneuse HTML, notamment ajuster son apparenceSend commands to the HTML viewer, such as adjusting its look and feel

  • Répertorier les enfants d'un dossier de catalogueList the children of a catalog folder

  • Récupérer la définition XML d'un élément de catalogueRetrieve the XML definition of a catalog item

  • Effectuer le rendu d'un instantané d'historique de rapportRender a specific report history snapshot

  • Gérer les sessions de rapportManage report sessions

    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.For the complete list of commands and settings available through URL access, see URL Access Parameter Reference.

Concepts d'accès URLURL Access Concepts

Les demandes d'URL au serveur de rapports contiennent des paramètres qui sont traités par le serveur de rapports.URL requests to the report server contain parameters that are processed by the report server. 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.The way in which the report server handles URL requests depends on the parameters, parameter prefixes, and types of items that are included in the 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.Report server URLs adhere to the URL formatting guidelines as proposed by the joint World Wide Web Consortium W3C/IETF draft standard. Reporting ServicesReporting Services Les fonctionnalités d’URL sont compatibles avec la plupart des navigateurs et applications Internet qui prennent en charge l’adressage URL standard. URL functionality is compatible with most Internet browsers or applications that support standard URL addressing.

Syntaxe de l'accès URLURL Access Syntax

Les demandes d'URL peuvent contenir plusieurs paramètres, indiqués sans ordre précis.URL requests can contain multiple parameters that are listed in any order. Les paramètres sont séparés par une esperluette (&) et les paires nom/valeur sont séparées par un signe égal (=).Parameters are separated by an ampersand (&) and name/value pairs are separated by an equal sign (=).


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

Description de la syntaxeSyntax Description

rswebserviceurlrswebserviceurl
URL du service web du serveurs de rapports.The Web service URL of the report server. 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 de SSRS)).For native mode, it is the Web service URL of the report server instance configured in Reporting Services Configuration Manager (see Configure Report Server URLs (SSRS Configuration Manager)). Exemple :For example:

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

Pour le mode intégré SharePoint, il s’agit de l’URL du proxy Reporting ServicesReporting Services sur un site SharePoint intégré à Reporting ServicesReporting Services.For SharePoint integrated mode, it is the URL of the Reporting ServicesReporting Services proxy at a SharePoint site integrated with Reporting ServicesReporting Services. Par exemple :For example:

http://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 ServicesReporting Services .It is important the URL include the _vti_bin proxy syntax to route the request through SharePoint and the Reporting ServicesReporting Services HTTP proxy. 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.The proxy adds some context to the HTTP request, context that is required to ensure proper execution of the report for SharePoint mode report servers.

pathinfopathinfo
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.The relative path name of the item in the native mode report server database, or the fully qualified URL of the item in a SharePoint catalog.

Chemin de l’élément du catalogue.The path of the catalog item. Pour le mode natif, il s’agit du chemin relatif de l’élément dans la base de données du serveur de rapports, commençant par une barre oblique (/).For native mode, it is the relative path of the item in the report server database, beginning with a slash (/). Par exemple :For example:

/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2  

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.For SharePoint integrated mode, it is the fully qualified URL of the item in the SharePoint library, including the item extension. Par exemple :For example:

http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl  

&
Utilisé pour séparer les paires nom/valeur des paramètres d'accès URL.Used to separate name and value pairs of URL access parameters.

prefixprefix
Ce paramètre est facultatif.Optional. 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.A prefix for the URL access parameter (for example, rs: or rc:) that accesses a specific process running within the report server.

Note

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.If a prefix for a URL access parameter is not included, the parameter is processed by the report server as a report parameter. Les paramètres de rapport n'utilisent pas de préfixe de paramètre et respectent la casse.Report parameters do not use a parameter prefix and are case-sensitive.

paramparam
Le nom du paramètre.The parameter name.

valeurvalue
Texte d'URL correspondant à la valeur du paramètre utilisé.URL text corresponding to the value of the parameter being used.

Remarque : Pour obtenir la liste des paramètres d’accès URL disponibles, consultez Référence de paramètre d’accès URL.Note: For a list of the available URL access parameters, see URL Access Parameter Reference. 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.For examples passing report parameters on the URL, see Pass a Report Parameter Within a URL.

Descriptions de tâcheTask Descriptions LiensLinks
Accéder aux éléments du serveur de rapports, tels que des rapports, des sources de données partagées, et des ressources.Access report server items, such as reports, shared data sources, and resources. Accéder à des éléments de serveur de rapports à l'aide de l'accès URLAccess Report Server Items Using URL Access
Passer des paramètres de rapport à un rapport.Pass report parameters to a report. Passer un paramètre de rapport dans une URLPass a Report Parameter Within a 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.Set the locale of the report parameters in the URL access string, which defines the locale-specific interpretations of dates, currencies, and so on. Définir la langue des paramètres de rapport dans une URLSet the Language for Report Parameters in a URL
Envoyer les paramètres spécifiques d'extension de rendu qui personnalisent le rendu du rapport.Send rendering extension specific settings that customize how the report is rendered. Spécifier les paramètres d'informations de périphérique dans une URLSpecify Device Information Settings in a URL
Exporter un rapport directement vers un format de fichier sans l'afficher dans le navigateur.Export a report directly to a file format without viewing it in the browser. Exporter un rapport à l'aide de l'accès URLExport a Report Using URL Access
Ouvrir un rapport et accéder directement à l'emplacement d'une chaîne.Open a report and navigate directly to the location of a string. Rechercher un rapport à l'aide de l'accès URLSearch a Report Using URL Access
Effectuer le rendu d'un instantané d'historique de rapport.Render a specific report history snapshot. Rendre un instantané d'historique de rapport à l'aide de l'accès URLRender a Report History Snapshot Using URL Access

Voir aussiSee Also

Passer un paramètre de rapport dans une URL Pass a Report Parameter Within a URL
Référence de paramètres d’accès URL URL Access Parameter Reference
Intégration de Reporting Services à l’aide de l’accès URL Integrating Reporting Services Using URL Access
Recherche, affichage et gestion de rapports (Générateur de rapports et SSRS)Finding, Viewing, and Managing Reports (Report Builder and SSRS )