Övning: Skapa en instrumentpanelsparameter

Slutförd

I den här lektionen skapar du en parameter för att filtrera instrumentpanelsvisualiseringar.

Skapa en parameter

Först måste du växla från visningsläge till redigeringsläge.

  1. Välj Visa och växla läget till Redigera.

    Skärmbild av växling till redigeringsläge.

  2. I den översta menyraden väljer du [@] Parametrar. Fönstret Parametrar öppnas.

  3. Välj + Ny parameter

  4. Fyll i parameteralternativen i fönstret Lägg till parameter enligt följande:

    Skärmbild av parameteralternativ.

    Fält Beskrivning Föreslaget värde
    Etikett Namnet på parametern som visas på instrumentpanelen eller redigeringskortet. Stat
    Parametertyp Enskild markering: Endast ett värde kan väljas i filtret som indata för parametern.
    Flera val: Ett eller flera värden kan väljas i filtret som indata för parametern.
    Tidsintervall: Filtrera frågorna och instrumentpanelerna baserat på tid.
    Fritext: Användaren kan skriva ett värde eller kopiera/klistra in ett värde i textfältet.
    Flerval
    variabelnamn Namnet på parametern som ska användas i frågan. _tillstånd
    Datatyp Datatypen för parametervärdena. sträng
    Visa på sidor Välj de sidor där den här parametern visas. Markera alla
    Källa Fasta värden: Manuellt introducerade statiska filtervärden.
    Query: Dynamiskt introducerade värden med hjälp av en KQL-fråga.
    Fråga
    Datakälla Källan till en frågebaserad parameter. Se och redigera fråga.

Redigera källparameterns sökfråga

Du måste skapa en lista med möjliga värden för den här parametern. Parametern som du skapar kallas State. Du vill använda den för att filtrera resultatet baserat på tillståndet där händelsen inträffade. Du kan manuellt ange en lista över alla möjliga tillstånd, men det är enklare att använda en fråga som returnerar listan dynamiskt.

  1. I Datakällaväljer du databasen Exempel.

  2. I fältet Frågeresultat väljer du Redigera fråga.

  3. Kopiera/klistra in följande fråga i redigeraren:

    StormEvents
    | distinct (State)
    
  4. Välj Kör. Den här frågan returnerar en lista över alla olika värden i kolumnen State.

    Skärmbild av redigeringsfråga för parameter.

  5. Välj Lägg till för att återgå till dialogrutan Lägg till parameter.

  6. Välj listrutan Standardvärde och välj ett av delstaterna (till exempel Minnesota).

    Skärmbild av källan för att lägga till fråga.

  7. Välj Klar.

Redigera båda panelfrågorna för att inkludera en parameter

Du har skapat en parameter, men instrumentpanelen ser likadan ut. Du måste använda parametern i frågan som genererar ett visuellt objekt.

Händelser efter datum

  1. I panelen Händelser efter datum väljer du pennikonen.

    Skärmbild av redigering av frågan i panelen.

  2. Använd det variabelnamnet definierat i parameteralternativen som ett filter i frågan. I det här fallet är variabelnamnet tillstånd. Redigera frågan så att den innehåller följande rad:

    | where State has_any (_state)
    

    Frågan bör se ut som i följande bild:

    Skärmbild av redigering av frågan för att lägga till parametern.

  3. Välj Tillämpa ändringar.

Antal händelser per delstat

  1. I rutan Antal händelser per tillstånd väljer du pennikonen.

  2. Redigera frågan så att den innehåller följande rad:

    | where State has_any (_state)
    

    Frågan bör se ut som i följande bild:

    Skärmbild av fråga i instrumentpanelens visualisering, inklusive parameter.

  3. Välj Tillämpa ändringar.

Använda parametern

Välj parametern State och välj sedan något av alternativen på den nedrullningsbara menyn, till exempel TEXAS. Kontrollera och avmarkera standardvärdet så att endast ett tillstånd har valts. Observera hur visualiseringarna ändras så att endast data som är associerade med det valda tillståndet visas.

Animerad gif som visar hur du använder parameterväljaren.