Passare un parametro del report in un URL

  • Articolo

È possibile passare parametri del report a un server di report SQL Server Reporting Services includendoli in un URL del report. Tutti i parametri di query possono disporre di parametri di report corrispondenti. Passare un parametro di query a un report passando il parametro di report corrispondente. Per altre informazioni, vedere Compilare una query in Progettazione query relazionale (Generatore di report e SSRS).

Sintassi dei parametri di base

  • Nei parametri dei report viene fatta distinzione tra maiuscole e minuscole.
  • Per caratteri speciali:
    • Sostituire tutti gli spazi nella stringa URL con i caratteri %20.
    • Sostituire gli spazi nella parte di parametro dell'URL con un carattere +.
    • Sostituito un punto e virgola in una parte qualsiasi della stringa con i caratteri %3A.
  • I browser gestiscono in genere automaticamente la codifica URL, quindi non è necessario codificare manualmente i caratteri.
  • È importante che nell'URL sia inclusa la sintassi proxy _vti_bin per indirizzare la richiesta tramite SharePoint e il proxy HTTP di Reporting Services . Tramite il proxy viene aggiunto del contesto alla richiesta HTTP. Questo contesto è necessario per garantire l'esecuzione corretta del report per i server di report in modalità SharePoint. Se non si include la sintassi del proxy, è necessario anteporre al parametro il prefisso rp:.

Esempi

Nota

L'integrazione di SSRS con SharePoint non è più disponibile nelle versioni successive a SQL Server 2016.

  • Impostare un parametro del report in un URL.
    • Sintassi: parameter=value
  • Specificare due parametri definiti in un report.
    • Esempio per un server in modalità SharePoint SSRS: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl&ReportMonth=3&ReportYear=2008
    • Esempio per un server in modalità nativa SSRS: https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ReportMonth=3&ReportYear=2008
  • Passare un valore Null per un parametro.
    • Sintassi: parameter:isnull=true
    • Esempio: SalesOrderNumber:isnull=true
  • Passare un valore booleano. I valori possibili sono 0 per false e 1 per true.
    • Esempio: https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ShowDetails=1
  • Passare un valore float. Includere il separatore decimale corrispondente alle impostazioni locali del server.

Contenuto correlato