Utilizzo dei parametri di accesso tramite 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 Specifica delle impostazioni relative alle informazioni sul dispositivo in un URL.
Comandi del visualizzatore HTML
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 nei 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. |
Zoom |
Imposta il valore di zoom del report come percentuale con valore integer o come costante di stringa. I valori stringa standard comprendono Page Width e Whole Page. Questo parametro viene ignorato dalle versioni di Microsoft Internet Explorer precedenti a Internet Explorer 5.0 e da tutti i browser non Microsoft. Il valore predefinito di questo parametro è 100. |
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. |
StartFind |
Specifica l'ultima sezione in cui cercare. 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. Il valore predefinito è il numero della pagina corrente. Utilizzare questo parametro con il parametro StartFind. |
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 |
Specifica un foglio di stile da applicare al visualizzatore HTML. |
È possibile passare parametri aggiuntivi in un URL per indirizzare l'output per il rendering HTML. Per ulteriori informazioni, vedere Impostazioni relative alle informazioni sul dispositivo HTML.
Comandi del server di report
Nella tabella seguente vengono descritti i parametri di accesso all'URL con prefisso rs: la cui destinazione è il server di report.
Parametro |
Azione |
|---|---|
Command |
Specifica l'ultima sezione in cui cercare. Il valore predefinito di questo parametro è l'ultima pagina del report. |
Format |
Specifica il formato da utilizzare per il rendering di un report. I valori comuni sono HTML3.2, HTML4.0, MHTML, IMAGE, EXCEL, WORD, CSV, PDF, XML e NULL. Per ulteriori informazioni, vedere Definizione di un di formato di rendering in un URL. |
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. |
Snapshot |
Esegue il rendering di un report in base a uno snapshot della cronologia del report. Per ulteriori informazioni, vedere Rendering degli snapshot della cronologia dei report tramite l'accesso con URL. |
PersistStream |
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 solo il parametro PersistStream con il parametro GetNextStream 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 PersistStream. Per ulteriori informazioni, vedere la descrizione relativa a PersistStream. Il valore predefinito è false. |
Comandi web part del visualizzatore di report
Nella tabella seguente vengono descritti i nuovi nomi dei parametri di report riservati di SQL Server 2008 la cui destinazione è la web part del visualizzatore di report quando Reporting Services è integrato con Windows SharePoint Services (WSS) 3.0 o con MicrosoftOffice SharePoint Server (MOSS) 2007. 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.
|
HeaderArea |
Determina la visualizzazione dell'intestazione per la web part del visualizzatore di report. Il valore predefinito è Full. I valori possibili sono i seguenti.
|
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 integer 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 venga eseguito in modo asincrono. Deve essere un valore booleano true o false. |
Esempi
Nell'esempio seguente viene nascosta la barra degli strumenti del visualizzatore HTML mediante l'impostazione del valore del parametro rc:Toolbar su false:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=false
Nell'esempio seguente viene passato un parametro hardcoded e viene nascosto il campo di input per i parametri forniti dall'utente:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Parameters=false&Year=2002
Nell'esempio seguente viene utilizzato il parametro rc:Zoom per impostare la proprietà Zoom del report su Page Width:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Zoom=Page Width
Nell'esempio seguente viene visualizzata e nascosta la sezione 13 del report:
http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:ShowHideToggle=13