Passer un paramètre de rapport dans une URL
Vous pouvez passer des paramètres de rapport à un rapport en les incluant dans une URL de rapport. Ces paramètres URL ne sont pas préfixés parce qu'ils sont directement passés au moteur de traitement des rapports.
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.
Si vous n’incluez pas la syntaxe de proxy, vous devez faire précéder le paramètre de rp: .
Tous les paramètres de requête peuvent avoir des paramètres de rapport correspondants. Vous passez un paramètre de requête à un rapport en transmettant le paramètre de rapport correspondant. Pour plus d’informations, consultez Créer une requête dans le Concepteur de requêtes relationnelles (Générateur de rapports et SSRS).
Important
Les paramètres de rapport respectent la casse.
Notes
Les paramètres de rapport respectent la casse et utilisent les caractères spéciaux suivants :
- Tout espace figurant dans la chaîne d'URL est remplacé par le caractère « % 20 », conformément aux normes d'encodage des URL.
- Un espace dans la partie Paramètre de l'URL est remplacé par un caractère Plus (+).
- Un point-virgule dans toute partie de la chaîne est remplacé par les caractères « %3A ».
- Les navigateurs doivent effectuer automatiquement l'encodage d'URL approprié. Vous n'avez pas besoin d'encoder manuellement les caractères.
Pour définir un paramètre de rapport au sein d'une URL, utilisez la syntaxe suivante :
parameter=value
Par exemple, pour spécifier deux paramètres, « ReportMonth » et « ReportYear », définis dans un rapport, utilisez l’URL suivante pour un serveur de rapports en mode natif :
http://myrshost/ReportServer?/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2&ReportMonth=3&ReportYear=2008
Par exemple, pour spécifier les deux paramètres définis dans un rapport, utilisez l'URL suivante pour un serveur de rapports SharePoint intégré : Notez le /_vti_bin:
http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.rdl&ReportMonth=3&ReportYear=2008
Pour passer une valeur NULL pour un paramètre, utilisez la syntaxe suivante :
parameter
:isnull=true
Par exemple,
SalesOrderNumber:isnull=true
Pour passer une valeur Boolean, utilisez 0 pour false et 1 pour true. Pour passer une valeur Float, incluez le séparateur décimal associé aux paramètres régionaux définis sur le serveur
Notes
Si votre rapport contient un paramètre de rapport qui possède une valeur par défaut et que la valeur de la propriété Prompt est false (autrement dit, la propriété Demander à l'utilisateur n'est pas sélectionnée dans le Gestionnaire de rapports), vous ne pouvez pas passer de valeur pour ce paramètre de rapport dans une URL. Cela permet aux administrateurs d'empêcher les utilisateurs finaux d'ajouter ou de modifier les valeurs de certains paramètres de rapport.
Autres exemples
L'exemple d'URL suivante comprend des espaces et plusieurs paramètres
Le nom de dossier « SQL Server User Education Team » comprend des espaces ; par conséquent, un « + » remplace chaque espace.
Le nom de rapport « team project report » comprend des espaces ; par conséquent, un « + » remplace chaque espace.
Passe deux paramètres : « teamgrouping2 » avec la valeur « xgroup » et « teamgrouping1 » avec la valeur « ygroup ».
https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup
L’exemple d’URL suivant comprend un paramètre à valeurs multiples nommé OrderID. Le format d'un paramètre à valeurs multiples consiste à répéter le nom du paramètre pour chaque valeur.
https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup&OrderID=747&OrderID=787&OrderID=12
L’exemple d’URL suivant passe un seul paramètre SellStartDate avec la valeur « 7/1/2005 » pour un serveur de rapports en mode natif.
http://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005