Bruke parametere i instrumentbord i sanntid

Parametere brukes som byggeblokker for filtre i instrumentbord i sanntid. De administreres i instrumentbordomfanget, og kan legges til i spørringer for å filtrere dataene som presenteres av det underliggende visualobjektet. En spørring kan bruke én eller flere parametere.

Dette dokumentet beskriver oppretting og bruk av parametere og koblede filtre i instrumentbord. Parametere kan brukes til å filtrere instrumentbordvisualobjekter enten ved å velge parameterverdier i filterlinjen eller ved hjelp av kryssfiltre.

Spørringseksemplene som brukes i denne artikkelen, er basert på StormEvents-tabellen i eksempeldataene for væranalyse som er tilgjengelige i eksempelgalleriet.

Merk

Parameterbehandling er tilgjengelig i redigeringsmodus for instrumentbordredigering.

Forutsetning

• Et arbeidsområde med en Microsoft Fabric-aktivert kapasitet
• Redigeringstillatelser på et instrumentbord i sanntid
• Et instrumentbord med visualobjekter

Vis parameterliste

Hvis du vil vise listen over alle instrumentbordparametere, velger du Behandle>parametere.

Opprette en parameter

Slik oppretter du en parameter:

1. Velg Ny parametere-knappen på den øverste menyen. Parameterruten åpnes.
2. Velg +Legg til-knappen øverst i ruten til høyre.
3. Fyll ut de relevante egenskapene for parameteren.
4. Velg Fullført for å opprette parameteren.

Egenskaper

Konfigurer følgende egenskaper i ruten Legg til parameter.

Felt	Bekrivelse
Etikett	Navnet på parameteren som vises på instrumentbordet eller redigeringskortet.
Parametertype	Én av følgende parametere: - Enkeltvalg: Bare én verdi kan velges i filteret som inndata for parameteren. - Flere valg: Én eller flere verdier kan velges i filteret som inndata for parameteren. - Tidsområde: Gjør det mulig å opprette flere parametere for å filtrere spørringer og instrumentbord basert på tid. Hvert instrumentbord har som standard en tidsintervallvelger. - Fri tekst: Har ingen verdier fylt ut i filteret. Brukeren kan skrive inn en verdi eller kopiere/lime inn en verdi i tekstfeltet. Filteret beholder de siste verdiene som brukes.
Beskrivelse	Valgfri beskrivelse av parameteren.
Variabelnavn	Navnet på parameteren som skal brukes i spørringen.
Datatype	Datatypen for parameterverdiene.
Vis på sider	Velg sidene der denne parameteren vises. Velg alle-alternativet viser parameteren på alle sider.
Source	Kilden til parameterverdiene: - Faste verdier: Innførte statiske filterverdier manuelt. - Spørring: Dynamisk introduserte verdier ved hjelp av en KQL-spørring.
Legg til «Merk alle»-verdi	Gjelder bare for enkeltvalg og flere utvalgsparametertyper. Brukes til å hente data for alle parameterverdiene. Denne verdien bør bygges inn i spørringen for å gi funksjonaliteten. Se Bruke den flervalgsspørringsbaserte parameteren for flere eksempler på bygging av slike spørringer.
Standardverdi	Standardverdien for filteret. Filteret starter alltid med standardverdien ved første gjengivelse av instrumentbordet.

Behandle parametere

Når du har valgt Parametere fra den øverste linjen, kan du vise listen over eksisterende parametere. I hvert parameterkort kan du velge blyant-kontrollprogrammet for å redigere parameteren, eller velge Mer [...] -menyen til Dupliser, Slett eller flytt parameteren.

Følgende indikatorer kan vises i parameterkortet:

• Visningsnavn for parameter
• Variabelnavn
• Antall spørringer der parameteren ble brukt
• Sider parameteren er festet til

Du kan endre rekkefølgen på parameterkortene ved å dra og slippe, eller ved å bruke flytt til-alternativet > .

Bruke parametere i spørringen

En parameter må brukes i spørringen for å gjøre filteret aktuelt for spørringsvisualobjektet. Når det er definert, kan du se parameterne i filterlinjen for spørringssiden > og i spørringsintellisen.

Merk

Hvis parameteren ikke brukes i spørringen, forblir filteret inaktivt. Når parameteren er lagt til i spørringen, blir filteret aktivt.

Parametertyper

Flere instrumentbordparametertyper støttes, som følger:

• Standard parameter for tidsintervall
• Parametere med faste verdier for enkeltvalg
• Parametere med faste verdier med flere valg
• Spørringsbaserte parametere for enkeltvalg
• Spørringsbaserte parametere med flere valg
• Parametere for fri tekst
• Datakildeparametere

Eksemplene nedenfor beskriver hvordan du bruker parametere i en spørring for ulike parametertyper.

Standard parameter for tidsintervall

Hvert instrumentbord har som standard en tidsområdeparameter . Det vises bare på instrumentbordet som et filter når det brukes i en spørring. Bruk parameternøkkelordene og _endTime til å bruke standard tidsintervallparameter _startTime i en spørring som vist i følgende eksempel:

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

Når det er lagret, vises tidsområdefilteret på instrumentbordet. Nå kan den brukes til å filtrere dataene på kortet. Du kan filtrere instrumentbordet ved å velge fra rullegardinlisten: Tidsområde (siste x minutter/timer/dager) eller et egendefinert tidsintervall.

Parametere med faste verdier for enkeltvalg

Parametere for fast verdi er basert på forhåndsdefinerte verdier angitt av brukeren. Følgende eksempel viser deg hvordan du oppretter en enkeltvalgsparameter med fast verdi.

Opprette en parameter for faste verdier med ett utvalg

1. Velg Parametere for å åpne Parametere-ruten , og velg Ny parameter.

2. Fyll ut detaljene på følgende måte:

   • Etikett: Hendelsestype

   • Parametertype: Enkeltvalg

   • Variabelnavn: _eventType

   • Datatype: Streng

   • Fest som instrumentbordfilter: merket

   • Kilde: Faste verdier

     Bruk følgende verdier i dette eksemplet:

     Verdi	Visningsnavn for parameter
     Tordenvær Vind	Tordenvær vind
     Hagl	Hagl
     Blitsflom	Blitsflom
     Tørke	Tørke
     Vintervær	Vintervær

   • Legg til en Merk alle-verdi : Ikke avmerket

   • Standardverdi: Tordenvær

3. Velg Fullført for å opprette parameteren.

Parameteren kan ses i sideruten parametere , men brukes for øyeblikket ikke i noen visualobjekter.

Bruk en parameter for faste verdier med ett utvalg

1. Kjør en eksempelspørring ved hjelp av den nye hendelsestypeparameteren _eventType ved hjelp av variabelnavnet:

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

   Den nye parameteren vises i parameterlisten øverst på instrumentbordet.

2. Velg forskjellige verdier for å oppdatere visualobjektene.

   

Parametere med faste verdier med flere valg

Parametere for fast verdi er basert på forhåndsdefinerte verdier angitt av brukeren. Følgende eksempel viser deg hvordan du oppretter og bruker en flervalgs parameter med fast verdi.

Opprette en flervalgsparameter for faste verdier

1. Velg Parametere for å åpne Parametere-ruten , og velg Ny parameter.

2. Fyll ut detaljene som nevnt i Bruk en parameter med faste verdier med ett utvalg med følgende endringer:

   • Etikett: Hendelsestype
   • Parametertype: Flervalg
   • Variabelnavn: _eventType

3. Velg Fullført for å opprette parameteren.

De nye parameterne kan ses i sideruten parametere , men brukes for øyeblikket ikke i noen visualobjekter.

Bruke en flervalgsparameter for faste verdier

1. Kjør en eksempelspørring ved hjelp av den nye hendelsestypeparameteren ved hjelp av variabelen _eventType .

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

   Den nye parameteren vises i parameterlisten øverst på instrumentbordet.

2. Velg én eller flere forskjellige verdier for å oppdatere visualobjektene.

   

Spørringsbaserte parametere for enkeltvalg

Spørringsbaserte parameterverdier hentes under innlasting av instrumentbord ved å kjøre parameterspørringen. Følgende eksempel viser deg hvordan du oppretter og bruker en enkeltvalgs, spørringsbasert parameter.

Opprette en enkeltvalgsspørringsbasert parameter

1. Velg Parametere for å åpne Parametere-ruten , og velg Ny parameter.

2. Fyll ut detaljene som nevnt i Bruk en parameter med faste verdier med ett utvalg med følgende endringer:

   • Etikett: Delstat

   • Variabelnavn: _state

   • Kilde: Spørring

   • Datakilde: StormEventsSample

   • Velg Rediger spørring, og skriv inn følgende spørring. Velg Ferdig.

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

   • Verdi: Delstat

   • Visningsnavn: Tilstand

   • Standardverdi: Velg en standardverdi

3. Velg Fullført for å opprette parameteren.

Bruke en spørringsbasert parameter for enkeltvalg

1. Følgende eksempelspørring med den nye tilstandsparameteren bruker variabelen _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
   

   Den nye parameteren vises i parameterlisten øverst på instrumentbordet.

2. Velg forskjellige verdier for å oppdatere visualobjektene.

Spørringsbaserte parametere med flere valg

Spørringsbaserte parameterverdier utledes ved innlasting av instrumentbord ved å kjøre den angitte spørringen for brukeren. Følgende eksempel viser hvordan du kan opprette en flervalgsspørringsbasert parameter:

Opprette en flervalgsspørringsbasert parameter

1. Velg Parametere for å åpne Parametere-ruten , og velg + Ny parameter.

2. Fyll ut detaljene som nevnt i Bruk en parameter med faste verdier med ett utvalg med følgende endringer:

   • Etikett: Delstat
   • Parametertype: Flervalg
   • Variabelnavn: _state

3. Velg Fullført for å opprette parameteren.

Bruke en flervalgsspørringsbasert parameter

1. Følgende eksempelspørring bruker den nye tilstandsparameteren ved hjelp av variabelen _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
   

   Merk

   Dette eksemplet bruker alternativet Velg alt ved å se etter tomme verdier med isempty() funksjonen.

   Den nye parameteren vises i parameterlisten øverst på instrumentbordet.

2. Velg én eller flere forskjellige verdier for å oppdatere visualobjektene.

Parametere for fri tekst

Parametere for fri tekst inneholder ingen verdier. De lar deg introdusere din egen verdi.

Opprette en fri tekstparameter

1. Velg Parametere for å åpne Parametere-ruten , og velg + Ny parameter.
2. Fyll ut detaljene på følgende måte:
   • Etikett: Delstat
   • Parametertype: Fri tekst
   • Variabelnavn: _state
   • Datatype: Streng
   • Standardverdi: Ingen standardverdi

Bruke en fri tekstparameter

1. Kjør en eksempelspørring ved hjelp av den nye tilstandsparameteren _state ved hjelp av variabelnavnet:

   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
   

Datakildeparametere

Når du har lagt til datakilder på instrumentbordet, kan du opprette en parameter som velger én eller flere av de tilgjengelige datakildene. Denne parameteren kan brukes i fliser og andre parametere.

Opprette en datakildeparameter

1. Velg Parametere for å åpne Parametere-ruten , og velg + Ny parameter.

2. Fyll ut detaljene på følgende måte:

   • Etikett: Kilde
   • Parametertype: Datakilde
   • Vis på sider: Merk alle
   • Verdier: Merk alle
   • Standardverdi: StormEvents

   

3. Velg Ferdig.

Den nye parameteren er nå synlig i parameterlisten øverst på instrumentbordet.

Bruke en datakildeparameter

1. Gå til spørringen for en ny eller eksisterende flis.

2. Velg navnet på den nye parameteren under Datakildeparametere i Kilde, for eksempel den nye kildeparameteren.

   

3. Velg Bruk endringer.

4. Bruk kildeparameteren til å endre datakilden for denne tilkoblede spørringen.

Parametere for kryssfiltre

Et kryssfilter er en funksjon i et instrumentbord som lar deg velge en verdi i ett visualobjekt og filtrere dataene i andre visualobjekter på samme instrumentbord. Bruk av kryssfiltre oppnår samme resultat som å velge tilsvarende verdi for parameteren i parameterlisten øverst på instrumentbordet.

Definer kryssfiltre

Hvis du vil opprette et kryssfilter, må du aktivere alternativet i visualobjektet og deretter angi parameteren som brukes til å filtrere dataene.

1. Gå til spørringen for flisen der du vil legge til kryssfiltre.

2. Velg Visualobjekt.

3. Velg Samhandlinger i ruten til høyre, og aktiver deretter kryssfiltre.

4. Du kan også angi samhandlingstypen . Standardverdien er Punkt der du kan velge en verdi i visualobjektet. Velg Dra for å velge et verdiområde, for eksempel i et tidsdiagram.

5. Angi både kolonnen som brukes til å angi verdien, og en parameter som brukes til å filtrere spørringen til visualobjektene.

   Viktig

   Kolonnen og parameteren må være av samme datatype.

Samhandle med dataene ved hjelp av kryssfiltrering

Når kryssfilteret er definert, kan du bruke det til å samhandle med dataene. I visualobjekter der du har definert kryssfiltre, kan du velge datapunkter og bruke verdiene til å filtrere gjeldende instrumentbordside. For tabellvisualobjekter velger du datapunkter ved å høyreklikke på den aktuelle cellen, og deretter velger du Kryssfiltrer i hurtigmenyen.

Du kan tilbakestille kryssfilteret ved å velge Tilbakestill øverst i visualobjektet der det ble valgt.

Bruke ekstraheringer som instrumentbordparametere

Med ekstraheringer kan du velge en verdi i et visualobjekt og bruke den til å filtrere visualobjektene på en målside i samme instrumentbord. Når målsiden åpnes, er verdien forhåndsvalgt i de relevante filtrene. Visualobjektene på siden, for eksempel linje- eller punktdiagrammer, filtreres slik at de bare viser relaterte data. Denne funksjonen er nyttig for å opprette instrumentbord med ekstraheringer fra en sammendragsside til en detaljside. Hvis du vil ha informasjon om hvordan du oppretter sider, kan du se Legg til side.

Definer en ekstrahering

Hvis du vil opprette en ekstrahering, må du aktivere alternativet i visualobjektet og deretter angi én eller flere detaljvisningsparametere som brukes til å filtrere dataene.

1. Angi redigeringsmodus på primærsiden.

2. Rediger visualobjektet der du vil legge til en ekstrahering. Kontroller at Visualobjekt-fanen er valgt.

   

3. Velg Samhandlinger i ruten til høyre, og aktiver deretter ekstrahering.

   

4. Velg Opprett ny under Ekstrahering, og angi følgende informasjon. Du kan også velge Legg til et par til for å legge til flere parametere for en målside. Gjenta dette trinnet for å legge til ekstraheringer på andre sider i gjeldende instrumentbord ved hjelp av ulike parametere.

   Felt	Bekrivelse
   Målside	Én eller flere målsider å drille gjennom til ved hjelp av de definerte parameterne.
   Kolonne	Kolonnen for spørringsresultatet som skal brukes som verdi for en parameter på målsiden.
   Parameter	Parameteren som brukes til å filtrere visualobjekter på målsiden ved hjelp av kolonneverdien.
   Notater	Valgfri kort beskrivelse.

   Viktig

   Kolonne- og parameterpar må være av samme datatype.

   

Samhandle med dataene ved hjelp av ekstraheringer

Når ekstrahering er definert, kan du bruke dem til å samhandle med dataene. Dette gjør du ved å høyreklikke på et datapunkt i visualobjekter eller tabeller der du har definert en ekstrahering, og deretter velge Drill gjennom til>målsiden. Verdiene fra datapunktet brukes som parametere for å filtrere visualobjektene på målsiden.

Bruke filtersøk etter filtre med ett og flere valg

Skriv inn verdien du vil bruke, i filtre for enkelt og flere valg. Filteret oppdateres for å bare vise verdiene som samsvarer med søkeordet.

Relatert innhold

• Visualiser data med instrumentbord i sanntid
• Tilpasse visualobjekter for instrumentbord i sanntid