Riferimento ai parametri di accesso con URL
È 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.
.gif "Nota importante") 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 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.
|
||
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. Per un esempio in modalità SharePoint. |
||
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. Per un esempio in modalità SharePoint. |
||
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. Ad esempio in modalità SharePoint, per visualizzare la pagina 2 del report. |
||
FindString |
Individuare un set di testo specifico in un report. Per un esempio in modalità Native. Per un esempio in modalità SharePoint. |
||
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. |
||
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:
|
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: Per un esempio in modalità SharePoint. |
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. |
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. |
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.
Ad esempio in modalità SharePoint, per visualizzare solo la paginazione nella barra degli strumenti. |
HeaderArea |
Determina la visualizzazione dell'intestazione per la web part del visualizzatore di report. Il valore predefinito è Full. I valori possibili sono i seguenti.
Ad esempio in modalità SharePoint, per visualizzare solo il percorso di navigazione nell'intestazione. |
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:
Il valore predefinito è Full. Ad esempio in modalità SharePoint, per comprimere l'area dei messaggi di richiesta del parametro. |
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:
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. |
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:
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. |