Référence sur les paramètres d’accès URL

Vous pouvez utiliser les paramètres suivants dans une URL pour configurer l’apparence de vos rapports SQL Server 2016 (13.x) Reporting Services (SSRS) ou version ultérieure. 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 aux périphériques, consultez Spécifier les paramètres d’informations de périphérique dans une URL.

Commandes de visionneuse HTML (rc:)

• Les commandes de visionneuse HTML sont utilisées pour cibler la visionneuse HTML et sont précédées de rc: :

• Barre d’outils : Affiche ou masque la barre d'outils. 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.

  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.

• Paramètres : Affiche ou masque la zone de paramètres de la barre d'outils. 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 peut la faire apparaître. La valeur par défaut de ce paramètre est true.

  Par exemple, en mode natif :

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

  Par exemple, en mode SharePoint :

  https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed  
  

• Zoom : Définit la valeur du zoom du rapport comme un pourcentage entier ou une constante de chaîne. Les valeurs de chaîne standard incluent les valeurs Page Width et Whole Page. Les versions d’Internet Explorer plus anciennes que la version 5.0 et tous les navigateurs autres que Microsoft ignorent ce paramètre. La valeur par défaut de ce paramètre est 100.

  Par exemple, en mode natif :

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

  Par exemple, en mode SharePoint :

  https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page Width  
  

• Section : 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 de ce paramètre est 1.

  Par exemple, en mode natif, pour afficher la page 2 du rapport :

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

  Par exemple, en mode SharePoint, pour afficher la page 2 du rapport :

  https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2  
  

• FindString : Recherche du texte dans un rapport et le met en surbrillance.

  Important

  rc:FindString ne fonctionnera pas si vous n’incluez pas rc:Toolbar=false dans la chaîne d’accès URL.

  Par exemple, en mode natif :

  https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400  
  

  Par exemple, en mode SharePoint :

  https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400  
  

• StartFind : Spécifie la dernière section à explorer. La valeur par défaut de ce paramètre est la dernière page du rapport.

  Pour obtenir un exemple en mode natif qui recherche la première occurrence du texte « Mountain-400 » entre les pages 1 et 5 de l’exemple de rapport intitulé Product Catalog :

  https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400  
  

• 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. La valeur par défaut est le numéro de la page active. Utilisez ce paramètre avec le paramètre StartFind. Voir l’exemple précédent.

• 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.

• Icon : 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ù tag 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 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:)

Les commandes de serveur de rapports sont précédées de rs: et sont utilisées pour cibler le serveur de rapports :

• Commande : 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 : Affichent le contenu d’un dossier. Les éléments du dossier sont affichés dans une page générique de navigation des éléments.

    Par exemple, en mode natif :

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

    Par exemple, une instance nommée en mode natif :

    https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildren  
    

    Par exemple, en mode SharePoint :

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren  
    

  • Render : Le rapport est restitué dans le navigateur pour vous permettre de l’afficher.

    Par exemple, en mode natif :

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

    Par exemple, en mode SharePoint :

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render  
    

  • GetSharedDatasetDefinition : Affiche la définition XML associée à un dataset 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.

    Par exemple, en mode natif :

    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 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 est affichée.

    Par exemple, en mode natif :

    https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents  
    

    Par exemple, en mode SharePoint :

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents  
    

  • GetResourceContents : Restitue 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.

    Par exemple, en mode natif :

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

    Par exemple, en mode SharePoint :

    https://myspsite/subsite/_vti_bin/reportserver?https://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 d'autorisations Lire le contenu d'un élément de rapport publié pour utiliser cette valeur.

• Format : Spécifie le format de rendu et d’affichage d’un rapport. Exemples de valeurs courantes :

  • HTML5

  • PPTX

  • ATOM

  • HTML4.0

  • MHTML

  • IMAGE

  • EXCEL (pour .xls)

  • EXCELOPENXML (pour .xlsx)

  • WORD (pour .doc)

  • WORDOPENXML (pour .docx)

  • CSV

  • PDF

  • XML

  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 sur l’emplacement du fichier, consultez Fichier de configuration RsReportServer.config.

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

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

  Par exemple, pour obtenir directement une copie PDF d’un rapport à partir d’un serveur de rapports en mode SharePoint :

  https://myspsite/subsite/_vti_bin/reportserver?https://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 natif, pour remplacer la langue du navigateur et spécifier la valeur de culture fr-FR :

  https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE  
  

• Capture instantanée : 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 natif, récupérez un instantané d’historique de rapport en date du 04/07/2003 avec un horodatage de 13:40:02 :

  https://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 commande d’URL retourne un flux de 0 octet pour indiquer la fin du flux persistant. 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.

• 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 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 Identifier l’état d’exécution.

• ClearSession: La valeur 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. (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.

• 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:)

Les noms de paramètres de rapport réservés SQL Server suivants sont 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.

• 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 :

  • Complet: Affiche la barre d’outils complète.

  • Navigation : Affiche uniquement la pagination dans la barre d’outils.

  • Aucun : N’affiche pas la barre d’outils.

  Par exemple, en mode SharePoint, pour afficher uniquement la pagination dans la barre d’outils :

  https://myspsite/_vti_bin/reportserver?https://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 :

  • Complet: 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.

  • Aucun : 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 :

  https://myspsite/_vti_bin/reportserver?https://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 autorisées sont :

  • Complet: Affiche la zone de message du paramètre.

  • Réduit : Réduit la zone de message du paramètre.

  • Masqué : Masque la zone de message du paramètre.

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

  https://myspsite/_vti_bin/reportserver?https://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 autorisées sont :

  • Complet: Affiche la zone d’explorateur de documents.

  • Réduit : Réduit la zone d’explorateur de documents.

  • Masqué : Masque 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 possibles 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 :

  https://myspsite/_vti_bin/reportserver?https://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), ce qui correspond à 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) : Bouton Retour

  • 2 (0x2) : Contrôles de recherche de texte

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

  • 8 (0x8) : Bouton Actualiser

  • 16 (0x10) : Zone de liste Zoom

  • 32 (0x20) : Bouton Flux Atom

  • 64 (0x40) : Option de menu Imprimer dans Actions

  • 128 (0x80) : Sous-menu Exporter dans Actions

  • 256 (0x100) : Option de menu Ouvrir avec le Générateur de rapports dans Actions

  • 512 (0x200) : Option de menu S’abonner dans Actions

  • 1024 (0x400) : Option du menu Nouvelle alerte de données dans Actions

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

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

Contenu connexe

• Accès URL (SSRS)
• Exporter un rapport à l’aide de l’accès URL