Esercizio: creare un parametro del dashboard

Completato

In questa unità verrà creato un parametro per filtrare le visualizzazioni del dashboard.

Creare un parametro

Prima di tutto, è necessario passare dalla modalità di visualizzazione alla modalità di modifica.

  1. Selezionare Visualizzazione e attivare la modalità di modifica.

    Screenshot of switching to editing mode.

  2. Nella barra dei menu in alto selezionare [@] Parametri. Viene aperto il riquadro Parametri.

  3. Selezionare + Nuovo parametro

  4. Compilare le opzioni dei parametri nel riquadro Aggiungi parametro come indicato di seguito:

    Screenshot of parameter options.

    Campo Descrizione Valore suggerito
    Etichetta Il nome del parametro visualizzato nel dashboard o nella scheda di modifica. Provincia
    Tipo parametro Selezione singola: Nel filtro è possibile selezionare un solo valore come input per il parametro.
    Selezione multipla: È possibile selezionare uno o più valori nel filtro come input per il parametro.
    Intervallo di tempo: filtrare le query e i dashboard in base al tempo.
    Testo libero: l'utente può digitare un valore o copiare/incollare un valore nel campo di testo.
    Selezione multipla
    Nome variabile Il nome del parametro da usare nella query. _stato
    Tipo di dati Il tipo di dati dei valori del parametro. string
    Mostrare nelle pagine Selezionare le pagine in cui viene visualizzato questo parametro. Seleziona tutto
    Origine Valori fissi: Valori del filtro statico introdotti manualmente.
    Query: Valori introdotti dinamicamente con una query KQL.
    Query
    Origine dati Origine di un parametro basato su query. Vedere Modifica query.

Modifica query di origine dei parametri

È necessario creare un elenco di valori possibili per questo parametro. Il parametro che si sta creando è denominato State. Si desidera usarlo per filtrare i risultati in base allo stato in cui si è verificato l'evento. Si potrebbe immettere manualmente un elenco di tutti gli stati possibili, ma è più semplice usare una query che restituisca l’elenco in modo dinamico.

  1. In Origine dati selezionare il database Esempi.

  2. Nel campo Risultati query selezionare Modifica query.

  3. Copiare e incollare la query seguente nell'editor:

    StormEvents
    | distinct (State)
    
  4. Selezionare Esegui. Questa query restituisce un elenco di tutti i diversi valori della colonna Stato.

    Screenshot of editing query for parameter.

  5. Selezionare Aggiungi per tornare alla finestra di dialogo Aggiungi parametro.

  6. Selezionare l'elenco a discesa Valore predefinito e selezionare uno degli stati ( ad esempio, Minnesota).

    Screenshot of source to add query.

  7. Seleziona Fatto.

Modificare entrambe le query del riquadro per includere un parametro

È stato creato un parametro, ma il dashboard ha lo stesso aspetto. È necessario usare il parametro nella query che genera un oggetto visivo.

Eventi per data

  1. Nel riquadro Eventi per data, selezionare l'icona a forma di matita.

    Screenshot of editing the query in the tile.

  2. Usare il nome della variabile definito nelle opzioni dei parametri come filtro nella query. In questo caso, il nome della variabile è lo stato. Modificare la query in modo da includere la riga seguente:

    | where State has_any (_state)
    

    La query dovrebbe essere simile all'immagine seguente:

    Screenshot of editing the query to add parameter.

  3. Fare clic su Applica modifiche.

Conteggio eventi per stato

  1. Nel riquadro Conteggio eventi per stato, selezionare l'icona a forma di matita.

  2. Modificare la query in modo da includere la riga seguente:

    | where State has_any (_state)
    

    La query dovrebbe essere simile all'immagine seguente:

    Screenshot of query in dashboard visual including parameter.

  3. Fare clic su Applica modifiche.

Usare il parametro

Selezionare il parametro State, quindi selezionare una delle opzioni nel menu a discesa, ad esempio TEXAS. Assicurarsi di deselezionare il valore predefinito, in modo da selezionare un solo stato. Notare come le visualizzazioni cambino per visualizzare solo i dati associati allo stato selezionato.

Animated gif showing how to use the parameter picker.