Riferimento ai parametri di accesso con URL

  • Articolo

È possibile utilizzare i seguenti parametri come parte di un URL per configurare l'aspetto dei report. I parametri più comuni sono elencati in questa sezione: I parametri rilevano la distinzione tra maiuscole e minuscole e iniziano con i prefissi di parametro rs: se indirizzati al server di report e rc: se indirizzati a un visualizzatore HTML. È inoltre possibile specificare parametri specifici per dispositivi o estensioni per il rendering. Per ulteriori informazioni sui parametri specifici dei dispositivi, vedere Specificare le impostazioni relative alle informazioni sul dispositivo in un URL.

Nota importanteImportante

È 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. Per alcuni esempi, vedere Accesso agli elementi del server di report utilizzando l'accesso tramite URL.

Per informazioni sull'inclusione dei parametri del report in un URL e relativi esempi, vedere Passare un parametro del report in un URL.

Comandi del visualizzatore HTML (rc:)

Nella tabella seguente vengono descritti i parametri di accesso all'URL con prefisso rc: la cui destinazione è il visualizzatore HTML.

Parametro

Azione

Toolbar

Visualizza o nasconde la barra degli strumenti. Se il valore di questo parametro è false, tutte le opzioni rimanenti vengono ignorate. Se si omette questo parametro, la barra degli strumenti viene visualizzata automaticamente per i formati di rendering che la supportano. Il valore predefinito di questo parametro è true.

Nota importanteImportante

rc:Toolbar=false non funziona per stringhe di accesso con URL in cui viene utilizzato un indirizzo IP, anziché un nome di dominio, per fare riferimento a un report ospitato in un sito di SharePoint.

Parameters

Visualizza o nasconde l'area dei parametri sulla barra degli strumenti. Se si imposta questo parametro su true, viene visualizzata l'area dei parametri sulla barra degli strumenti. Se si imposta questo parametro su false, l'area dei parametri non viene visualizzata e non può essere visualizzata dall'utente. Se si imposta questo parametro su un valore Collapsed, l'area dei parametri non viene visualizzata, ma può essere visualizzata o nascosta dall'utente finale. Il valore predefinito di questo parametro è true.

Per un esempio in modalità Native.

http://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

Per un esempio in modalità SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed

Zoom

Imposta il valore di zoom del report come percentuale con valore intero o come costante di stringa. I valori stringa standard comprendono Page Width e Whole Page. Questo parametro viene ignorato dalle versioni di Internet Explorer precedenti a Internet Explorer 5.0 e da tutti i browser non Microsoft. Il valore predefinito di questo parametro è 100.

Per un esempio in modalità Native.

http://myrshost/reportserver?/Sales&rc:Zoom=Page Width

Per un esempio in modalità SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width

Section

Imposta 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 di questo parametro è 1.

Ad esempio in modalità Native, per visualizzare la pagina 2 del report.

http://myrshost/reportserver?/Sales&rc:Section=2

Ad esempio in modalità SharePoint, per visualizzare la pagina 2 del report.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2

FindString

Individuare un set di testo specifico in un report.

Per un esempio in modalità Native.

http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400

Per un esempio in modalità SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400

StartFind

Specifica l'ultima sezione in cui cercare. Il valore predefinito di questo parametro è l'ultima pagina del report.

Per un esempio in modalità Native in cui viene cercata la prima occorrenza del testo "Mountain-400" nel report di esempio Product Catalog a partire da pagina uno fino a pagina cinque.

https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400

EndFind

Imposta il numero dell'ultima pagina da utilizzare nella ricerca. Ad esempio, il valore 5 indica che l'ultima pagina in cui cercare è la pagina 5 del report. Il valore predefinito è il numero della pagina corrente. Utilizzare questo parametro con il parametro StartFind. Vedere l'esempio precedente.

FallbackPage

Imposta 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

Ottiene una determinata icona per l'interfaccia utente del visualizzatore HTML.

Icon

Ottiene l'icona di una determinata estensione per il rendering.

Stylesheet

Consente di specificare un foglio di stile da applicare al visualizzatore HTML.

Impostazione relativa alle informazioni sul dispositivo

Specifica un'impostazione relativa alle informazioni sul dispositivo nel formato rc:tag=value, dove Format è il nome di un'impostazione relativa alle informazioni sul dispositivo specifica dell'estensione per il rendering attualmente utilizzata (vedere la descrizione del parametro tag. Ad esempio, è possibile utilizzare l'impostazione relativa alle informazioni sul dispositivo OutputFormat in modo tale che l'estensione per il rendering IMAGE esegua il rendering del report a un'immagine JPEG utilizzando i parametri seguenti nella stringa di accesso con URL: …&rs:Format=IMAGE&rc:OutputFormat=JPEG. Per ulteriori informazioni sulle impostazioni relative alle informazioni sul dispositivo specifiche delle estensioni, vedere Impostazioni relative alle informazioni sul dispositivo per le estensioni per il rendering (Reporting Services).

Comandi del server di report (rs:)

Nella tabella seguente vengono descritti i parametri di accesso all'URL con prefisso rs: la cui destinazione è il server di report.

Parametro

Azione

Command

Esegue un'azione su un elemento del catalogo, a seconda del tipo di elemento. Il valore predefinito è determinato dal tipo dell'elemento del catalogo a cui viene fatto riferimento nella stringa di accesso con URL. I valori validi sono:

  • ListChildren e GetChildren: consentono di visualizzare il contenuto di una cartella. Gli elementi della cartella sono visualizzati in una pagina generica di navigazione degli elementi.

    Per un esempio in modalità Native.

    http://myrshost/reportserver?/Sales&rs:Command=GetChildren

    Per un esempio in modalità SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren

  • Render: consente di eseguire il rendering del report specificato.

    Per un esempio in modalità Native:

    http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

    Per un esempio in modalità SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render

  • GetSharedDatasetDefinition: consente di visualizzare la definizione XML associata a un set di dati condiviso. Le proprietà dei set di dati condivisi, che 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, vengono salvate nella definizione. Per utilizzare questo valore, è necessario disporre dell'autorizzazione per la lettura delle definizioni dei report su un set di dati condiviso.

    Per un esempio in modalità Native.

    https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition

  • GetDataSourceContents: consente di visualizzare le proprietà di una determinata origine dati condivisa come XML. Se il browser supporta XML e se si tratta di un utente è autenticato con autorizzazione Read Contents per l'origine dati, viene visualizzata l'origine dati.

    Per un esempio in modalità Native.

    http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents

    Per un esempio in modalità SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents

  • GetResourceContents: viene eseguito il rendering di una risorsa che viene visualizzata in una pagina HTML, se la risorsa è compatibile con il browser. In caso contrario, verrà chiesto di aprire oppure salvare il file o la risorsa su disco.

    Per un esempio in modalità Native.

    http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

    Per un esempio in modalità SharePoint.

    http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents

  • GetComponentDefinition: consente di visualizzare la definizione XML associata a un elemento del report pubblicato. Per utilizzare questo valore, è necessario disporre dell'autorizzazione per la lettura del contenuto su un elemento del report pubblicato.

Format

Specifica il formato da utilizzare per il rendering di un report. I valori comuni includono ATOM, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML. Il valore predefinito è HTML4.0. Per ulteriori informazioni, vedere Esportare un report tramite l'accesso con URL.

Ad esempio, per ottenere una copia PDF di un report direttamente da un server di report in modalità Native:

http://myrshost/ReportServer?/myreport&rs:Format=PDF

Per un esempio in modalità SharePoint.

http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/myrereport.rdl&rs:Format=PDF

ParameterLanguage

Fornisce una lingua indipendente dalla lingua del browser per i parametri passati in un URL. Il valore predefinito è la lingua del browser. Il valore può essere un valore di impostazioni cultura, ad esempio en-us o de-de.

Ad esempio in modalità Native, per eseguire l'override della lingua del browser e specificare un valore di impostazioni cultura de-DE.

http://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE

Snapshot

Esegue il rendering di un report in base a uno snapshot della cronologia del report. Per ulteriori informazioni, vedere Eseguire il rendering degli snapshot della cronologia dei report tramite l'accesso con URL.

Ad esempio in modalità Native, recuperare uno snapshot della cronologia del report datato del 2003-04-07 con un timestamp 13.40.02.

http://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02

PersistStreams

Esegue 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

Ottiene il successivo blocco di dati in un flusso persistente a cui è possibile accedere tramite il parametro PersistStreams. Per ulteriori informazioni, vedere la descrizione relativa a PersistStreams. Il valore predefinito è false.

SessionID

Specifica 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 il server di report sia stato configurato 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 ulteriori informazioni sulle sessioni del server di report, vedere Identificazione dello stato di esecuzione.

ClearSession

Il valore true indica al server di report di rimuovere un report dalla sessione di report. Tutte le istanze del report associate a un utente autenticato vengono rimosse 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.

ResetSession

Il valore true indica al server di report di reimpostare la sessione del report rimuovendo l'associazione di quest'ultima con tutti gli snapshot del report. Il valore predefinito è false.

ShowHideToggle

Visualizza o nasconde una sezione del report. Specificare un integer positivo per rappresentare la sezione da attivare o disattivare.

Comandi Web part del visualizzatore di report (rv:)

Nella tabella seguente vengono descritti i nomi dei parametri di report riservati di SQL Server utilizzati per individuare la Web part del visualizzatore di report integrata con SharePoint. Questi nomi di parametro sono preceduti dal prefisso rv:. La Web part del visualizzatore di report accetta inoltre il parametro rs:ParameterLanguage.

Parametro

Azione

Toolbar

Determina la visualizzazione della barra degli strumenti per la web part del visualizzatore di report. Il valore predefinito è Full. I valori possibili sono i seguenti.

  • Full: per visualizzare la barra degli strumenti completa.

  • Navigation: per visualizzare solo la paginazione nella barra degli strumenti.

  • None: per non visualizzare la barra degli strumenti.

Ad esempio in modalità SharePoint, per visualizzare solo la paginazione nella barra degli strumenti.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation

HeaderArea

Determina la visualizzazione dell'intestazione per la web part del visualizzatore di report. Il valore predefinito è Full. I valori possibili sono i seguenti.

  • Full: per visualizzare l'intestazione completa.

  • BreadCrumbsOnly: per visualizzare solo il percorso di navigazione nell'intestazione per segnalare all'utente la relativa posizione nell'applicazione.

  • None: per non visualizzare l'intestazione.

Ad esempio in modalità SharePoint, per visualizzare solo il percorso di navigazione nell'intestazione.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly

DocMapAreaWidth

Determina la larghezza di visualizzazione, in pixel, dell'area dei parametri nella web part del visualizzatore di report. Il valore predefinito è uguale a quello della web part del visualizzatore di report. Deve essere un valore intero non negativo.

AsyncRender

Determina se il rendering di un report viene eseguito in modo asincrono. Il valore predefinito è true con cui si specifica che il rendering di un report viene eseguito in modo asincrono. Deve essere un valore booleano true o false.

ParamMode

Determina la modalità di visualizzazione dell'area dei messaggi di richiesta del parametro della Web part del visualizzatore di report viene visualizzata nella visualizzazione Pagina intera. I valori validi sono:

  • Full: consente di visualizzare l'area dei messaggi di richiesta del parametro.

  • Collapsed: per comprimere l'area dei messaggi di richiesta del parametro.

  • Hidden: per nascondere l'area dei messaggi di richiesta del parametro.

Il valore predefinito è Full.

Ad esempio in modalità SharePoint, per comprimere l'area dei messaggi di richiesta del parametro.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed

DocMapMode

Determina la modalità di visualizzazione dell'area mappa documento della Web part del visualizzatore di report nella visualizzazione Pagina intera. I valori validi sono:

  • Full: consente di visualizzare l'area mappa documento.

  • Collapsed: consente di comprimere l'area mappa documento.

  • Hidden: consente di nascondere l'area mappa documento.

Il valore predefinito è Full.

DockToolBar

Determina se la barra degli strumenti della Web part del visualizzatore di report è ancorata alla parte superiore o inferiore. I valori validi sono Top e Bottom. Il valore predefinito è Top.

Ad esempio in modalità SharePoint, per ancorare la barra degli strumenti alla parte inferiore.

http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom

ToolBarItemsDisplayMode

Determina gli elementi della barra degli strumenti che vengono visualizzati. 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 nessun menu Azioni, utilizzare rv:ToolBarItemsDisplayMode=63 (o 0x3F) vale a dire 1+2+4+8+16+32; per solo voci del menu Azioni, utilizzare rv:ToolBarItemsDisplayMode=960 (o 0x3C0). I valori validi sono:

  1. 1 (0x1): pulsante Indietro

  2. 2 (0x2): controlli di ricerca del testo

  3. 4 (0x4): controlli per la navigazione tra le pagine

  4. 8 (0x8): pulsante Aggiorna

  5. 16 (0x10): casella di riepilogo Zoom

  6. 32 (0x20): pulsante Feed Atom

  7. 64 (0x40): opzione Stampa del menu Azioni

  8. 128 (0x80): sottomenu Esporta del menu Azioni

  9. 256 (0x100: opzione Apri con Generatore report del menu Azioni

  10. 512 (0x200: opzione Sottoscrivi del menu Azioni

  11. 1024 (0x400): opzione di menu Nuovo avviso dati in Azioni

Il valore predefinito è -1 che prevede tutti gli elementi della barra degli strumenti.

Ad esempio in modalità SharePoint per visualizzare solo il pulsante Indietro, i controlli di ricerca del testo, i controlli per la navigazione tra le pagine e il pulsante Aggiorna.

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

Vedere anche

Concetti

Accesso con URL (SSRS)