Aggiunta di parametri di propagazione a un report (Generatore report e SSRS)
I parametri di propagazione consentono di gestire quantità elevate di dati del report. È possibile definire un set di parametri correlati in modo che l'elenco dei valori di un parametro dipenda dal valore scelto per un altro parametro. Il primo parametro può essere ad esempio indipendente e presentare un elenco di categorie di prodotti. Quando l'utente seleziona una categoria, il secondo parametro dipende dal valore del primo parametro. I relativi valori vengono aggiornati con un elenco di sottocategorie all'interno della categoria scelta. Quando l'utente visualizza il report, per filtrarne i dati vengono utilizzati sia i valori dei parametri di categoria che di sottocategoria.
[!NOTA]
È possibile creare e modificare definizioni del report (con estensione rdl) in Generatore report e in Progettazione report di SQL Server Data Tools. Ogni ambiente di creazione offre modalità differenti per creare, aprire e salvare report ed elementi correlati. Per ulteriori informazioni, vedere Progettazione di report tramite Progettazione report e Generatore report (SSRS) nel Web all'indirizzo microsoft.com.
Per creare parametri di propagazione, è innanzitutto necessario definire la query del set di dati e includere un parametro di query per ogni parametro di propagazione necessario. È inoltre necessario creare un set di dati distinto per ogni parametro di propagazione allo scopo di fornire i valori disponibili. Per ulteriori informazioni, vedere Aggiungere, modificare o eliminare valori disponibili per un parametro di report (Generatore report e SSRS).
Per i parametri di propagazione l'ordine è importante in quanto la query del set di dati relativa a un parametro riportato più avanti nell'elenco include un riferimento a ciascun parametro riportato in precedenza. In fase di esecuzione l'ordine dei parametri nel riquadro dei dati del report determina l'ordine in cui le query del parametro vengono visualizzate nel report e quindi l'ordine in cui un utente sceglie ogni valore del parametro successivo.
Per informazioni sulla creazione di parametri a cascata con più valori e l'inclusione della funzionalità Seleziona tutto, vedere la pagina relativa alla creazione di un parametro a cascata multivalore Seleziona tutto.
Per creare il set di dati principale con una query che include più parametri correlati
Nel riquadro dei dati del report fare clic con il pulsante destro del mouse su un'origine dati, quindi scegliere Aggiungi set di dati.
Nella casella Nome digitare il nome del set di dati.
In Origine dati scegliere il nome dell'origine dati o fare clic su Nuova per crearne una.
In Tipo di query scegliere il tipo di query per l'origine dati selezionata. In questo argomento si presuppone che venga utilizzato il tipo di query Testo.
In Query digitare la query da utilizzare per recuperare i dati per questo report. La query deve includere le parti seguenti:
Un elenco di campi dell'origine dati. In un'istruzione Transact-SQL, ad esempio, l'istruzione SELECT specifica un elenco di nomi di colonne del database di una determinata tabella o vista.
Un parametro della query per ogni parametro di propagazione. Un parametro della query limita i dati recuperati dall'origine dati specificando determinati valori da includere o escludere dalla query. In genere, i parametri della query si trovano in una clausola di restrizione nella query. In un'istruzione SELECT Transact-SQL, ad esempio, i parametri della query si trovano nella clausola WHERE. Per ulteriori informazioni, vedere "Filtraggio delle righe utilizzando WHERE e HAVING" nella documentazione di Reporting Services inclusa nella documentazione online di SQL Server
Fare clic su Esegui (!). Dopo aver incluso i parametri della query e aver eseguito la query, verranno creati automaticamente i parametri del report corrispondenti ai parametri della query.
[!NOTA]
L'ordine in cui si presentano i parametri della query quando si esegue per la prima volta una query determina anche l'ordine in cui vengono creati nel report. Per modificare tale ordine, vedere Modificare l'ordine di un parametro del report (Generatore report e SSRS)
Fare clic su OK.
Procedere quindi alla creazione di un set di dati che specifichi i valori del parametro indipendente.
Per creare un set di dati in modo da specificare i valori di un parametro indipendente
Nel riquadro dei dati del report fare clic con il pulsante destro del mouse su un'origine dati, quindi scegliere Aggiungi set di dati.
Nella casella Nome digitare il nome del set di dati.
In Origine dati verificare che il nome sia quello dell'origine dati selezionata nel passaggio 1.
In Tipo di query scegliere il tipo di query per l'origine dati selezionata. In questo argomento si presuppone che venga utilizzato il tipo di query Testo.
In Query digitare la query da utilizzare per recuperare i valori per questo parametro. In genere le query per i parametri indipendenti non contengono parametri di query. Per creare, ad esempio, una query per un parametro che specifichi tutti i valori di categoria, è possibile utilizzare un'istruzione Transact-SQL simile alla seguente:
SELECT DISTINCT <column name> FROM <table>Il comando SELECT DISTINCT rimuove i valori duplicati dal set di risultati in modo che sia possibile ottenere tutti i valori univoci dalla colonna specificata nella tabella indicata.
Fare clic su Esegui (!). Nel set di risultati sono riportati i valori disponibili per il primo parametro.
Fare clic su OK.
Impostare quindi le proprietà del primo parametro in modo da utilizzare questo set di dati per popolarne i valori disponibili in fase di esecuzione.
Per impostare i valori disponibili per un parametro di report
Nella cartella Parametri del riquadro dei dati del report fare clic con il pulsante destro del mouse sul primo parametro, quindi scegliere Proprietà parametri.
Nella casella Nome verificare che il nome del parametro sia corretto.
Fare clic su Valori disponibili.
Fare clic su Ottieni valori da una query. Verranno visualizzati tre campi.
Nell'elenco a discesa di Set di dati fare clic sul nome del set di dati creato nella procedura precedente.
Nel campo Valore fare clic sul nome del campo contenente il valore del parametro.
Nel campo Etichetta fare clic sul nome del campo contenente l'etichetta del parametro.
Fare clic su OK.
Procedere quindi alla creazione di un set di dati che specifichi i valori di un parametro dipendente.
Per creare un set di dati in modo da specificare i valori di un parametro dipendente
Nel riquadro dei dati del report fare clic con il pulsante destro del mouse su un'origine dati, quindi scegliere Aggiungi set di dati.
Nella casella Nome digitare il nome del set di dati.
In Origine dati verificare che il nome sia quello dell'origine dati selezionata nel passaggio 1.
In Tipo di query scegliere il tipo di query per l'origine dati selezionata. In questo argomento si presuppone che venga utilizzato il tipo di query Testo.
In Query digitare la query da utilizzare per recuperare i valori per questo parametro. In genere le query per i parametri dipendenti includono parametri di query per ogni parametro dal quale dipende questo parametro. Per creare, ad esempio, una query per un parametro che specifichi tutti i valori di sottocategoria (parametro dipendente) per una categoria (parametro indipendente), è possibile utilizzare un'istruzione Transact-SQL simile alla seguente:
SELECT DISTINCT Subcategory FROM <table> WHERE (Category = @Category)Nella clausola WHERE Category è il nome di un campo di <table> e @Category è un parametro di query. Questa istruzione produce un elenco di sottocategorie per la categoria specificata in @Category. In fase di esecuzione tale valore verrà compilato con il valore selezionato dall'utente per il parametro del report con nome identico.
Fare clic su OK.
Impostare quindi le proprietà del secondo parametro in modo da utilizzare questo set di dati per popolarne i valori disponibili in fase di esecuzione.
Per impostare i valori disponibili per un parametro di report
Nella cartella Parametri del riquadro dei dati del report fare clic con il pulsante destro del mouse sul primo parametro, quindi scegliere Proprietà parametri.
Nella casella Nome verificare che il nome del parametro sia corretto.
Fare clic su Valori disponibili.
Fare clic su Ottieni valori da una query.
Nell'elenco a discesa di Set di dati fare clic sul nome del set di dati creato nella procedura precedente.
Nel campo Valore fare clic sul nome del campo contenente il valore del parametro.
Nel campo Etichetta fare clic sul nome del campo che fornisce l'etichetta del parametro.
Fare clic su OK.
Per verificare i parametri di propagazione
Fare clic su Esegui.
Scegliere un valore nell'elenco a discesa del primo parametro indipendente.
Il componente Elaborazione report esegue la query del set di dati per il parametro successivo e passa il valore scelto per il primo parametro. L'elenco a discesa per il secondo parametro viene popolato con i valori disponibili basati sul valore del primo parametro.
Nell'elenco a discesa del secondo parametro dipendente scegliere un valore.
In seguito alla selezione dell'ultimo parametro il report non viene eseguito automaticamente in modo da consentire all'utente di modificare la scelta effettuata.
Fare clic su Visualizza report. La visualizzazione del report verrà aggiornata in base ai parametri scelti.
Vedere anche
Attivitá
Aggiungere, modificare o eliminare un parametro di report (Generatore report e SSRS)
Esercitazione: Aggiungere un parametro al report (Generatore report)
Add a multi-value parameter to a Report
Concetti
Parametri report (Generatore report e SSRS)
Aggiungere filtri per set di dati, aree dati e gruppi (Generatore report e SSRS)
Set di dati condivisi e incorporati del report (Generatore report e SSRS)