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 |