Usare i parametri a cascata nei report impaginati

Questo articolo è rivolto agli autori di report che progettano report impaginati di Power BI. Offre scenari per la progettazione di parametri a cascata. I parametri a cascata sono parametri di report con dipendenze. Quando l'utente di un report seleziona il valore (o i valori) di un parametro, esso viene usato per impostare i valori disponibili per un altro parametro.

Scenari di progettazione

Esistono due scenari di progettazione per l'uso dei parametri a cascata. Possono essere usati in modo efficace per:

• Filtrare set di elementi di grandi dimensioni
• Presentare elementi pertinenti

Esempio di database

Gli esempi presentati in questo articolo si basano su un database SQL di Azure. Il database registra le operazioni di vendita e contiene varie tabelle in cui vengono archiviati rivenditori, prodotti e ordini cliente.

Una tabella denominata Reseller, contenente molte migliaia di record, archivia un record per ogni rivenditore. La tabella Reseller contiene queste colonne:

• ResellerCode (Integer)
• ResellerName
• Country-Region
• State-Province
• Città
• PostalCode

È presente anche una tabella denominata Sales. La tabella archivia i record degli ordini cliente e ha una relazione di chiave esterna con la tabella Reseller nella colonna ResellerCode.

Esempio di richiesta

Viene richiesto di sviluppare un report Profilo del rivenditore. Il report deve essere progettato in modo da visualizzare le informazioni relative a un singolo rivenditore. Non è appropriato richiedere all'utente del report di immettere i codici dei rivenditori poiché è raro che questi vengano memorizzati.

Filtrare set di elementi di grandi dimensioni

Verranno ora esaminati tre esempi che consentono di limitare i set di elementi disponibili di grandi dimensioni, come i rivenditori, Sono:

• Filtrare in base alle colonne correlate
• Filtrare in base a una colonna di raggruppamento
• Filtrare in base ai criteri di ricerca

Filtrare in base alle colonne correlate

In questo esempio l'utente del report interagisce con cinque parametri del report. Deve selezionare il paese, la provincia, la città e quindi il codice postale. Un parametro finale elenca quindi i rivenditori presenti in quella posizione geografica.

Di seguito viene illustrato come sviluppare i parametri a cascata:

1. Creare i cinque parametri del report, ordinati nella sequenza corretta.

2. Creare il set di dati CountryRegion che recupera i singoli valori dei paesi usando l'istruzione di query seguente:

   SELECT DISTINCT
     [Country-Region]
   FROM
     [Reseller]
   ORDER BY
     [Country-Region]
   

3. Creare il set di dati StateProvince che recupera i singoli valori delle province per il paese selezionato usando l'istruzione di query seguente:

   SELECT DISTINCT
     [State-Province]
   FROM
     [Reseller]
   WHERE
     [Country-Region] = @CountryRegion
   ORDER BY
     [State-Province]
   

4. Creare il set di dati City che recupera i singoli valori delle città per il paese e la provincia selezionati usando l'istruzione di query seguente:

   SELECT DISTINCT
     [City]
   FROM
     [Reseller]
   WHERE
     [Country-Region] = @CountryRegion
     AND [State-Province] = @StateProvince
   ORDER BY
     [City]
   

5. Continuare in questo modo per creare il set di dati PostalCode.

6. Creare il set di dati Reseller per recuperare tutti i rivenditori per i valori geografici selezionati usando l'istruzione di query seguente:

   SELECT
     [ResellerCode],
     [ResellerName]
   FROM
     [Reseller]
   WHERE
     [Country-Region] = @CountryRegion
     AND [State-Province] = @StateProvince
     AND [City] = @City
     AND [PostalCode] = @PostalCode
   ORDER BY
     [ResellerName]
   

7. Per ogni set di dati, ad eccezione del primo, eseguire il mapping dei parametri di query ai parametri del report corrispondenti.

Filtrare in base a una colonna di raggruppamento

In questo esempio l'utente del report interagisce con un parametro del report per selezionare la prima lettera del rivenditore. Un secondo parametro elenca quindi i rivenditori quando il nome inizia con la lettera selezionata.

Di seguito viene illustrato come sviluppare i parametri a cascata:

1. Creare i parametri del report ReportGroup e Reseller, ordinati nella sequenza corretta.

2. Creare il set di dati ReportGroup per recuperare le prime lettere usate da tutti i rivenditori usando l'istruzione di query seguente:

   SELECT DISTINCT
     LEFT([ResellerName], 1) AS [ReportGroup]
   FROM
     [Reseller]
   ORDER BY
     [ReportGroup]
   

3. Creare il set di dati Reseller per recuperare tutti i rivenditori il cui nome inizia con la lettera selezionata usando l'istruzione di query seguente:

   SELECT
     [ResellerCode],
     [ResellerName]
   FROM
     [Reseller]
   WHERE
     LEFT([ResellerName], 1) = @ReportGroup
   ORDER BY
     [ResellerName]
   

4. Eseguire il mapping del parametro di query del set di dati Reseller al parametro del report corrispondente.

Un modo più efficiente consiste nell'aggiungere la colonna di raggruppamento alla tabella Reseller. Se è salvata in modo permanente e indicizzata, restituisce il risultato migliore. Per altre informazioni, vedere Specificare le colonne calcolate in una tabella.

ALTER TABLE [Reseller]
ADD [ReportGroup] AS LEFT([ResellerName], 1) PERSISTED

Questa tecnica può offrire un potenziale ancora maggiore. Si osservi lo script seguente che aggiunge una nuova colonna di raggruppamento per filtrare i rivenditori in base a gruppi di lettere predefiniti. Crea anche un indice per recuperare in modo efficiente i dati richiesti dai parametri del report.

ALTER TABLE [Reseller]
ADD [ReportGroup2] AS CASE
  WHEN [ResellerName] LIKE '[A-C]%' THEN 'A-C'
  WHEN [ResellerName] LIKE '[D-H]%' THEN 'D-H'
  WHEN [ResellerName] LIKE '[I-M]%' THEN 'I-M'
  WHEN [ResellerName] LIKE '[N-S]%' THEN 'N-S'
  WHEN [ResellerName] LIKE '[T-Z]%' THEN 'T-Z'
  ELSE '[Other]'
END PERSISTED
GO

CREATE NONCLUSTERED INDEX [Reseller_ReportGroup2]
ON [Reseller] ([ReportGroup2]) INCLUDE ([ResellerCode], [ResellerName])
GO

Filtrare in base ai criteri di ricerca

In questo esempio l'utente del report interagisce con un parametro del report per immettere un criterio di ricerca. Un secondo parametro elenca quindi i rivenditori quando il nome contiene il criterio.

Di seguito viene illustrato come sviluppare i parametri a cascata:

1. Creare i parametri del report Search e Reseller, ordinati nella sequenza corretta.

2. Creare il set di dati Reseller per recuperare tutti i rivenditori il cui nome contiene il testo di ricerca usando l'istruzione di query seguente:

   SELECT
     [ResellerCode],
     [ResellerName]
   FROM
     [Reseller]
   WHERE
     [ResellerName] LIKE '%' + @Search + '%'
   ORDER BY
     [ResellerName]
   

3. Eseguire il mapping del parametro di query del set di dati Reseller al parametro del report corrispondente.

Di seguito è illustrato come è possibile consentire agli utenti del report di definire i propri criteri.

WHERE
  [ResellerName] LIKE @Search

Molti professionisti che non si occupano di database, tuttavia, non conoscono il carattere jolly percentuale (%). Hanno invece familiarità con il carattere asterisco (*). Modificando la clausola WHERE, è possibile consentire l'uso di questo carattere.

WHERE
  [ResellerName] LIKE SUBSTITUTE(@Search, '%', '*')

Presentare elementi pertinenti

In questo scenario è possibile usare i dati della tabella dei fatti per limitare i valori disponibili. Agli utenti del report verranno presentati gli elementi in cui è stata registrata attività.

In questo esempio l'utente del report interagisce con tre parametri del report. I primi due impostano un intervallo di date relativo alle date degli ordini cliente. Il terzo parametro elenca quindi i rivenditori presso i quali sono stati creati ordini durante questo periodo di tempo.

Di seguito viene illustrato come sviluppare i parametri a cascata:

1. Creare i parametri del report OrderDateStart, OrderDateEnd e Reseller, ordinati nella sequenza corretta.

2. Creare il set di dati Reseller per recuperare tutti i rivenditori che hanno creato ordini nell'intervallo di date, usando l'istruzione di query seguente:

   SELECT DISTINCT
     [r].[ResellerCode],
     [r].[ResellerName]
   FROM
     [Reseller] AS [r]
   INNER JOIN [Sales] AS [s]
     ON [s].[ResellerCode] = [r].[ResellerCode]
   WHERE
     [s].[OrderDate] >= @OrderDateStart
     AND [s].[OrderDate] < DATEADD(DAY, 1, @OrderDateEnd)
   ORDER BY
     [r].[ResellerName]
   

Consigli

È consigliabile progettare i report con parametri a cascata, ove possibile. Essi infatti:

• Offrono esperienze utili e intuitive agli utenti dei report
• Sono efficienti, poiché recuperano set più piccoli dei valori disponibili

Per assicurarsi di ottimizzare le origini dati:

• Usare le stored procedure, ove possibile
• Aggiungere indici appropriati per un recupero dati efficiente
• Materializzare i valori delle colonne e persino le righe per evitare costose valutazioni in fase di query

Contenuto correlato

Per altre informazioni correlate a questo articolo, vedere le risorse seguenti:

• Parametri dei report in Power BI Report Builder
• Aggiungere parametri a catena a un report (Generatore report)
• Domande? Contattare la community di Power BI
• inviare suggerimenti, Contribuire con idee per migliorare Power BI