Passer un paramètre de rapport dans une URLPass a Report Parameter Within a URL

Vous pouvez passer des paramètres de rapport à un rapport en les incluant dans une URL de rapport.You can pass report parameters to a report by including them in a report URL. Ces paramètres URL ne sont pas préfixés parce qu'ils sont directement passés au moteur de traitement des rapports.These URL parameters are not prefixed because they are passed directly to the report processing engine.

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 ServicesReporting Services .It is important the URL include the _vti_bin proxy syntax to route the request through SharePoint and the Reporting ServicesReporting Services HTTP proxy. 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.The proxy adds some context to the HTTP request, context that is required to ensure proper execution of the report for SharePoint mode report servers.

Si vous n’incluez pas la syntaxe de proxy, vous devez faire précéder le paramètre de rp:.If you don’t include the proxy syntax, then you need to prefix the parameter with rp:.

Tous les paramètres de requête peuvent avoir des paramètres de rapport correspondants.All query parameters can have corresponding report parameters. Vous passez un paramètre de requête à un rapport en transmettant le paramètre de rapport correspondant.You pass a query parameter to a report by passing the corresponding report parameter. 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).For more information, see Build a Query in the Relational Query Designer (Report Builder and SSRS).

Important

Les paramètres de rapport respectent la casse.Report parameters are case-sensitive.

Note

Les paramètres de rapport respectent la casse et utilisent les caractères spéciaux suivants :Report parameters are case-sensitive and utilize the following special characters:

  • Tout espace figurant dans la chaîne d'URL est remplacé par le caractère « % 20 », conformément aux normes d'encodage des URL.Any space characters in the URL string are replaced with the characters "%20," according to URL encoding standards.
    • Un espace dans la partie Paramètre de l'URL est remplacé par un caractère Plus (+).A space character in the parameter portion of the URL is replaced with a plus character (+).
    • Un point-virgule dans toute partie de la chaîne est remplacé par les caractères « %3A ».A semicolon in any portion of the string is replaced with the characters "%3A."
    • Les navigateurs doivent effectuer automatiquement l'encodage d'URL approprié.Browsers should automatically perform the proper URL encoding. Vous n'avez pas besoin d'encoder manuellement les caractères.You do not have to encode any of the characters manually.

Pour définir un paramètre de rapport au sein d'une URL, utilisez la syntaxe suivante :To set a report parameter within a URL, use the following syntax:


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 :For example, to specify two parameters, “ReportMonth” and “ReportYear”, defined in a report, use the following URL for a native mode report server:

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é :For example, to specify the same two parameters defined in a report, use the following URL for a SharePoint integrated mode report server. Notez le /_vti_bin:Note the /_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 :To pass a null value for a parameter, use the following syntax:


parameter  
:isnull=true  

Par exemple :For example,

SalesOrderNumber:isnull=true  

Pour passer une valeur booléenne , utilisez 0 pour false et 1 pour true.To pass a Boolean value, use 0 for false and 1 for true. Pour passer une valeur flottante , incluez le séparateur décimal des paramètres régionaux du serveurTo pass a Float value, include the decimal separator of the server locale

Note

Si votre rapport contient un paramètre de rapport qui a une valeur par défaut et que la valeur de la propriété Demander est false (autrement dit, si 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.If your report contains a report parameter that has a default value and the value of the Prompt property is false (that is, the Prompt User property is not selected in Report Manager), then you cannot pass a value for that report parameter within a URL. Cela permet aux administrateurs d'empêcher les utilisateurs finaux d'ajouter ou de modifier les valeurs de certains paramètres de rapport.This provides administrators an option for preventing end users from adding or modifying the values of certain report parameters.

Autres exemplesAdditional Examples

L'exemple d'URL suivante comprend des espaces et plusieurs paramètresThe following URL example includes spaces and multiple parameters

  • Le nom de dossier « SQL Server User Education Team » comprend des espaces ; par conséquent, un « + » remplace chaque espace.Folder name of “SQL Server User Education Team” includes spaces and therefore the “+” replaces each space.

  • Le nom de rapport « team project report » comprend des espaces ; par conséquent, un « + » remplace chaque espace.Report name of “team project report” includes spaces and therefore the “+” replaces each space.

  • Passe deux paramètres de « teamgrouping2 » avec la valeur « xgroup » et « teamgrouping1 » avec la valeur « ygroup ».Passes two parameters of “teamgrouping2” with a value of “xgroup” and “teamgrouping1” with a value of “ygroup”.

https://myserver/Reportserver?/SQL+Server+User+Education+Team/_ContentTeams/folder123/team+project+report&teamgrouping2=xgroup&teamgrouping1=ygroup  

L'exemple d'URL suivante comprend un paramètre à valeurs multiples nommé OrderID.The following URL example includes a multi-value parameter ”OrderID. Le format d'un paramètre à valeurs multiples consiste à répéter le nom du paramètre pour chaque valeur.The format for a Multi-Value parameter is to repeat the parameter name for each value.

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 une valeur « 7/1/2005 » pour un serveur de rapports en mode natif.The following URL example passes a single parameter of SellStartDate with a value of “7/1/2005”, for a native mode report server.

http://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005  

Voir aussiSee Also

Accès URL (SSRS) URL Access (SSRS)
Référence de paramètres d'accès URLURL Access Parameter Reference