Aggiungere parametri di propagazione a un report impaginato (Generatore report e SSRS)

  • Articolo

Si applica a:✅ Generatore di report Microsoft (SSRS) ✅ Power BI Report Builder ✅ Report Designer in SQL Server Data Tools

I parametri di propagazione consentono di gestire quantità elevate di dati in un report impaginato. È 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 file di definizioni di report impaginati (con estensione rdl) in Generatore report di Microsoft, Power BI Report Builder e Progettazione report di SQL Server Data Tools.

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 altre 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 includendo la caratteristica Seleziona tutto, vedere How to have a Select All Multi-Value Cascading Parameter(Come creare un parametro a cascata multivalore Seleziona tutto).

  1. Nel riquadro dei dati del report fare clic con il pulsante destro del mouse su un'origine dati e quindi scegliere Aggiungi set di dati.

  2. Nella casella Nomedigitare il nome del set di dati.

  3. In Origine datiscegliere il nome dell'origine dati o fare clic su Nuova per crearne una.

  4. In Tipo di queryscegliere il tipo di query per l'origine dati selezionata. In questo argomento si presuppone che venga usato il tipo di query Testo .

  5. In Querydigitare la query da usare per recuperare i dati per questo report. La query deve includere le parti seguenti:

    1. 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.

    2. 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.

  6. 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 l'ordine, vedere Modificare l'ordine di un parametro del report (Generatore report e SSRS)

  7. Seleziona 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

  1. Nel riquadro dei dati del report fare clic con il pulsante destro del mouse su un'origine dati e quindi scegliere Aggiungi set di dati.

  2. Nella casella Nomedigitare il nome del set di dati.

  3. In Origine dativerificare che il nome sia quello dell'origine dati selezionata nel passaggio 1.

  4. In Tipo di queryscegliere il tipo di query per l'origine dati selezionata. In questo argomento si presuppone che venga usato il tipo di query Testo .

  5. In Querydigitare la query da usare 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 usare 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.

  6. Seleziona 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

  1. Nella cartella Parametri del riquadro dei dati del report fare clic con il pulsante destro del mouse sul primo parametro e quindi scegliere Proprietà parametri.

  2. Nella casella Nomeverificare che il nome del parametro sia corretto.

  3. Fare clic su Valori disponibili.

  4. Fare clic su Ottieni valori da una query. Verranno visualizzati tre campi.

  5. Nell'elenco a discesa di Set di datifare clic sul nome del set di dati creato nella procedura precedente.

  6. Nel campo Valore fare clic sul nome del campo contenente il valore del parametro.

  7. Nel campo Etichetta fare clic sul nome del campo che fornisce l'etichetta del parametro.

  8. Seleziona 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

  1. Nel riquadro dei dati del report fare clic con il pulsante destro del mouse su un'origine dati e quindi scegliere Aggiungi set di dati.

  2. Nella casella Nomedigitare il nome del set di dati.

  3. In Origine dativerificare che il nome sia quello dell'origine dati selezionata nel passaggio 1.

  4. In Tipo di queryscegliere il tipo di query per l'origine dati selezionata. In questo argomento si presuppone che venga usato il tipo di query Testo .

  5. In Querydigitare la query da usare 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 usare 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 <tabella> 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.

  6. Seleziona 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 il secondo parametro

  1. Nella cartella Parametri del riquadro dei dati del report fare clic con il pulsante destro del mouse sul primo parametro e quindi scegliere Proprietà parametri.

  2. Nella casella Nomeverificare che il nome del parametro sia corretto.

  3. Fare clic su Valori disponibili.

  4. Fare clic su Ottieni valori da una query.

  5. Nell'elenco a discesa di Set di datifare clic sul nome del set di dati creato nella procedura precedente.

  6. Nel campo Valore fare clic sul nome del campo contenente il valore del parametro.

  7. Nel campo Etichetta fare clic sul nome del campo che fornisce l'etichetta del parametro.

  8. Seleziona OK.

Per verificare i parametri di propagazione

  1. Fai clic su Esegui.

  2. 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.

  3. 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.

  4. Fare clic su Visualizza report. La visualizzazione del report verrà aggiornata in base ai parametri scelti.

Vedi anche

Aggiungere, modificare o eliminare un parametro di report (Generatore di report e SSRS)
Parametri report (Report Builder e Report Designer)
Esercitazione: Aggiungere un parametro al report (Generatore report)
Esercitazioni di Generatore report
Aggiungere filtri per set di dati, aree dati e gruppi (Generatore di report e SSRS)
Set di dati condivisi e incorporati del report (Generatore di report e SSRS)