Référence de paramètre d'accès URL
Vous pouvez utiliser les paramètres suivants dans le cadre d'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 aux périphériques, 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 Accéder à des éléments de serveur de rapports à l'aide de l'accès URL.
Pour plus d'informations sur l'inclusion de paramètres de rapport dans une URL et pour obtenir des exemples, consultez Passer un paramètre de rapport dans une URL.
Commandes de visionneuse HTML (rc:)
Le tableau suivant décrit les paramètres d'accès URL préfixés par rc: et utilisés pour cibler la visionneuse HTML.
Paramètre |
Action |
---|---|
Toolbar |
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. |
Parameters |
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 final peut la faire apparaître. La valeur par défaut de ce paramètre est true. Pour obtenir un exemple en mode Native.
Pour obtenir un exemple en mode SharePoint.
|
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. Ce paramètre est ignoré par les versions d'Internet Explorer antérieures à la version 5.0 et par tous les navigateurs non- Microsoft. La valeur par défaut de ce paramètre est 100. Par exemple, en mode Native.
Par exemple, en mode SharePoint.
|
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 Native, pour afficher la page 2 du rapport.
Par exemple, en mode SharePoint, pour afficher la page 2 du rapport.
|
FindString |
Rechercher dans un rapport un texte spécifique. Pour obtenir un exemple en mode Native.
Pour obtenir un exemple en mode SharePoint.
|
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 Native, qui recherche la première occurrence du texte « Mountain-400 » entre les pages un et cinq de l'exemple de rapport intitulé Product Catalog.
|
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 conjointement avec le paramètre StartFind. Consultez l'exemple ci-dessus. |
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. |
Stylesheet |
Spécifie une feuille de style à appliquer à la visionneuse HTML. |
Paramètres d'informations de périphérique |
Spécifie un paramètre d'informations de périphérique sous forme de rc:tag=value, où tag est le nom d'un ensemble de paramètres d'informations de périphérique à l'extension de rendu actuellement utilisée (consultez la description du paramètre de 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 de périphérique d'extension, consultez Paramètres d'informations de périphérique pour les extensions de rendu (Reporting Services). |
Commandes du serveur de rapports (rs:)
Le tableau suivant décrit les paramètres d'accès URL préfixés par rs: et utilisés pour cibler le serveur de rapports.
Paramètre |
Action |
---|---|
Command |
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 valides sont les suivantes :
|
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 Exporter un rapport à l'aide de l'accès URL. Par exemple, pour obtenir une copie PDF d'un rapport directement à partir d'un serveur de rapports en mode Native.
Par exemple, en mode SharePoint.
|
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.
|
Snapshot |
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.
|
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 flux de données suivant dans un flux persistant auquel vous accédez via le 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 Identification de l'état d'exécution. |
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. (Par définition, une instance de rapport est un rapport identique 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
La table suivante décrit les noms des paramètre de rapport réservés SQL Server utilisés pour cibler le composant WebPart Visionneuse de rapports qui est 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 |
---|---|
Toolbar |
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 :
Par exemple, en mode SharePoint, pour afficher uniquement la pagination dans la barre d'outils.
|
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 :
Par exemple, en mode SharePoint, pour afficher uniquement l'exploration à l'aide de la barre de navigation dans 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 |
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 la zone de message du paramètre du composant WebPart Visionneuse de rapports est affichée en mode page entière. Les valeurs valides sont les suivantes :
La valeur par défaut est Full. Par exemple, en mode SharePoint, pour réduire la zone de message du paramètre.
|
DocMapMode |
Contrôle la manière dont la zone de l'explorateur de documents du composant WebPart Visionneuse de rapports est affichée en mode page entière. Les valeurs valides sont les suivantes :
La valeur par défaut est Full. |
DockToolBar |
Contrôle 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.
|
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). Les valeurs valides sont les suivantes :
La valeur par défaut, qui inclut tous les éléments de la barre d'outils, est -1. 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.
|