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 di report).

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. Pertanto, l'ordine in cui un utente sceglie ogni valore di parametro successivo.

Per informazioni sulla creazione di parametri a cascata con più valori includendo la caratteristica Seleziona tutto, vedere Come creare un parametro a cascata multivalore.

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

  2. In Nome, immettere il nome del set di dati.

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

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

  5. In Query, immettere 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. Selezionare 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 di report)

  7. Seleziona OK.

Creare quindi un set di dati che specifichi i valori del parametro indipendente.

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 selezionare Aggiungi set di dati.

  2. In Nome, immettere 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 articolo, si presuppone che venga usato il tipo di query Testo.

  5. In Query, immettere 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.

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

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. Selezionare Valori disponibili.

  4. Selezionare Ottieni valori da una query. Verranno visualizzati tre campi.

  5. Nell'elenco Set di dati, fare clic sul nome del set di dati creato nella procedura precedente.

  6. In Valore, selezionare il nome del campo contenente il valore del parametro.

  7. In Etichetta, selezionare il 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.

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. In Nome, immettere 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 articolo, si presuppone che venga usato il tipo di query Testo.

  5. In Query, immettere 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). A tale scopo, è possibile usare un'istruzione Transact-SQL simile al blocco seguente:

    SELECT DISTINCT Subcategory FROM <table>   
WHERE (Category = @Category)

    Nella clausola WHERE, Categoria è il nome di un campo da <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.

  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.

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. Selezionare Valori disponibili.

  4. Selezionare Ottieni valori da una query.

  5. Nell'elenco Set di dati, fare clic sul nome del set di dati creato nella procedura precedente.

  6. In Valore, selezionare il nome del campo contenente il valore del parametro.

  7. In Etichetta, selezionare il nome del campo che fornisce l'etichetta del parametro.

  8. Seleziona OK.

Verificare i parametri di propagazione

  1. Selezionare 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 per il secondo parametro viene popolato con i valori disponibili basati sul valore del primo parametro.

  3. Nell'elenco 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. Selezionare Visualizza report. La visualizzazione del report verrà aggiornata in base ai parametri scelti.

Contenuto correlato