Référence sur les paramètres d’accès URL
Vous pouvez utiliser les paramètres dans une URL pour configurer l’apparence de vos rapports SQL Server 2016 (13.x) Reporting Services (SSRS) ou version ultérieure. Cet article décrit les paramètres les plus couramment utilisés.
Les paramètres ne respectent pas la casse. Ils nécessitent un préfixe :
rs:: cible le serveur de rapports.rc:: cible une visionneuse HTML.rv:: cible le composant WebPart de la Visionneuse de rapports.
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 aux périphériques, consultez Spécifier les paramètres d’informations de périphérique dans une URL.
Important
Dans le cas d’un serveur de rapports en mode SharePoint, il est important que l’URL inclue la syntaxe de proxy _vti_bin pour router la demande via SharePoint et le proxy HTTP Reporting Services. Le proxy ajoute à la requête HTTP le contexte nécessaire afin de garantir une exécution correcte du rapport pour les serveurs de rapports en mode SharePoint. Pour obtenir des exemples, consultez Accéder à des éléments de serveur de rapports à l’aide de l’accès URL.
L’intégration de Reporting Services à SharePoint n’est plus disponible après SQL Server 2016.
Commandes de visionneuse HTML (rc:)
Cible la visionneuse HTML à l’aide du préfixe rc:.
| Commande | Paramètre | Description |
|---|---|---|
Toolbar |
True |
Affiche la barre d'outils. La valeur par défaut est true. Remarque :: si vous omettez ce paramètre, la barre d'outils s'affiche automatiquement pour les formats de rendu assurant sa prise en charge. |
Toolbar |
False |
Masquer la boîte à outils. Si ce paramètre est false, toutes les options restantes sont ignorées. |
Toolbar |
Navigation |
Affiche uniquement la pagination dans la barre d’outils. |
Parameters |
True |
Affiche la zone des paramètres de la barre d'outils. La valeur par défaut est true. Exemples : Mode natif : https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedMode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Parameters |
False |
Masque la zone des paramètres et l’utilisateur ne peut pas l’afficher. |
Parameters |
Collapsed |
Masque la zone des paramètres, mais l’utilisateur peut basculer pour l’afficher. Exemples : Mode natif : https://myrshost/reportserver?/Sales&rc:Parameters=CollapsedMode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed |
Zoom |
Page Width |
Définissez le zoom du rapport pour qu’il corresponde à la largeur de la page. Exemples : Mode natif : https://myrshost/reportserver?/Sales&rc:Zoom=Page%20WidthMode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width |
Zoom |
Whole Page |
Définissez le zoom du rapport pour qu’il corresponde à l’ensemble de la page. |
Zoom |
<integer percentage> |
Définissez le zoom du rapport sur un pourcentage spécifique. La valeur par défaut est 100. |
Section |
<page number> |
Définit la page du rapport à afficher. 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 est 1. Exemples : Mode natif : https://myrshost/reportserver?/Sales&rc:Section=2Mode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2 |
FindString |
<text> |
Rechercher dans un rapport un ensemble spécifique de textes et les mettre en évidence. Remarque : rc:FindString ne fonctionne pas, sauf si vous incluez rc:Toolbar=false dans la chaîne d’accès URL.Exemples : Mode natif : https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400Mode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400 |
StartFind |
<start page> |
Spécifiez la première section à rechercher. La valeur par défaut est la première page du rapport. Exemple : Mode natif : https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
EndFind |
<end page> |
Définit le numéro de la dernière page que vous souhaitez utiliser dans la recherche. La valeur par défaut est le numéro de la page active. Utilisez ce paramètre avec le paramètre StartFind.Exemple : consultez l’exemple StartFind. |
FallbackPage |
<page number> |
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 |
<icon name> |
Obtient une image particulière pour l'interface utilisateur de la visionneuse HTML. |
Icon |
<icon name> |
Obtient l'icône d'une extension de rendu particulière. |
Stylesheet |
<stylesheet file name> |
Spécifiez une feuille de style que vous souhaitez 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ù tag est le nom d’un ensemble de paramètres d’informations sur l’appareil spécifique à l’extension de rendu. Pour plus d'informations, voir la description de la commande Format.Vous pouvez utiliser le paramètre d’informations d’appareil 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 sur les appareils propres aux extensions, consultez Paramètres d’informations sur les appareils pour les extensions de rendu (Reporting Services). |
Commandes du serveur de rapports (rs:)
Cible le serveur de rapports à l’aide du préfixe rs:.
| Commande | Paramètre | Description |
|---|---|---|
Command |
ListChildren et GetChildren |
Affiche le contenu d’un dossier. Les éléments du dossier s’affichent dans une page générique de navigation des éléments. Exemples : Mode natif : https://myrshost/reportserver?/Sales&rs:Command=GetChildrenUne instance nommée en mode natif : https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildrenMode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren |
Command |
Render |
Le rapport est restitué dans le navigateur pour vous permettre de l’afficher. Exemples : Mode natif : https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderMode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
Command |
GetSharedDatasetDefinition |
Affiche la définition XML associée à un dataset partagé. Les propriétés du jeu de données partagé sont enregistrées dans la définition. Ces propriétés incluent 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. Vous devez disposer de l'autorisation Lire la définition de rapport sur un dataset partagé pour utiliser cette valeur. Exemple : Mode natif : https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
Command |
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 si 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 s’affiche. Exemples : Mode natif : https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContentsMode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents |
Command |
GetResourceContents |
Restitue une ressource et l’affiche dans une page HTML si la ressource est compatible avec le navigateur. Sinon, vous pouvez choisir d’ouvrir ou enregistrer le fichier ou la ressource sur le disque. Exemples : Mode natif : https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsMode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
Command |
GetComponentDefinition |
Affiche la définition XML associée à un élément de rapport publié. Vous devez disposer d'autorisations Lire le contenu d'un élément de rapport publié pour utiliser cette valeur. |
Format |
HTML5PPTXATOMHTML4.0MHTMLIMAGEEXCEL (pour .xls)EXCELOPENXML (pour .xlsx)WORD (pour .doc)WORDOPENXML (pour .docx)CSVPDFXML |
Spécifie le format de rendu et d’affichage d’un rapport. La valeur par défaut est HTML5. Pour plus d’informations, consultez Exporter un rapport à l’aide de l’accès URL. Pour obtenir la liste complète, consultez la section relative à l’extension \<Render> du fichier rsreportserver.config du serveur de rapports. Pour plus d’informations, consultez Fichier de configuration RsReportServer. Exemples : Mode natif : https://myrshost/ReportServer?/myreport&rs:Format=PDF Mode SharePoint : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF |
ParameterLanguage |
en-us, de-DE, etc. |
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. Exemple : Mode natif : https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE |
Snapshot |
Génère un rapport basé sur une capture instantanée d'historique de rapport. Pour plus d’informations, consultez Rendre un instantané d’historique de rapport à l’aide de l’accès URL. Exemple : Mode natif : https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02 |
|
PersistStreams |
truefalse |
Rendre un rapport dans un seul flux persistant. Le moteur de rendu d'images utilise ce paramètre pour transmettre le rapport rendu un morceau à la fois. 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 commande d’URL retourne un flux de 0 octet pour indiquer la fin du flux persistant. La valeur par défaut est false. |
GetNextStream |
truefalse |
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, voir la description de la commande PersistStreams. La valeur par défaut est false (Faux). |
SessionID |
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 vous configurez le serveur de rapports 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 Identifier l’état d’exécution. |
|
ClearSession |
truefalse |
Supprimer de la session de rapport toutes les instances de rapport associées à un utilisateur authentifié. Par définition, une instance de rapport est un même rapport exécuté plusieurs fois avec des valeurs de paramètre de rapport différentes. La valeur par défaut est false (Faux). Les valeurs valides sont true et false. |
ResetSession |
truefalse |
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 (Faux). Les valeurs valides sont true et false. |
ShowHideToggle |
<positive integer> |
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:)
Cible le composant WebPart Visionneuse de rapports qui s’intègre à SharePoint à l’aide du préfixe rv:. Le composant WebPart Visionneuse de rapports prend également en charge le paramètre rs:ParameterLanguage.
| Commande | Paramètre | Description |
|---|---|---|
Toolbar |
Full |
Affiche la barre d’outils complète. La valeur par défaut est Full. |
Toolbar |
Navigation |
Affiche uniquement la pagination dans la barre d’outils. Exemple : Mode SharePoint : https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation |
Toolbar |
None |
N’affiche pas la barre d’outils. |
HeaderArea |
Full |
Affiche l’en-tête complet. La valeur par défaut est Full. |
HeaderArea |
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. Exemple : Mode SharePoint : https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly |
HeaderArea |
None |
Masque l’en-tête. |
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 |
truefalse |
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 |
Full |
Affiche la zone de message du paramètre. La valeur par défaut est Full. |
Collapsed |
Réduit la zone de message du paramètre. Exemple : Mode SharePoint : https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed |
|
ParamMode |
Hidden |
Masque la zone de message du paramètre. |
DocMapMode |
Full |
Affiche la zone d’explorateur de documents. La valeur par défaut est Full. |
DocMapMode |
Collapsed |
Réduit la zone d’explorateur de documents. |
DocMapMode |
Hidden |
Masque la zone d’explorateur de documents. |
DockToolBar |
Top |
Affiche la barre d'outils en haut de l'écran. La valeur par défaut est Top. |
DockToolBar |
Bottom |
Affiche la barre d'outils en bas de l'écran. Exemple : Mode SharePoint : https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom |
ToolBarItemsDisplayMode |
1 (0x1) |
Bouton Retour |
ToolBarItemsDisplayMode |
2 (0x2) |
Contrôles de recherche de texte |
ToolBarItemsDisplayMode |
4 (0x4) |
Commandes de navigation entre les pages |
ToolBarItemsDisplayMode |
8 (0x8) |
Bouton Actualiser |
ToolBarItemsDisplayMode |
16 (0x10) |
Zone de liste Zoom |
ToolBarItemsDisplayMode |
32 (0x20) |
Bouton Flux Atom |
ToolBarItemsDisplayMode |
64 (0x40) |
Option de menu Imprimer dans Actions |
ToolBarItemsDisplayMode |
128 (0x80) |
Sous-menu Exporter dans Actions |
ToolBarItemsDisplayMode |
256 (0x100) |
Option de menu Ouvrir avec le Générateur de rapports dans Actions |
ToolBarItemsDisplayMode |
512 (0x200) |
Option de menu S’abonner dans Actions |
ToolBarItemsDisplayMode |
1024 (0x400) |
Option du menu Nouvelle alerte de données dans Actions |
ToolBarItemsDisplayMode |
Valeurs multiples | Contrôle quels éléments de la barre d'outils sont à afficher. Cette valeur est 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), ce qui correspond à 1+2+4+8+16+32. Pour les éléments de 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 :Exemple : Mode SharePoint : https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |