Condividi tramite

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.

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

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 /_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

Per passare un valore Boolean, usare 0 per false e1 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.

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

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

Vedere anche

Accesso con URL (SSRS)
Riferimento ai parametri di accesso con URL