Riferimento ai parametri di accesso con URL

  • Articolo

È possibile usare i parametri come parte di un URL per configurare l'aspetto dei report di SQL Server 2016 (13.x) Reporting Services (SSRS) o versioni successive. Questo articolo descrive i parametri usati più di frequente.

I parametri non fanno distinzione tra maiuscole e minuscole. Richiedono un prefisso:

  • rs:: è destinato al server di report.
  • rc:: è destinato a un visualizzatore HTML.
  • rv:: è destinato alla web part Visualizzatore report

È inoltre possibile specificare parametri specifici per dispositivi o estensioni per il rendering. Per altre informazioni sui parametri specifici per il dispositivo, vedere Specificare le impostazioni relative alle informazioni sul dispositivo in un URL.

Importante

Per un server di report in modalità SharePoint è importante che l'URL includa la sintassi proxy _vti_bin per indirizzare la richiesta attraverso SharePoint e il proxy HTTP di Reporting Services. Il proxy aggiunge alla richiesta HTTP il contesto necessario a garantire l'esecuzione corretta dei report per i server di report in modalità SharePoint. Per gli esempi, vedere Accesso agli elementi del server di report usando l'accesso tramite URL.

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

Comandi del visualizzatore HTML (rc:)

Specificare come destinazione il visualizzatore HTML usando il prefisso rc:.

Comando Parametro Descrizione
Toolbar True Visualizza la barra degli strumenti. Il valore predefinito è true.

Nota: Se si omette questo parametro, la barra degli strumenti viene visualizzata automaticamente nei formati di rendering che la supportano.
Toolbar False Nasconde la barra degli strumenti. Se questo parametro è false, tutte le opzioni rimanenti vengono ignorate.
Toolbar Navigation visualizza solo la paginazione nella barra degli strumenti.
Parameters True Visualizza l'area dei parametri della barra degli strumenti. Il valore predefinito è true.

Esempi:

Modalità nativa: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Parameters False Nasconde l'area dei parametri e l'utente non può visualizzarlo.
Parameters Collapsed Nasconde l'area dei parametri, ma l'utente può attivare o disattivare la visualizzazione.

Esempi:

Modalità nativa: https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed
Zoom Page Width Impostare lo zoom del report in base alla larghezza della pagina.

Esempi:

Modalità nativa: https://myrshost/reportserver?/Sales&rc:Zoom=Page%20Width

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page%20Width
Zoom Whole Page Impostare lo zoom del report per adattarsi all'intera pagina.
Zoom <integer percentage> Impostare lo zoom del report su una percentuale specifica. Il valore predefinito è 100.
Section <page number> Impostare la pagina del report da visualizzare. Se il valore è superiore al numero di pagine nel report viene visualizzata l'ultima pagina. Se il valore è inferiore a 0 viene visualizzata la pagina 1 del report. Il valore predefinito è 1.

Esempi:

Modalità nativa: https://myrshost/reportserver?/Sales&rc:Section=2

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2
FindString <text> Cercare un report per un set di testo specifico ed evidenziare il testo. Nota: rc:FindString non funziona a meno che non si includa rc:Toolbar=false nella stringa di accesso all'URL.

Esempi:

Modalità nativa: https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400
StartFind <start page> Specificare la prima sezione da cercare. Il valore predefinito è la prima pagina del report.

Esempio:

Modalità nativa: https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400
EndFind <end page> Impostare il numero dell'ultima pagina che si vuole utilizzare nella ricerca. Il valore predefinito è il numero della pagina corrente. Usare questo parametro con il parametro StartFind.

Esempio: vedere l'esempio StartFind.
FallbackPage <page number> Impostare il numero della pagina da visualizzare se si verifica un errore durante una ricerca o la selezione di una mappa documento. Il valore predefinito è il numero della pagina corrente.
GetImage <icon name> Ottenere una determinata immagine per l'interfaccia utente del visualizzatore HTML.
Icon <icon name> Ottenere l'icona di una determinata estensione per il rendering.
Stylesheet <stylesheet file name> Specificare un foglio di stile da applicare al visualizzatore HTML.
Impostazione relativa alle informazioni sul dispositivo Specificare un'impostazione relativa alle informazioni sul dispositivo nel formato rc:tag=value, dove tag è il nome di un'impostazione relativa alle informazioni sul dispositivo specifica dell'estensione per il rendering. Per altre informazioni, vedere la descrizione del comando Format.

È possibile usare l'impostazione relativa alle informazioni sul dispositivo OutputFormat in modo tale che l'estensione per il rendering IMAGE esegua il rendering del report in un'immagine JPEG usando i parametri seguenti nella stringa di accesso con URL: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG. Per altre informazioni sulle impostazioni relative alle informazioni sul dispositivo specifiche per l'estensione, vedere Impostazioni relative alle informazioni sul dispositivo per le estensioni per il rendering (Reporting Services).

Comandi del server di report (rs:)

Specificare come destinazione il server di report usando il prefisso rs:.

Comando Parametro Descrizione
Command ListChildren e GetChildren Visualizzare il contenuto di una cartella. Gli elementi della cartella sono visualizzati in una pagina generica di navigazione degli elementi.

Esempi:

Modalità nativa: https://myrshost/reportserver?/Sales&rs:Command=GetChildren

Un'istanza denominata in modalità nativa: https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildren

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren
Command Render Il report esegure il rendering nel browser, per consentire la visualizzazione del report.

Esempi:

Modalità nativa:https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

Modalità SharePoint:https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render
Command GetSharedDatasetDefinition Consente di visualizzare la definizione XML associata a un set di dati condiviso. Le proprietà del set di dati condiviso vengono salvate nella definizione. Queste proprietà includono query, parametri del set di dati, valori predefiniti, filtri del set di dati e opzioni dei dati, ad esempio regole di confronto e distinzione tra maiuscole e minuscole. Per utilizzare questo valore, è necessario disporre dell'autorizzazione per la lettura delle definizioni dei report su un set di dati condiviso.

Esempio:

Modalità nativa: https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition
Command GetDataSourceContents Consentire di visualizzare le proprietà di una determinata origine dati condivisa come XML. Se il browser supporta XML e se l'utente autenticato ha l'autorizzazione Read Contents per l'origine dati, viene visualizzata l'origine dati.

Esempi:

Modalità nativa: https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents
Command GetResourceContents Eseguire il rendering di una risorsa e viene visualizzata in una pagina HTML, se la risorsa è compatibile con il browser. In caso contrario, si può scegliere di aprire oppure salvare il file o la risorsa su disco.

Esempi:

Modalità nativa: https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents
Command GetComponentDefinition Visualizzare la definizione XML associata a un elemento del report pubblicato. Per utilizzare questo valore, è necessario disporre dell'autorizzazione per la lettura del contenuto per un elemento del report pubblicato.
Format HTML5
PPTX
ATOM
HTML4.0
MHTML
IMAGE
EXCEL (per .xls)
EXCELOPENXML (per .xlsx)
WORD (per .doc)
WORDOPENXML (per .docx)
CSV
PDF
XML		 Specificare il formato da usare per il rendering e la visualizzazione di un report. Il valore predefinito è HTML5. Per altre informazioni, vedere Esportare un report usando l'accesso con URL. Per l'elenco completo, vedere la sezione relativa all'estensione \<Render> del file rsreportserver.config del server di report. Per altre informazioni, vedere File di configurazione RsReportServer.config.

Esempi:

Modalità nativa: https://myrshost/ReportServer?/myreport&rs:Format=PDF

Modalità SharePoint: https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF
ParameterLanguage en-us, de-DE, etc. Specificare una lingua indipendente dalla lingua del browser per i parametri passati in un URL. Il valore predefinito è la lingua del browser.

Esempio:

Modalità nativa: https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE
Snapshot Eseguire il rendering di un report in base a uno snapshot della cronologia del report. Per altre informazioni, vedere Eseguire il rendering degli snapshot della cronologia dei report tramite l'accesso con URL.

Esempio:

Modalità nativa: https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02
PersistStreams true
false		 Eseguire il rendering di un report in un solo flusso persistente. Questo parametro viene utilizzato dal renderer di immagini per trasmettere il report visualizzabile un blocco alla volta. Dopo avere utilizzato il parametro in una stringa di accesso URL, utilizzare la stessa stringa di accesso con URL, sostituendo il parametro GetNextStream con il parametro PersistStreams per ottenere il blocco successivo nel flusso persistente. È possibile che questo comando dell'URL restituisca un flusso di 0 byte per indicare la fine del flusso persistente. Il valore predefinito è false.
GetNextStream true
false		 Ottenre il blocco di dati successivo in un flusso persistente al quale è possibile accedere tramite il parametro PersistStreams. Per altre informazioni, vedere la descrizione del comando PersistStreams. Il valore predefinito è false.
SessionID Specificare una sessione di report attiva stabilita tra l'applicazione client e il server di report. Il valore di questo parametro viene impostato sull'identificatore della sessione.

È possibile specificare l'ID di sessione come cookie o come parte dell'URL. Nel caso in cui si configuri il server di report per non utilizzare i cookie di sessione, la prima richiesta senza un ID di sessione specificato comporta un reindirizzamento con un ID di sessione. Per altre informazioni sulle sessioni del server di report, vedere Identificare lo stato di esecuzione.
ClearSession true
false		 Rimuovere tutte le istanze del report associate a un utente autenticato dalla sessione di report. Un'istanza di un report viene definita quando lo stesso report viene eseguito più volte con valori dei parametri del report diversi. Il valore predefinito è false. I valori validi sono true e false.
ResetSession true
false		 Reimpostare la sessione del report rimuovendo l'associazione di quest'ultima con tutti gli snapshot del report. Il valore predefinito è false. I valori validi sono true e false.
ShowHideToggle <positive integer> Visualizzare o nascondere una sezione del report. Specificare un integer positivo per rappresentare la sezione da attivare o disattivare.

Comandi Web part del Report Viewer (rv:)

Specificare come destinazione la web part Visualizzatore report che si integra con SharePoint usando il prefisso rv:. La web part Visualizzatore di report accetta inoltre il parametro rs:ParameterLanguage.

Comando Parametro Descrizione
Toolbar Full visualizza la barra degli strumenti completa. Il valore predefinito è Full.
Toolbar Navigation visualizza solo la paginazione nella barra degli strumenti.

Esempio:

Modalità SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation
Toolbar None non visualizza la barra degli strumenti.
HeaderArea Full visualizza l'intestazione completa. Il valore predefinito è Full.
HeaderArea BreadCrumbsOnly visualizza solo il percorso di navigazione nell'intestazione per segnalare all'utente la relativa posizione nell'applicazione.

Esempio:

Modalità SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly
HeaderArea None Nasconde l'intestazione.
DocMapAreaWidth Determinare la larghezza di visualizzazione, in pixel, dell'area dei parametri nella web part Visualizzatore di report. Il valore predefinito è uguale a quello della web part Visualizzatore di report. Deve essere un valore intero non negativo.
AsyncRender true
false		 Determinare se il rendering di un report viene eseguito in modo asincrono. Il valore predefinito è truecon cui si specifica che il rendering di un report viene eseguito in modo asincrono. Deve essere un valore booleano true o false.
ParamMode Full visualizza l'area dei messaggi di richiesta del parametro. Il valore predefinito è Full.
Collapsed comprime l'area dei messaggi di richiesta del parametro.

Esempio:

Modalità SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed
ParamMode Hidden nasconde l'area dei messaggi di richiesta del parametro.
DocMapMode Full visualizza l'area mappa documento. Il valore predefinito è Full.
DocMapMode Collapsed comprime l'area mappa documento.
DocMapMode Hidden nasconde l'area mappa documento.
DockToolBar Top La barra degli strumenti viene ancorata alla parte superiore. Il valore predefinito è Top.
DockToolBar Bottom La barra degli strumenti viene ancorata alla parte inferiore.

Esempio:

Modalità SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom
ToolBarItemsDisplayMode 1 (0x1) Pulsante Indietro
ToolBarItemsDisplayMode 2 (0x2) Controlli di ricerca del testo
ToolBarItemsDisplayMode 4 (0x4) Controlli per la navigazione tra le pagine
ToolBarItemsDisplayMode 8 (0x8) Pulsante Aggiorna
ToolBarItemsDisplayMode 16 (0x10) Casella di riepilogo Zoom
ToolBarItemsDisplayMode 32 0x20 pulsante Feed Atom
ToolBarItemsDisplayMode 64 (0x40) Opzione Stampa del menu in Azioni
ToolBarItemsDisplayMode 128 (0x80) Sottomenu Esporta del menu Azioni
ToolBarItemsDisplayMode 256 (0x100) Opzione di menu Apri con Generatore report del menu Azioni
ToolBarItemsDisplayMode 512 (0x200) Opzione Sottoscrivi del menu Azioni
ToolBarItemsDisplayMode 1024 (0x400) Opzione Nuovo avviso dati del menu Azioni
ToolBarItemsDisplayMode Più valori Determinare gli elementi della barra degli strumenti da visualizzare. Si tratta di un valore di enumerazione bit per bit. Per includere un elemento della barra degli strumenti, aggiungere il valore dell'elemento al valore totale. Ad esempio, per non visualizzare il menu Azioni, usare rv:ToolBarItemsDisplayMode=63 (o 0x3F), ovvero 1+2+4+8+16+32. Solo per le voci di menu Azioni, usare rv:ToolBarItemsDisplayMode=960 (o 0x3C0). Il valore predefinito è -1che include tutti gli elementi della barra degli strumenti. I valori validi sono:

Esempio:

Modalità SharePoint: https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

Contenuto correlato