Utilizzare i parametri nelle Dashboard in tempo reale

I parametri sono i blocchi predefiniti per i filtri nei dashboard di Real-Time. È possibile gestirli a livello di dashboard e aggiungerli alle query per filtrare i dati visualizzati in un oggetto visivo. La query può usare uno o più parametri.

Questo articolo illustra come creare e usare parametri, filtri incrociati e drill-through nei dashboard. È possibile filtrare gli oggetti visivi del dashboard selezionando i valori dei parametri nella barra dei filtri o usando filtri incrociati.

Gli esempi di query usati in questo articolo si basano sulla tabella StormEvents nei dati di esempio di Analisi meteo disponibili nella raccolta di esempi.

Prerequisiti

• Un spazio di lavoro con una capacità abilitata a Microsoft Fabric.
• Autorizzazioni dell'editor in un Dashboard in tempo reale
• Un dashboard con oggetti visivi

Visualizzare l’elenco parametri

Per visualizzare l'elenco di tutti i parametri del dashboard, selezionare Gestisci>Parametri.

Creare un parametro

Per creare un parametro:

1. Selezionare il pulsante Nuovo parametro nel menu in alto. Viene aperto il riquadro Parametri.
2. Selezionare + Aggiungi nella parte superiore del riquadro destro.
3. Compilare le proprietà pertinenti per il parametro.
4. Selezionare Fatto per creare il parametro.

Proprietà

Nel pannello Aggiungi parametro, configurare le seguenti proprietà.

Gestisci parametri

Dopo aver selezionato Parametri nella barra superiore, è possibile visualizzare l'elenco dei parametri esistenti. In ogni scheda dei parametri selezionare l'icona di modifica per modificare il parametro oppure selezionare Altro [...] per duplicare, eliminare o spostarlo.

È possibile visualizzare gli indicatori seguenti nella scheda dei parametri:

• Nome visualizzato del parametro.
• Nome variabile.
• Numero di query che usano il parametro .
• Pagine in cui viene visualizzato il parametro.

È possibile riordinare le schede dei parametri tramite trascinamento o utilizzando Sposta in >.

Usa i parametri nella query

Prima che il filtro influisca su tale oggetto visivo, è necessario usare un parametro nella query. Dopo aver definito un parametro, è possibile visualizzarlo nella barra dei filtri nella pagina Query e in IntelliSense query.

Tipi di parametro

Il dashboard supporta i tipi di parametro seguenti:

• Parametro intervallo di tempo predefinito
• Parametri a valori fissi a selezione singola
• Parametri a valori fissi a selezione multipla
• Parametri basati su query con selezione singola
• Parametri a selezione multipla basati su query
• Parametri di testo libero
• Parametri Origini dati

Negli esempi seguenti viene descritto come usare i parametri in una query per vari tipi di parametro.

Parametro intervallo di tempo predefinito

Ogni dashboard include un parametro Intervallo di tempo per impostazione predefinita. Viene visualizzato come filtro solo quando viene usato in una query. Usare le _startTime parole chiave e _endTime per applicare il parametro di intervallo di tempo predefinito, come illustrato nell'esempio seguente:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Quando si salva la query, il filtro dell'intervallo di tempo viene visualizzato nel dashboard. È quindi possibile filtrare l'oggetto visivo selezionando un set di impostazioni in Intervallo di tempo o selezionando Intervallo di tempo personalizzato.

Parametri a valori fissi a selezione singola

I parametri di valore fisso sono basati su valori predefiniti specificati. Nell'esempio seguente viene illustrato come creare un parametro a selezione singola e a valore fisso.

Creare un parametro a valori fissi a selezione singola

1. Selezionare Parametri per aprire il riquadro Parametri e quindi selezionare Nuovo parametro.

2. Immetti i dettagli seguenti:

   • Etichetta: tipo di evento

   • Tipo di parametro: selezione singola

   • Nome variabile: _eventType

   • Tipo di dati: stringa

   • Fissa come filtro della dashboard: Selezionato

   • Origine: valori fissi

     In questo esempio, utilizza i seguenti valori:

     Valore	Nome visualizzato del parametro
     Vento di tempesta	Vento di tempesta
     Grandine	Grandine
     Inondazione improvvisa	Piena improvvisa
     Siccità	Siccità
     Clima invernale	Clima invernale

   • Aggiungi un valore Seleziona tutto: deselezionato

   • Valore predefinito: Vento di tempesta

3. Selezionare Fatto per creare il parametro.

Il parametro viene visualizzato nel riquadro Parametri , ma non viene ancora usato in alcun oggetto visivo.

Usare un parametro a valori fissi a selezione singola

1. Eseguire una query di esempio che usa il nuovo parametro Event Type usando il nome della _eventType variabile:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Il nuovo parametro viene visualizzato nell'elenco dei parametri nella parte superiore del dashboard.

2. Selezionare valori diversi per aggiornare le visualizzazioni.

   

Parametri a valori fissi a selezione multipla

I parametri di valore fisso sono basati su valori predefiniti specificati. Nell'esempio seguente viene illustrato come creare e usare un parametro a valore fisso a selezione multipla.

Creare un parametro a valori fissi a selezione multipla

1. Selezionare Parametri per aprire il riquadro Parametri e quindi selezionare Nuovo parametro.

2. Compilare i dettagli come descritto in Creare un parametro a valori fissi a selezione singola, con le modifiche seguenti:

   • Etichetta: tipo di evento
   • Tipo di parametro: selezione multipla
   • Nome variabile: _eventType

3. Selezionare Fatto per creare il parametro.

Il nuovo parametro viene visualizzato nel riquadro Parametri , ma non viene ancora usato in alcun oggetto visivo.

Usare un parametro a valori fissi a selezione multipla

1. Eseguire una query di esempio che usa il nuovo parametro Tipo di evento e la _eventType variabile .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Il nuovo parametro viene visualizzato nell'elenco dei parametri nella parte superiore del dashboard.

2. Selezionare uno o più valori diversi per aggiornare le visualizzazioni.

   

Parametri di query a selezione singola

I valori dei parametri basati su query vengono recuperati durante il caricamento della dashboard eseguendo la query del parametro. L'esempio seguente illustra come creare e usare un parametro basato su query a selezione singola.

Creare un parametro basato su query a selezione singola

1. Selezionare Parametri per aprire il riquadro Parametri e quindi selezionare Nuovo parametro.

2. Compilare i dettagli come descritto in Creare un parametro a valori fissi a selezione singola, con le modifiche seguenti:

   • Etichetta: Stato

   • Nome variabile: _state

   • Origine: Query

   • Origine dei dati: StormEventsSample

   • Selezionare Modifica query e inserire la seguente query. Selezionare Fatto.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Valore: stato

   • Nome visualizzato: Stato

   • Valore predefinito: scegliere un valore predefinito

3. Selezionare Fatto per creare il parametro.

Usare un parametro basato su query a selezione singola

1. La query di esempio seguente con il nuovo parametro State usa la variabile _state:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Il nuovo parametro viene visualizzato nell'elenco dei parametri nella parte superiore del dashboard.

2. Selezionare valori diversi per aggiornare le visualizzazioni.

Parametri basati su query a selezione multipla

I valori dei parametri basati su query provengono dall'esecuzione di una query specificata dall'utente al caricamento del dashboard. Nell'esempio seguente viene illustrato come creare un parametro basato su query a selezione multipla.

Creare un parametro basato su query con selezione multipla

1. Selezionare Parametri per aprire il riquadro Parametri e quindi selezionare + Nuovo parametro.

2. Immettere i dettagli come descritto in Creare un parametro basato su query a selezione singola, con le modifiche seguenti:

   • Etichetta: Stato
   • Tipo di parametro: selezione multipla
   • Nome variabile: _state

3. Selezionare Fatto per creare il parametro.

Usare un parametro a selezione multipla basato su una query

1. La query di esempio seguente usa il nuovo parametro Stato usando la variabile _state.

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nota

   In questo esempio viene usata l'opzione Seleziona tutto controllando la presenza di valori vuoti con la funzione isempty().

   Il nuovo parametro viene visualizzato nell'elenco dei parametri nella parte superiore del dashboard.

2. Selezionare uno o più valori diversi per aggiornare le visualizzazioni.

Parametri di testo libero

I parametri di testo libero non contengono valori. Consentono di introdurre un valore personalizzato.

Creare un parametro di testo libero

1. Selezionare Parametri per aprire il riquadro Parametri e quindi selezionare + Nuovo parametro.
2. Immetti i dettagli seguenti:
   • Etichetta: Stato
   • Tipo di parametro: testo libero
   • Nome variabile: _state
   • Tipo di dati: stringa
   • Valore predefinito: nessun valore predefinito
3. Selezionare Fatto per creare il parametro.

Usare un parametro di testo libero

1. Eseguire una query di esempio usando il nuovo parametro Stato usando il nome della variabile _state:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Parametri Origini dati

Dopo aver aggiunto origini dati al dashboard, è possibile creare un parametro che seleziona una o più origini dati disponibili. Usare questo parametro nei riquadri e in altri parametri.

Creare un parametro di origine dati

1. Selezionare Parametri per aprire il riquadro Parametri e quindi selezionare + Nuovo parametro.

2. Immetti i dettagli seguenti:

   • Etichetta: origine
   • Tipo di parametro: origine dati
   • Mostra nelle pagine: seleziona tutto
   • Valori: selezionare tutti
   • Valore predefinito: StormEvents

   

3. Selezionare Fatto.

L'elenco dei parametri nella parte superiore del dashboard mostra ora il nuovo parametro.

Usa un parametro di origine dati

1. Vai alla query di un riquadro nuovo o esistente.

2. In Origine, selezionare il nome del nuovo parametro in Parametri origine dati, ad esempio il nuovo parametro Origine.

   

3. Fare clic su Applica modifiche.

4. Usare il parametro Origine per modificare l'origine dati per questa query connessa.

Parametri di filtro incrociato

Un filtro incrociato è una funzionalità di un dashboard che si usa per selezionare un valore in un oggetto visivo e filtrare i dati in altri oggetti visivi nello stesso dashboard. L'uso di filtri incrociati consente di ottenere lo stesso risultato della selezione del valore equivalente per il parametro nell'elenco dei parametri nella parte superiore del dashboard.

Definire i filtri incrociati

Per creare un filtro incrociato, attivare l'opzione nell'oggetto visivo e quindi specificare il parametro che filtra i dati.

1. Vai alla query del riquadro in cui vuoi aggiungere filtri incrociati.

2. Selezionare Visual.

3. Nel riquadro destro selezionare Interazioni e quindi attivare filtri incrociati.

4. Facoltativamente, specificare il tipo di Interazione. Il valore predefinito è Point, dove si seleziona un valore nel visual. Per selezionare un intervallo di valori, ad esempio in un grafico temporale, selezionare Trascina.

5. Specificare sia la colonna che fornisce il valore sia un parametro per filtrare la query degli elementi visivi.

   Importante

   La colonna e il parametro devono essere dello stesso tipo di dati.

Interagisci con i dati usando il filtro incrociato

Dopo aver definito il filtro incrociato, usarlo per interagire con i dati. Negli elementi visivi in cui si definiscono i filtri incrociati, selezionare i punti dati e utilizzarne i valori per filtrare la pagina corrente del dashboard. Per gli oggetti visivi di tipo tabella, fare clic con il pulsante destro del mouse sulla cella interessata e quindi selezionare Filtro incrociato.

È possibile reimpostare il filtro incrociato selezionando Reimposta nella parte superiore dell'oggetto visivo in cui è stato selezionato.

Usare i drill-through come parametri del dashboard

I drill-through consentono di selezionare un valore in un oggetto visivo e usarlo per filtrare gli oggetti visivi in una pagina di destinazione nello stesso dashboard. Quando si apre la pagina di destinazione, il valore viene pre-selezionato nei filtri pertinenti. Gli oggetti visivi nella pagina, ad esempio grafici a linee o a dispersione, mostrano solo i dati correlati. Questa funzionalità è utile quando si vuole eseguire il drill-through da una pagina di riepilogo a una pagina dei dettagli. Per informazioni sulla creazione di pagine, vedere Aggiungere la pagina.

Definire un drillthrough

Per creare un drillthrough, attiva l'opzione nella visualizzazione e quindi specifica uno o più parametri di drillthrough che filtrano i dati.

1. Nella pagina primaria immettere Modalità di modifica.

2. Modifica l'oggetto visivo in cui vuoi aggiungere un drillthrough. Assicurarsi che la scheda Oggetto visivo sia selezionata.

   

3. Nel riquadro destro selezionare Interazioni e quindi attivare il drill-through.

   

4. In Drill-through, selezionare Crea nuovo e specificare le informazioni seguenti. Facoltativamente, selezionare Aggiungi un'altra coppia per aggiungere più parametri per una pagina di destinazione. Ripeti questo passaggio per aggiungere drillthrough ad altre pagine nella dashboard corrente utilizzando parametri diversi.

   Campo	Descrizione
   Pagina di destinazione	Una o più pagine di destinazione a cui eseguire il drill-through usando i parametri definiti.
   Colonna	Colonna del risultato della query da usare come valore per un parametro nella pagina di destinazione.
   Parametro	Parametro utilizzato per filtrare gli oggetti visivi nella pagina di destinazione usando il valore della colonna.
   Note	Breve descrizione facoltativa.

   Importante

   Le coppie di colonne e parametri devono essere dello stesso tipo di dati.

   

Interagisci con i dati utilizzando i drillthrough

Dopo aver definito i drill-through, usarli per interagire con i dati. Negli elementi visivi o nelle tabelle in cui si definisce il drill-through, fare clic con il pulsante destro del mouse su un punto dati e quindi scegliere Drill-through alla>pagina di destinazione. I valori del punto dati filtrano gli oggetti visivi nella pagina di destinazione.

Usare la ricerca di filtri per filtri a selezione singola e a selezione multipla

Nei filtri a selezione singola e a selezione multipla digitare il valore desiderato. Il filtro viene aggiornato per visualizzare solo i valori che corrispondono al termine di ricerca.

Contenuto correlato

• Visualizzare dati con i Dashboard in tempo reale
• Personalizzare gli oggetti visivi del Dashboard in tempo reale