Passare un parametro del report in un URLPass a Report Parameter Within a URL

È possibile passare parametri del report a un report includendoli in un URL del report.You can pass report parameters to a report by including them in a report URL. Questi parametri URL non hanno il prefisso in quanto vengono passati direttamente al motore di elaborazione dei report.These URL parameters are not prefixed because they are passed directly to the report processing engine.

Importante

È importante che nell'URL sia inclusa la sintassi proxy _vti_bin per indirizzare la richiesta tramite SharePoint e il proxy HTTP di 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. 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.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.

Se non si include la sintassi del proxy, è necessario anteporre al parametro il prefisso rp:.If you don’t include the proxy syntax, then you need to prefix the parameter with rp:.

Tutti i parametri di query possono disporre di parametri di report corrispondenti.All query parameters can have corresponding report parameters. Passare un parametro di query a un report passando il parametro di report corrispondente.You pass a query parameter to a report by passing the corresponding report parameter. Per altre informazioni, vedere Compilare una query in Progettazione query relazionale (Generatore report e SSRS).For more information, see Build a Query in the Relational Query Designer (Report Builder and SSRS).

Importante

Nei parametri dei report viene fatta distinzione tra maiuscole e minuscole.Report parameters are case-sensitive.

Nota

Ai parametri del report viene applicata la distinzione tra maiuscole e minuscole e in essi vengono utilizzati i caratteri speciali seguenti:Report parameters are case-sensitive and utilize the following special characters:

  • Qualsiasi spazio nella stringa dell'URL viene sostituito con i caratteri "% 20", in base agli standard di codifica degli URL.Any space characters in the URL string are replaced with the characters "%20," according to URL encoding standards.
    • Lo spazio nella parte di parametro dell'URL viene sostituito con un carattere più (+).A space character in the parameter portion of the URL is replaced with a plus character (+).
    • Il punto e virgola in una parte qualsiasi della stringa viene sostituito con i caratteri "%3A".A semicolon in any portion of the string is replaced with the characters "%3A."
    • La codifica appropriata dell'URL deve venire eseguita automaticamente dai browser.Browsers should automatically perform the proper URL encoding. Non è necessario codificare manualmente i caratteri.You do not have to encode any of the characters manually.

Per impostare un parametro del report all'interno di un URL, utilizzare la sintassi seguente:To set a report parameter within a URL, use the following syntax:


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

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.For example, to specify the same two parameters defined in a report, use the following URL for a SharePoint integrated mode report server. Si noti /_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  

Per passare un valore Null per un parametro, utilizzare la sintassi seguente:To pass a null value for a parameter, use the following syntax:


parameter  
:isnull=true  

Ad esempio,For example,

SalesOrderNumber:isnull=true  

Per passare un valore Boolean , usare 0 per false e 1 per true.To pass a Boolean value, use 0 for false and 1 for true. Per passare un valore Float , includere il separatore decimale corrispondente alle impostazioni locali del serverTo pass a Float value, include the decimal separator of the server locale

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.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. In questo modo, gli amministratori possono impedire agli utenti finali di aggiungere o modificare i valori di determinati parametri dei report.This provides administrators an option for preventing end users from adding or modifying the values of certain report parameters.

Esempi aggiuntiviAdditional Examples

Nell'esempio di URL seguente sono inclusi spazi e più parametriThe following URL example includes spaces and multiple parameters

  • Nel nome della cartella "SQL Server User Education Team" sono inclusi spazi che vengono sostituiti dal carattere "+".Folder name of “SQL Server User Education Team” includes spaces and therefore the “+” replaces each space.

  • Nel nome del report "team project report" sono inclusi spazi che vengono sostituiti dal carattere "+".Report name of “team project report” includes spaces and therefore the “+” replaces each space.

  • Passaggio di due parametri di "teamgrouping2" con un valore di "xgroup" e "teamgrouping1" con un valore di "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  

Nell'esempio di URL seguente è incluso un parametro multivalore "OrderID".The following URL example includes a multi-value parameter ”OrderID. Il formato per il parametro multivalore prevede la ripetizione del nome del parametro per ogni valore.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  

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

Vedere ancheSee Also

Accesso con URL (SSRS) URL Access (SSRS)
Riferimento ai parametri di accesso con URLURL Access Parameter Reference