Partager via


Référence de paramètres d'accès URL

Vous pouvez utiliser les paramètres suivants dans une URL pour configurer l’apparence de vos rapports . Les paramètres les plus courants sont répertoriés dans cette section. Les paramètres ne sont pas sensibles à la casse et commencent par le préfixe de paramètre rs: s’ils sont dirigés vers le serveur de rapports ou par rc: s’ils sont dirigés vers une visionneuse HTML. Vous pouvez également spécifier des paramètres spécifiques aux périphériques ou des extensions de rendu. Pour plus d’informations sur les paramètres spécifiques au périphérique, consultez Spécifier les paramètres d’informations de périphérique dans une URL.

Important

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. Pour obtenir des exemples, consultez Access Report Server Items Using URL Access.

Pour plus d'informations sur l'inclusion de paramètres de rapport dans une URL et pour obtenir des exemples, consultez Pass a Report Parameter Within a URL.

Commandes de visionneuse HTML (rc:)

Le tableau suivant décrit les paramètres d’accès d’URL qui sont précédés de rc : et sont utilisés pour cibler la visionneuse HTML.

Paramètre Description Valeurs
Barre d’outils Affiche ou masque la barre d'outils.

** Important ** rc :Toolbar=false ne fonctionne pas pour les chaînes d’accès URL qui utilisent une adresse IP, au lieu d’un nom de domaine, pour cibler un rapport hébergé sur un site SharePoint.
Si la valeur de ce paramètre est false, toutes les options restantes sont ignorées. Si vous omettez ce paramètre, la barre d'outils s'affiche automatiquement pour les formats de rendu assurant sa prise en charge. La valeur par défaut de ce paramètre est true.

true
false
Paramètres Affiche ou masque la zone de paramètres de la barre d'outils.

Native exemple de mode :

http://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

SharePoint exemple de mode :

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed
Si vous affectez à ce paramètre la valeur true, la zone de paramètres de la barre d'outils s'affiche. Si vous lui affectez la valeur false, la zone de paramètres ne s'affiche pas et ne peut pas être affichée par l'utilisateur. Si vous affectez à ce paramètre une valeur Collapsed, la zone de paramètres ne s'affiche pas, mais l'utilisateur final peut la faire apparaître. La valeur par défaut de ce paramètre est true. Les valeurs valides sont :

true
false
Collapsed
Zoom Définit la valeur du zoom du rapport comme un pourcentage entier ou une constante de chaîne.

Native exemple de mode :

http://myrshost/reportserver?/Sales&rc:Zoom=Page Width

SharePoint exemple de mode :

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width
Les valeurs de chaîne standard incluent les valeurs Page Width et Whole Page. Ce paramètre est ignoré par les versions d’Internet Explorer plus anciennes que la version 5.0 et par tous les navigateurs autres que Microsoft. La valeur par défaut de ce paramètre est 100.
Section Définit la page du rapport à afficher.

Native exemple de mode pour afficher la page 2 du rapport :

http://myrshost/reportserver?/Sales&rc:Section=2

SharePoint exemple de mode pour afficher la page 2 du rapport :

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2
Toute valeur supérieure au nombre de pages du rapport affiche la dernière page. Toute valeur inférieure à 0 affiche la page 1 du rapport. La valeur par défaut de ce paramètre est 1.
FindString Rechercher dans un rapport un texte spécifique.

Native exemple de mode :

http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400

SharePoint exemple de mode :

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400
StartFind Spécifie la dernière section à explorer.

Native exemple de mode qui recherche la première occurrence du texte « Mountain-400 » dans l’exemple de rapport Catalogue de produits commençant par la page 1 et se terminant par la page cinq :

https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400
La valeur par défaut de ce paramètre est la dernière page du rapport.
EndFind Définit le numéro de la dernière page à utiliser dans la recherche. Par exemple, une valeur de 5 indique que la dernière page à explorer est la page 5 du rapport. Utilisez ce paramètre conjointement avec le paramètre StartFind . Consultez l’exemple ci-dessus pour StartFind . La valeur par défaut est le numéro de la page active.
FallbackPage Définit le numéro de la page à afficher en cas d'échec de la recherche ou de la sélection de l'explorateur de documents. La valeur par défaut est le numéro de la page active.
GetImage Obtient une icône particulière pour l'interface utilisateur de la visionneuse HTML.
Icône Obtient l'icône d'une extension de rendu particulière.
Feuille de style Spécifie une feuille de style à appliquer à la visionneuse HTML.
Paramètres d’informations sur l’appareil Spécifie un paramètre d’informations sur l’appareil sous forme de rc:tag=value, où balise est le nom d’un ensemble de paramètres d’informations sur l’appareil spécifique à l’extension de rendu actuellement utilisée (consultez la description du paramètre Format). Par exemple, vous pouvez utiliser le paramètre d’informations de périphérique OutputFormat pour que l’extension de rendu IMAGE restitue le rapport sous la forme d’une image JPEG à l’aide des paramètres suivants dans la chaîne d’accès URL : ...&rs:Format=IMAGE&rc:OutputFormat=JPEG. Pour plus d’informations sur tous les paramètres d’informations d’appareil spécifiques à l’extension, consultez Paramètres d’informations sur l’appareil pour les extensions de rendu (Reporting Services).

Commandes du serveur de rapports (rs:)

Le tableau suivant décrit les paramètres d’accès d’URL qui sont précédés de rs : et sont utilisés pour cibler le serveur de rapports.

Paramètre Description
Interface Exécute une action sur un élément de catalogue, selon son type d'élément. La valeur par défaut est déterminée par le type de l'élément de catalogue référencé dans la chaîne d'accès URL. Les valeurs autorisées sont :

ListChildren et GetChildren affiche le contenu d’un dossier. Les éléments du dossier sont affichés dans une page générique de navigation des éléments.

Native exemple de mode :

http://myrshost/reportserver?/Sales&rs:Command=GetChildren

SharePoint exemple de mode :

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren
Render Affiche le rapport spécifié.

Native exemple de mode :

http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

SharePoint exemple de mode :

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
GetSharedDatasetDefinition Affiche la définition XML associée à un jeu de données partagé. Les propriétés de dataset partagé, notamment la requête, les paramètres de dataset, les valeurs par défaut, les filtres de dataset et les options de données telles que le classement et le respect de la casse, sont enregistrées dans la définition. Vous devez disposer de l'autorisation Lire la définition de rapport sur un dataset partagé pour utiliser cette valeur.

Native exemple de mode :

https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
GetDataSourceContents Affiche les propriétés d’une source de données partagée donnée au format XML. Si votre navigateur prend en charge XML et que vous êtes un utilisateur authentifié avec l'autorisation Read Contents sur la source des données, la définition de la source de données est affichée.

Native exemple de mode :

http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents

SharePoint exemple de mode :

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents
GetResourceContents Affiche une ressource et l’affiche dans une page HTML si la ressource est compatible avec le navigateur. Sinon, vous êtes invité à ouvrir ou enregistrer le fichier ou la ressource sur le disque.

Native exemple de mode :

http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

SharePoint exemple de mode :

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
GetComponentDefinition Affiche la définition XML associée à un élément de rapport publié. Vous devez disposer Read Contents d’une autorisation sur un élément de rapport publié pour utiliser cette valeur.
Format Spécifie le format de rendu de rapport. Les valeurs courantes incluent ATOM, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF et XML. La valeur par défaut est HTML4.0. Pour plus d’informations, consultez Export a Report Using URL Access.

Par exemple, pour obtenir une copie PDF d'un rapport directement à partir d'un serveur de rapports en mode Native.

http://myrshost/ReportServer?/myreport&rs:Format=PDF

Par exemple, en mode SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage Fournit une langue indépendante de la langue du navigateur pour les paramètres passés dans une URL. La valeur par défaut est la langue du navigateur. La valeur peut être une valeur de culture, telle que en-us ou de-de..

Par exemple, en mode Native pour remplacer la langue du navigateur et spécifier la valeur de culture fr-FR.

http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
Instantané Génère un rapport basé sur un instantané d'historique de rapport. Pour plus d’informations, consultez Rendre un instantané d’historique de rapport à l’aide de l’accès URL.

Par exemple, en mode Native, récupérez un instantané d'historique de rapport en date du 04/07/2003 avec un horodateur de 13:40:02.

http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams Effectue le rendu d'un flux de données persistant distinct. Ce paramètre est repris par le convertisseur d'image pour transmettre le rapport segment par segment. Après avoir utilisé ce paramètre dans une chaîne d'accès à l'URL, utilisez cette même chaîne avec le paramètre GetNextStream au lieu du paramètre PersistStreams pour obtenir le segment suivant dans le flux de données persistant. Cette URL permet d'obtenir un flux de 0 octets. Il désigne la fin du flux persistent. La valeur par défaut est false.
GetNextStream Permet d’obtenir le bloc de données suivant dans un flux persistant auquel vous accédez à l’aide du paramètre PersistStreams . Pour plus d'informations, consultez la description de PersistStreams. La valeur par défaut est false.
Id de session Spécifie une session de rapport active établie entre l'application cliente et le serveur de rapports. La valeur de ce paramètre est l'identificateur de session.

Vous pouvez spécifier l'ID de session en tant que cookie ou dans le cadre de l'URL. Lorsque le serveur de rapports a été configuré de manière à ne pas utiliser de cookies de session, la première demande sans un ID de session spécifié provoque une redirection avec un ID de session. Pour plus d'informations sur les sessions de serveur de rapports, consultez Identifying Execution State.
ClearSession Une valeur de true indique au serveur de rapports de supprimer un rapport d'une session de rapport. Toutes les instances de rapport associées à un utilisateur authentifié sont supprimées de la session de rapport. (Une instance de rapport est définie comme le même rapport exécuté plusieurs fois avec différentes valeurs de paramètre de rapport.) La valeur par défaut est false.
ResetSession Une valeur de true dirige le serveur de rapports de manière à réinitialiser la session de rapport en supprimant l'association entre la session de rapport et tous les instantanés de rapport. La valeur par défaut est false.
ShowHideToggle Bascule de l'état afficher à masquer d'une section du rapport. Spécifiez un entier positif pour représenter la section à basculer.

Commandes de composant WebPart Visionneuse de rapports (rv:)

Le tableau suivant décrit les noms des paramètres de rapport réservés SQL Server utilisés pour cibler le composant WebPart Visionneuse de rapports intégré à SharePoint. Ces noms de paramètre sont préfixés par rv: . Le composant WebPart Visionneuse de rapports prend également en charge le paramètre rs:ParameterLanguage .

Paramètre Action
Barre d’outils Contrôle l'affichage de la barre d'outils pour le composant WebPart Visionneuse de rapports. La valeur par défaut est Full. Les valeurs peuvent être les suivantes :

Full : affiche la barre d'outils complète.

Navigation : affiche uniquement la pagination dans la barre d'outils.

None : n'affiche pas la barre d'outils.



Par exemple, en mode SharePoint, pour afficher uniquement la pagination dans la barre d'outils.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
HeaderArea Contrôle l'affichage de l'en-tête pour le composant WebPart Visionneuse de rapports. La valeur par défaut est Full. Les valeurs peuvent être les suivantes :

Full : affiche l'en-tête complet.

BreadCrumbsOnly : affiche uniquement l'exploration à l'aide de la barre de navigation dans l'en-tête pour indiquer à l'utilisateur où il se trouve dans l'application.

None : n'affiche pas l'en-tête.



Par exemple, en mode SharePoint, pour afficher uniquement l'exploration à l'aide de la barre de navigation dans l'en-tête.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
DocMapAreaWidth Contrôle la largeur d'affichage, en pixels, de la zone de paramètres dans le composant WebPart Visionneuse de rapports. La valeur par défaut est identique à la valeur par défaut du composant WebPart Visionneuse de rapports. La valeur doit être un entier non négatif.
AsyncRender Contrôle si un rapport est généré de façon asynchrone. La valeur par défaut est true ; cette valeur indique un rendu de rapport asynchrone. La valeur doit être une valeur booléenne true ou false.
ParamMode Contrôle la manière dont est affichée la zone de message de paramètre du composant WebPart Visionneuse de rapports en mode pleine page. La valeur par défaut est Full. Les valeurs valides sont :

Full : afficher la zone de message du paramètre.

Collapsed : réduire la zone de message du paramètre.

Hidden : masquer la zone de message du paramètre.

Par exemple, en mode SharePoint, pour réduire la zone de message du paramètre.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
DocMapMode Contrôle la manière dont est affichée la zone de l’explorateur de documents du composant WebPart Visionneuse de rapports en mode pleine page. La valeur par défaut est Full. Les valeurs valides sont :

Full : afficher la zone d'explorateur de documents.

Collapsed : réduire la zone d'explorateur de documents.

Hidden : masquer la zone d'explorateur de documents.
DockToolBar Détermine si la barre d’outils du composant WebPart Visionneuse de rapports est ancrée en haut ou en bas. Les valeurs valides sont Top et Bottom. La valeur par défaut est Top.



Par exemple, en mode SharePoint, pour ancrer la barre d'outils dans la partie inférieure.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom
ToolBarItemsDisplayMode Contrôle quels éléments de la barre d'outils sont affichés. Il s'agit d'une valeur d'énumération de bits. Pour inclure un élément de la barre d’outils, ajoutez la valeur de l’élément à la valeur totale. Par exemple : pour aucun menu Actions, utilisez rv : ToolBarItemsDisplayMode=63 (ou 0x3F), qui est 1+2+4+8+16+32 ; pour les éléments du menu Actions uniquement, utilisez rv : ToolBarItemsDisplayMode=960 (ou 0x3C0). La valeur par défaut, qui inclut tous les éléments de la barre d'outils, est -1. Les valeurs autorisées sont :

1 (0x1) : le bouton Retour

2 (0x2) : les contrôles de recherche de texte

4 (0x4) : les contrôles de navigation entre les pages

8 (0x8) : le bouton Actualiser

16 (0x10) : la zone de liste Zoom

32 (0x20) : le bouton Flux Atom

64 (0x40) : l’option du menu Imprimer dans Actions

128 (0x80) : le sous-menu Exporter dans Actions

256 (0x100) : l’option du menu Ouvrir avec le Générateur de rapports dans Actions

512 (0x200) : l’option du menu S’abonner dans Actions

1024 (0x400) : l’option du menu Nouvelle alerte de données dans Actions

Par exemple, en SharePoint mode pour afficher uniquement le bouton Précédent , les contrôles de recherche de texte, les contrôles de navigation de page et le bouton Actualiser .

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

Voir aussi

Accès URL (SSRS)