Passare un parametro del report in un URL

  • Articolo

È possibile passare parametri del report a un report includendoli in un URL del report. Questi parametri URL non hanno il prefisso in quanto vengono passati direttamente al motore di elaborazione dei report.

Nota

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

Importante

È 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:.

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).

Importante

Nei parametri dei report viene fatta distinzione tra maiuscole e minuscole.

Nota

Ai parametri del report viene applicata la distinzione tra maiuscole e minuscole e in essi vengono utilizzati i caratteri speciali seguenti:

  • Qualsiasi spazio nella stringa dell'URL viene sostituito con i caratteri "% 20", in base agli standard di codifica degli URL.
  • Lo spazio nella parte di parametro dell'URL viene sostituito con un carattere più (+).
  • Il punto e virgola in una parte qualsiasi della stringa viene sostituito con i caratteri "%3A".
  • La codifica appropriata dell'URL deve venire eseguita automaticamente dai browser. Non è necessario codificare manualmente i caratteri.

Per impostare un parametro del report all'interno di un URL, utilizzare la sintassi seguente:

  
parameter=value

Per specificare ad esempio due parametri, "ReportMonth" e "ReportYear", definiti in un report, usare l'URL seguente relativo a un server di report in modalità nativa:

https://myrshost/ReportServer?/AdventureWorks2022/Employee_Sales_Summary_2022&ReportMonth=3&ReportYear=2008

Ad esempio, per specificare gli stessi due parametri definiti in un report, utilizzare l'URL seguente per un server di report in modalità integrata SharePoint. Si noti /_vti_bin:

https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl&ReportMonth=3&ReportYear=2008

Per passare un valore Null per un parametro, utilizzare la sintassi seguente:

  
parameter  
:isnull=true

ad esempio:

SalesOrderNumber:isnull=true

Per passare un valore Boolean , usare 0 per false e 1 per true. Per passare un valore Float , includere il separatore decimale corrispondente alle impostazioni locali del server

Nota

Se il report contiene un parametro del report con un valore predefinito e il valore della proprietà Prompt è false (ovvero la proprietà Richiesta all'utente non è selezionata in Gestione report), non è possibile passare un valore per tale parametro in un URL. In questo modo, gli amministratori possono impedire agli utenti finali di aggiungere o modificare i valori di determinati parametri dei report.

Altri esempi

Nell'esempio di URL seguente sono inclusi spazi e più parametri

  • Nel nome della cartella "SQL Server User Education Team" sono inclusi spazi che vengono sostituiti dal carattere "+".

  • Nel nome del report "team project report" sono inclusi spazi che vengono sostituiti dal carattere "+".

  • Passaggio di due parametri di "teamgrouping2" con un valore di xgroup e "teamgrouping1" con un valore di ygroup.

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

Nell'esempio di URL seguente è incluso un parametro multivalore "OrderID". Il formato per il parametro multivalore prevede la ripetizione del nome del parametro per ogni valore.

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

Nell'esempio di URL seguente viene passato un singolo parametro SellStartDate con un valore "7/1/2005", per un server di report in modalità nativa.

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

Contenuto correlato