Passer un paramètre de rapport dans une URL

Vous pouvez transmettre des paramètres de rapport à un serveur de rapports SQL Server Reporting Services (SSRS) en les incluant dans une URL de rapport. 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).

Syntaxe de paramètre de base

  • Les paramètres de rapport respectent la casse.
  • Pour les caractères spéciaux :
    • Remplacez les espaces dans la chaîne d’URL par les caractères %20.
    • Remplacer tous les caractères d'espacement dans la partie paramètre de l'URL par le caractère plus +.
    • Remplacer un point-virgule dans n'importe quelle partie de la chaîne par les caractères %3A.
  • Les navigateurs gèrent généralement automatiquement l’encodage d’URL. Vous n’avez donc pas besoin d’encoder manuellement des caractères.
  • 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:.

Exemples

Remarque

L’intégration de SSRS n’est plus disponible après SQL Server 2016.

  • Définit un paramètre de rapport dans une URL
    • Syntaxe : parameter=value
  • Spécifiez deux paramètres définis dans un rapport.
    • Exemple pour un serveur en mode SharePoint SSRS : https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl&ReportMonth=3&ReportYear=2008
    • Exemple pour un serveur en mode natif SSRS : https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ReportMonth=3&ReportYear=2008
  • Transmettez une valeur Null pour un paramètre.
    • Syntaxe : parameter:isnull=true
    • Exemple : SalesOrderNumber:isnull=true
  • Transmettre une valeur booléenne. Les valeurs possibles sont 0 pour false et 1 pour true.
    • Exemple : https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ShowDetails=1
  • Transmettez une valeur float. Inclure le séparateur décimal de la locale du serveur.