Riferimento ai parametri di accesso con URL
È possibile usare i parametri seguenti come parte di un URL per configurare l'aspetto dei report di . 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 altre informazioni sui parametri specifici per il dispositivo, vedere Specificare le impostazioni relative alle informazioni sul dispositivo in un URL.
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. Per gli esempi, vedere Access Report Server Items Using URL Access.
Per informazioni sull'inclusione dei parametri del report in un URL e relativi esempi, vedere Pass a Report Parameter Within a URL.
Comandi del visualizzatore HTML (rc:)
La tabella seguente descrive i parametri di accesso all'URL preceduti da rc: e vengono usati per specificare come destinazione il visualizzatore HTML.
| Parametro | Descrizione | Valori |
|---|---|---|
| Barra degli strumenti | Visualizza o nasconde la barra degli strumenti. ** Importante ** rc:Toolbar= false non funziona per le stringhe di accesso url che usano un indirizzo IP, anziché un nome di dominio, per impostare come destinazione un report ospitato in un sito di SharePoint. |
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 nei formati di rendering che la supportano. Il valore predefinito di questo parametro è true.true false |
| Parametri | Visualizza o nasconde l'area dei parametri sulla barra degli strumenti.Native esempio di modalità:http://myrshost/reportserver?/Sales&rc:Parameters=CollapsedSharePoint esempio di modalità:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Parameters=Collapsed |
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. I valori validi sono:true false Collapsed |
| Zoom | Imposta il valore di zoom del report come percentuale con valore intero o come costante di stringa.Native esempio di modalità:http://myrshost/reportserver?/Sales&rc:Zoom=Page WidthSharePoint esempio di modalità:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Zoom=Page Width |
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. |
| Sezione | Imposta la pagina del report da visualizzare.Native esempio di modalità per visualizzare la pagina 2 del report:http://myrshost/reportserver?/Sales&rc:Section=2SharePoint esempio di modalità per visualizzare la pagina 2 del report:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:Section=2 |
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. |
| FindString | Individuare un set di testo specifico in un report.Native esempio di modalità:http://myrshost/reportserver?/Sales&rc:FindString=Mountain-400SharePoint esempio di modalità:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rc:FindString=Mountain-400 |
|
| StartFind | Specifica l'ultima sezione in cui cercare.Native esempio di modalità che cerca la prima occorrenza del testo "Mountain-400" nel report di esempio del Catalogo prodotti a partire dalla pagina 1 e termina con la pagina 5:https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400 |
Il valore predefinito di questo parametro è l'ultima pagina del report. |
| 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. Utilizzare questo parametro con il parametro StartFind . Vedere l'esempio precedente per StartFind . |
Il valore predefinito è il numero della pagina corrente. |
| 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. | |
| Icona | Ottiene l'icona di una determinata estensione per il rendering. | |
| Foglio di stile | 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 tag è il nome di un'impostazione relativa alle informazioni sul dispositivo specifica dell'estensione per il rendering attualmente usata. Vedere la descrizione del parametro Format. Ad esempio, è 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 a un'immagine JPEG usando i parametri seguenti nella stringa di accesso con URL: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG. Per altre informazioni su tutte le impostazioni relative alle informazioni sul dispositivo specifiche dell'estensione, vedere Impostazioni delle 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 preceduti da rs: e vengono usati per specificare come destinazione il server di report.
| Parametro | Descrizione |
|---|---|
| Comando | 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 Visualizza il contenuto di una cartella. Gli elementi della cartella sono visualizzati in una pagina generica di navigazione degli elementi.Native esempio di modalità:http://myrshost/reportserver?/Sales&rs:Command=GetChildrenSharePoint esempio di modalità:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales&rs:Command=GetChildren |
Render Esegue il rendering del report specificato.Native esempio di modalità:http://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=RenderSharePoint esempio di modalità:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render |
|
GetSharedDatasetDefinition Visualizza 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.Native esempio di modalità:https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition |
|
GetDataSourceContents Visualizza le proprietà di un'origine dati condivisa specificata 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.Native esempio di modalità:http://myrshost/reportserver?/Sales/AdventureWorks2012&rs:Command=GetDataSourceContentsSharePoint esempio di modalità:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/AdventureWorks2012&rs:Command=GetDataSourceContents |
|
GetResourceContents Esegue il rendering di una risorsa e lo visualizza 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.Native esempio di modalità:http://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContentsSharePoint esempio di modalità:http://myspsite/subsite/_vti_bin/reportserver?http://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents |
|
GetComponentDefinition Visualizza la definizione XML associata a un elemento del report pubblicato. Per utilizzare questo valore, è necessario disporre Read Contents dell'autorizzazione per un elemento del report pubblicato. |
|
| Formato | Specifica il formato da utilizzare per il rendering di un report. I valori comuni sono ATOM, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML. Il valore predefinito è HTML4.0. Per altre informazioni, vedere Export a Report Using URL Access.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=PDFPer 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 altre informazioni, vedere Eseguire il rendering degli snapshot della cronologia dei report tramite l'accesso con URL. Ad esempio in modalità Native, per recuperare uno snapshot della cronologia del report datato 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 blocco di dati successivo in un flusso persistente al quale è 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 Identifying Execution State. |
| 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 del report viene definita come la stessa esecuzione del report più volte con valori di parametro 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 del report riservati di SQL Server utilizzati per la web part Visualizzatore 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 |
|---|---|
| Barra degli strumenti | Determina la visualizzazione della barra degli strumenti per la web part del visualizzatore di report. Il valore predefinito è Full. I valori possibili sono: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: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 come appare l'area dei messaggi di richiesta del parametro della web part di Visualizzatore report nella visualizzazione Pagina intera. Il valore predefinito è Full. 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.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 come appare l'area mappa documento della web part di Visualizzatore report nella visualizzazione Pagina intera. Il valore predefinito è Full. 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. |
| DockToolBar | determina se la barra degli strumenti della web part di Visualizzatore 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). Il valore predefinito è -1 che prevede tutti gli elementi della barra degli strumenti. I valori validi sono:1 (0x1): pulsante Indietro 2 (0x2): controlli di ricerca del testo 4 (0x4): controlli per la navigazione tra le pagine 8 (0x8): pulsante Aggiorna 16 (0x10): casella di riepilogo Zoom 32 (0x20): pulsante Feed Atom 64 (0x40): opzione Stampa del menu Azioni 128 (0x80): sottomenu Esporta del menu Azioni 256 (0x100: opzione Apri con Generatore report del menu Azioni 512 (0x200: opzione Sottoscrivi del menu Azioni 1024 (0x400): opzione Nuovo avviso dati del menu Azioni Ad esempio, in SharePoint modalità per visualizzare solo il pulsante Indietro , i controlli di ricerca di testo, i controlli di spostamento delle pagine e il pulsante Aggiorna .http://myspsite/_vti_bin/reportserver?http://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15 |