Partager via

Passer un paramètre de rapport dans une URL

Vous pouvez transmettre des paramètres de rapport à un rapport en les incluant dans une URL de rapport. Ces paramètres d’URL ne sont pas préfixés, car ils sont transmis directement au moteur de traitement du rapport.

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 du proxy, vous devez préfixer le paramètre avec 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 Générer 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.

Remarque

Les paramètres de rapport respectent la casse et utilisent les caractères spéciaux suivants :

  • Tous les espaces de la chaîne d’URL sont remplacés par les caractères «%20», conformément aux normes d’encodage d’URL.
  • Un espace dans la partie paramètre de l’URL est remplacé par un caractère plus (+).
  • Un point-virgule dans n’importe quelle 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 dans 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 mêmes paramètres définis dans un rapport, utilisez l’URL suivante pour un serveur de rapports en mode intégré SharePoint. 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 Boolean valeur, utilisez 0 pour false et 1 pour true. Pour passer une Float valeur, incluez le séparateur décimal du paramètre régional du serveur

Remarque

Si votre rapport contient un paramètre de rapport qui a une valeur par défaut et la valeur de la Prompt propriété est false (autrement dit, la propriété Utilisateur d’invite n’est pas sélectionnée dans le Gestionnaire de rapports), vous ne pouvez pas passer une 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.

Exemples supplémentaires

L’exemple d’URL suivant inclut des espaces et plusieurs paramètres

  • Le nom du dossier « Sql Server User Education Team » comprend des espaces et, par conséquent, « + » remplace chaque espace.

  • Le nom du rapport « rapport de projet d’équipe » inclut des espaces, et par conséquent, « + » remplace chaque espace.

  • Transmet deux paramètres de « 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 inclut un paramètre à valeurs multiples « 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 de 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

Voir aussi

Accès URL (SSRS)
Informations de référence sur les paramètres d’accès à l’URL

  • Last updated on