Utilizzo dei parametri per controllare i dati del report
Data creazione: 17 luglio 2006
È possibile utilizzare i parametri per controllare i dati che vengono recuperati da un'origine dei dati durante l'elaborazione di un report, nonché per filtrare i dati dopo averli recuperati. È infatti consigliabile limitare i dati recuperati dall'origine dei dati solo a quelli specificamente necessari per il report. Quando, tuttavia, si utilizzano stored procedure, non è possibile controllare i dati recuperati dalla query ed è pertanto necessario filtrare i dati del report dopo che sono stati recuperati.
Filtro dei dati nell'origine dei dati
Per specificare esattamente i dati da recuperare dall'origine dei dati, è possibile utilizzare parametri di query, che consentono di filtrare i dati nel server prima che vengano inviati al report.
Quando si definisce un set di dati con una query che include variabili, il componente di Progettazione query di Reporting Services crea un parametro di query per ogni variabile. Per ogni parametro di query viene quindi creato un parametro di report corrispondente, che consentirà agli utenti o agli autori del report di selezionare valori per i parametri di report e di passarli nella query all'origine dei dati.
Parametri di query
I parametri di query vengono definiti come parte della definizione di query di un set di dati. Poiché in ogni set di dati del report viene definita una singola query, i parametri di query vengono definiti come proprietà del set di dati.
Quando si definisce un set di dati, viene specificato un determinato tipo di origine dei dati, ad esempio Microsoft SQL Server. In Progettazione report viene aperta una finestra di Progettazione query compatibile con tale tipo di origine dei dati oppure la finestra di Progettazione query generica compatibile con qualsiasi tipo di origine dei dati. Quando si definisce la query per questa origine dei dati, la finestra di Progettazione query identifica le variabili nel testo del comando della query e crea un parametro di query per ogni variabile. Per ulteriori informazioni sulla sintassi della query prevista nell'origine dei dati, vedere Utilizzo di parametri di query con origini dei dati specifiche.
Per un'origine dei dati di SQL Server le variabili di una query sono in genere incluse nella clausola WHERE di un'istruzione Transact-SQL per limitare l'ambito dei dati restituiti durante l'esecuzione della query. Analogamente, in una query sull'origine dei dati di Analysis Services le variabili MDX utilizzate sono in genere incluse in una clausola FILTER. Le query possono inoltre includere variabili passate come input a stored procedure o a funzioni definite dall'utente.
Ogni volta che si modifica la query di un set di dati, la query viene rielaborata. Se si modifica una query rimuovendo o rinominando una variabile, i parametri di query verranno aggiornati in base a tali modifiche. Solo le variabili presenti nel testo del comando della query costituiranno i parametri di query nella definizione di query del set di dati.
Il valore predefinito di ogni parametro di query viene impostato su un'espressione che restituisce il parametro di report corrispondente. Questa associazione di parametro viene definita nella scheda Parametri delle proprietà del set di dati. Per un'origine dei dati SQL Server, ad esempio, se il parametro di query è @MyParameter, il parametro di report sarà MyParameter e il valore di @MyParameter sarà impostato sull'espressione =Parameters!MyParameter.Value. Per ulteriori informazioni, vedere Set di dati (scheda Parametri, Progettazione report). Sarà quindi possibile modificare manualmente i parametri di query e impostarne i valori predefiniti. Per ulteriori informazioni, vedere Procedura: Associazione di un parametro di query a un parametro di report (Progettazione report).
[!NOTA] Quando si rimuove o si modifica il nome di un parametro di query, il parametro di report corrispondente non verrà rimosso o modificato automaticamente.
Parametri di report
In Progettazione report i parametri di report vengono creati automaticamente quando si definisce una query del set di dati che include variabili. In Generatore report i parametri di report vengono creati automaticamente quando si imposta un messaggio di richiesta in una clausola di filtro. È inoltre possibile creare manualmente parametri di report non associati a parametri di query nella finestra di dialogo Parametri report.
- Il tipo di dati e altre proprietà di un parametro di report influiscono sulla presentazione del parametro sulla barra degli strumenti del report. A seconda del tipo di dati del parametro, è possibile impostare proprietà del parametro di report utilizzando pulsanti di opzione, caselle di testo, elenchi a discesa, controlli di calendario o più caselle di controllo.
- Un parametro di report può essere a valore singolo o multivalore. I parametri multivalore consentono a un utente di selezionare più valori per il parametro.
- Un parametro di report può inoltre essere dipendente da un altro parametro di report. In tal caso l'ordine dei parametri di report è significativo. Un parametro che viene dopo nell'elenco dei parametri può infatti dipendere da un parametro riportato in precedenza. In tal modo è possibile definire un set di parametri, noti come parametri di propagazione, in cui l'elenco dei valori di un parametro dipende dal valore scelto in un altro parametro.
- Un parametro di report può essere utilizzato in un'espressione. Le espressioni che includono parametri possono essere utilizzate in qualsiasi posizione in cui sono accettate le espressioni. Quando si esegue il report, il valore di ogni parametro verrà sostituito nell'espressione. In tal modo, i parametri selezionati dall'utente possono controllare in modo condizionale buona parte dell'aspetto e del contenuto di un report, inclusa la visibilità di righe e colonne, l'ordinamento e il filtro dei dati, nonché la gestione dei dati Null.
I parametri di report sono inclusi in una definizione di report quando si modifica un report ma possono essere gestiti in modo indipendente dopo la pubblicazione di un report. I parametri definiti per il report possono essere modificati nella visualizzazione Layout o Dati di Progettazione report. Per ulteriori informazioni, vedere Procedura: Aggiunta, modifica o eliminazione di un parametro di report (Progettazione report). Dopo la pubblicazione della definizione del report, sarà possibile modificare le proprietà dei parametri tramite Gestione report. Per ulteriori informazioni, vedere Impostazione delle proprietà dei parametri per un report pubblicato.
Valori a modifica rapida validi di un parametro
Quando si specificano valori validi soggetti a modifica rapida, è possibile che i valori risultino obsoleti prima dell'esecuzione del report. È quindi possibile che un utente selezioni dall'elenco un valore che non risulta più valido al momento dell'invio del valore e dell'esecuzione del report. Per evitare il problema, scrivere query che restituiscono set di dati per elenchi di valori validi che non subiscono modifiche durante il tempo normalmente necessario a un utente per selezionare un valore ed eseguire il report.
Evitare inoltre i valori non da query a modifica rapida. Se ad esempio si specifica la data corrente come valore disponibile, scrivere un'espressione che utilizzi la proprietà DateTime.Today anziché la proprietà DateTime.Now. In questo modo verrà eliminata la parte del valore relativa all'ora.
Applicazione di filtri ai dati del report
È possibile filtrare i dati recuperati dall'origine dei dati definendo un'espressione di filtro in un set di dati che include un riferimento ai parametri. In tal modo se si selezionano i valori per un parametro, nel report elaborato verranno visualizzati solo i dati passati tramite il filtro.
Vedere anche
Attività
Procedura: Associazione di un parametro di query a un parametro di report (Progettazione report)
Concetti
Definizione di set di dati del report
Altre risorse
Esercitazione: Aggiunta di parametri a un report tabella semplice
Esercitazione: Funzionalità avanzate per l'utilizzo dei parametri
Definizione di origini dei dati dei report
Visualizzazione Dati (Progettazione report)