Passare un parametro del report in un URL
È 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.
.gif "Nota importante") 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 ulteriori informazioni, vedere Compilare una query in Progettazione query relazionale (Generatore 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, utilizzare l'URL seguente relativo a un server di report in modalità nativa:
http://myrshost/ReportServer?/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2&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 la sintassi del proxy _vti_bin.
http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/AdventureWorks 2008R2/Employee_Sales_Summary_2008R2.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
[!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.
Esempi aggiuntivi
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 un 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.
http://myserver/ReportServer/Pages/ReportViewer.aspx?%2fProduct_and_Sales_Report_AdventureWorks&SellStartDate=7/1/2005
Vedere anche
Riferimento
Riferimento ai parametri di accesso con URL