Opret og administrer Real-Time dashboardparametre

Parametre er byggestenene for filtre i Real-Time dashboards. Opret og administrer parametre på dashboard-niveau for at kontrollere de filterværdier, som dashboard-forespørgsler kan bruge.

Bemærk

Du kan kun administrere parametre i redigeringstilstand for dashboard-editorer.

Forudsætninger

Se parameterlisten

Hvis du vil have vist listen over alle dashboardparametre, skal du vælge Administrer>parametre.

Opret en parameter

Sådan opretter du en parameter:

  1. Vælg knappen Ny parameter i topmenuen. Ruden Parametre åbnes.
  2. Vælg + Tilføj øverst i højre panel.
  3. Udfyld de relevante egenskaber for parameteren.
  4. Vælg Udført for at oprette parameteren.

Konfigurer parameteregenskaber

Konfigurer følgende egenskaber i ruden Tilføj parameter.

Felt Beskrivelse
Etiket Navnet på parameteren, der vises på dashboardet eller redigeringskortet.
Parametertype En af følgende parametertyper:
- Enkelt valg: Brugere vælger én værdi i filteret.
- Multiple selection: Brugere vælger en eller flere værdier i filteret.
- Tidsinterval: Tilføjer tidsbaserede parametre til filterforespørgsler og dashboards. Hvert dashboard indeholder som standard en tidsintervalvælger.
- Fri tekst: Brugere indtaster eller indsætter en værdi i filteret. Filteret gemmer de senest brugte værdier.
- Datakilde: Brugere vælger en eller flere dashboard-datakilder.
Beskrivelse Valgfri beskrivelse af parameteren.
Variabelnavn Parameternavnet, du bruger i forespørgslen.
Datatype Datatypen for parameterværdierne.
Vis på sider Siderne hvor denne parameter optræder. Vælg alle viser parameteren på alle sider.
Kilde Kilden til parameterværdierne:
- Faste værdier: Indtastet manuelt statiske filterværdier.
- Forespørgsel: Værdier returneret af en KQL-forespørgsel.
Tilføj værdien "Markér alle" Gælder kun for enkelt-selektions- og fler-selektionsparametertyper. Brug denne mulighed til at hente data for alle parameterværdier. Indbygg understøttelse af denne mulighed i forespørgslen. For et eksempel, se Brug en parameter, der bygger på flere udvalg, forespørgsler.
Standardværdi Den værdi, filteret bruger, når dashboardet først gengives.

Opret kaskaderende parametre

Kaskaderende parametre skaber et forældre-barn-forhold mellem dashboardfiltre. Den forespørgselsbaserede børneparameter bruger valget af forældreparameteren til at bestemme sine tilgængelige værdier. I dette eksempel er den fastværdige Event Type-parameter (_eventType) forælderen, og den forespørgselsbaserede tilstandsparameter (_state) er barnet.

  1. Opret forældreparameteren med følgende egenskaber:

    • Navn: Hændelsestype

    • Parametertype: Flere markeringer

    • Variabelnavn: _eventType

    • Datatype: Streng

    • Kilde: Faste værdier

    • Værdier:

      Værdi Parametervisningsnavn
      Tordenstorm, vind Tordenstormvind
      Hagl Hagl
      Lynflod Lynflod
      Tørke Tørke
      Vintervejr Vintervejr
    • Standardværdi: Tordenvejr Vind

  2. Opret underparameteren med følgende egenskaber:

    • Navn: Tilstand
    • Parametertype: Enkelt markering
    • Variabelnavn: _state
    • Datatype: Streng
    • Kilde: Forespørgsel
    • Datakilde: StormEventsSample
  3. I Redigeringsforespørgsel indtast følgende værdiforespørgsel, og vælg derefter Færdig:

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

    Denne forespørgsel returnerer op til fem tilstandsværdier, fordi den bruger .top 5 Den filtrerer værdierne efter de valgte hændelsestype-værdier . Hvis du aktiverer Vælg alle for forældreparameteren, isempty(_eventType) anvender du den markering.

  4. Sæt værdi og visningsnavn til tilstand, vælg en standardværdi, og vælg derefter Færdig.

  5. I visualiseringens forespørgselseditor indtastes følgende forespørgsel for at bruge begge parametre:

    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
    

    Værdiforespørgslen filtrerer de tilgængelige tilstandsværdier efter hændelsestype. Den visuelle forespørgsel filtrerer derefter det visuelle efter både Event Type og State valg.

Administrer parametre

Efter du har valgt Parametre i øverste bjælke, kan du se listen over eksisterende parametre. I hvert parameterkort skal du vælge redigeringsikonet for at ændre parameteren, eller vælge Mere [...] for at duplikere, slette eller flytte den.

Du kan se følgende indikatorer i parameterkortet:

  • Parameterens visningsnavn.
  • Variabelnavn.
  • Antal forespørgsler, der bruger parameteren.
  • Sider hvor parameteren optræder.

Omarranger parameterkort ved at trække og slippe dem eller ved at vælge Flyt til >.

Skærmbillede af eksempler på parameterkort.