Esecuzione di un report con parametri
Data aggiornamento: 17 luglio 2006
Un report con parametri è un report che utilizza valori di input per l'elaborazione. Sono esempi tipici i report che filtrano i dati in base a un codice di area geografica, a una categoria di prodotti o a un identificatore. I parametri vengono in genere utilizzati per eseguire una query di selezione dei dati per il report. Per la gestione o l'esecuzione di un report con parametri è necessario conoscere gli effetti delle selezioni dei parametri sui report.
[!NOTA] I parametri utilizzati in un report vengono definiti dall'autore. Dopo la pubblicazione del report è possibile modificare alcune proprietà dei parametri per cambiare i valori utilizzati e il modo in cui si ottengono tali valori. Per ulteriori informazioni sulla creazione dei parametri, vedere Utilizzo di parametri in Reporting Services. Per ulteriori informazioni sulla gestione dei parametri, vedere Impostazione delle proprietà dei parametri per un report pubblicato.
Archiviazione e richiesta dei valori dei parametri
Per recuperare il valore di un parametro in fase di esecuzione, è possibile archiviare un valore predefinito nel report o richiedere all'utente di digitare o selezionare un valore. L'archiviazione del valore di un parametro in un report è utile se si desidera che il report venga sempre elaborato con un valore specifico. Se ad esempio una filiale regionale dispone di un sito Web dedicato, è possibile pubblicare in tale sito un report sulle vendite regionali che utilizza sempre il codice di area specifico.
È inoltre possibile richiedere agli utenti di digitare o selezionare il valore da utilizzare quando aprono il report. Se si configura un report per la richiesta dei valori dei parametri, nel report vengono inclusi campi di input per consentire agli utenti di digitare valori specifici. Dopo l'immissione dei valori, gli utenti possono fare clic su Visualizza report per eseguire il report. Se i valori sono validi, il report viene visualizzato. In caso contrario verrà visualizzato un messaggio di errore o un report vuoto. Quando si utilizzano valori dei parametri archiviati, nel report aperto non vengono visualizzati campi di input o il pulsante Visualizza report. In questo caso tutti gli utenti che eseguono il report utilizzano lo stesso valore dei parametri.
Nel caso di report che includono parametri basati su query e con un'origine dei dati che richiede una procedura di accesso per ogni utente, le credenziali verranno richieste prima della visualizzazione dei campi di input dei parametri nella pagina. In questa situazione è necessario specificare le credenziali prima che vengano recuperati i valori dei parametri.
Per eseguire un report con parametri è in genere necessario conoscere i valori da digitare. È possibile che il report includa elenchi a discesa di valori validi selezionabili.
Per l'impostazione delle proprietà dei parametri di un report pubblicato, inclusi i valori predefiniti, utilizzare Gestione report o SQL Server Management Studio. Per ulteriori informazioni, vedere Creazione dei parametri del report e impostazione delle relative proprietà e Impostazione dei parametri in una sottoscrizione.
Impostazione dei parametri nell'URL di un report
È possibile eseguire un report con parametri anche tramite un URL. In questo caso si possono specificare uno o più parametri in coppie nome-valore codificate utilizzando il carattere e commerciale (&) come separatore.
Per i parametri Null è necessario utilizzare una sintassi speciale, ovvero specificare isnull. Se si specifica un valore Null per un parametro, tutti gli altri valori specificati per lo stesso parametro vengono ignorati. Nell'esempio seguente vengono illustrati vari parametri per valori Null e costanti:
http://exampleWebServerName/reportserver?/foldercontainingreports/orders&division=mailorder®ion=west&sales:isnull=true
Per specificare parametri con più valori, ripetere il nome del parametro. Ad esempio:
http://exampleWebServerName/reportserver?/foldercontainingreports/orders®ion=east®ion=west
Per i parametri di tipo Boolean è necessario specificare il valore 0 o 1.
Per i parametri di tipo Float è necessario utilizzare il separatore decimale corrispondente alle impostazioni internazionali del server.
I parametri di tipo DateTime devono essere specificati nel formato AAAA-MM-GGThh:mm:ss in base allo standard ISO (International Organization for Standardization) 8601. Per ulteriori informazioni sull'impostazione di parametri in un URL, vedere Using URL Access Parameters.
Cronologia modifiche
| Versione | Cronologia |
|---|---|
17 luglio 2006 |
|
Vedere anche
Attività
Procedura: Apertura e chiusura di un report (Gestione report)
Procedura: Apertura e chiusura di un report (Management Studio)
Concetti
Impostazione delle proprietà dei parametri per un report pubblicato
Report con parametri
Visualizzazione di report
Individuazione e visualizzazione di report in Gestione report
Altre risorse
Gestione e utilizzo di report pubblicati