Brug parametre i dashboards i realtid

Parametre er byggestenene for filtre i Real-Time dashboards. Du administrerer dem på dashboard-niveau og tilføjer dem til forespørgsler for at filtrere de data, der vises i en visuel version. En forespørgsel kan bruge en eller flere parametre.

Denne artikel forklarer, hvordan man opretter og bruger parametre, krydsfiltre og drillthroughs i dashboards. Du kan filtrere dashboard-visuals enten ved at vælge parameterværdier i filterlinjen eller ved at bruge krydsfiltre.

De forespørgselseksempler, der bruges i denne artikel, er baseret på tabellen StormEvents i eksempeldataene vejranalyse , der er tilgængelige i galleriet med eksempler.

Bemærk

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

Forudsætninger

• Et arbejdsområde med en Microsoft Fabric-aktiveret -kapacitet.
• Redigeringstilladelser til et dashboard i realtid
• Et dashboard med visualiseringer

Vis liste over parametre

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.

Egenskaber

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

Felt	Beskrivelse
Navn	Navnet på parameteren, der vises på dashboardet eller redigeringskortet.
Parametertype	En af følgende parametertyper: - Enkelt valg: Lader brugerne vælge én værdi i filteret. - Multiple selection: Lader brugerne vælge 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: Lader brugerne skrive eller indsætte en værdi i filteret. Filteret gemmer de senest brugte værdier. - Datakilde: Lader brugere vælge 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.

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.

Du kan omarrangere parameterkort ved at trække og slippe eller ved at bruge Flyt til >.

Brug parametre i din forespørgsel

En parameter skal bruges i forespørgslen, før filteret påvirker det visuelle billede. Efter du har defineret en parameter, kan du se den i filterlinjen på forespørgselssiden og i forespørgsels-IntelliSense.

Bemærk

Hvis forespørgslen ikke bruger parameteren, forbliver filteret inaktivt. Når du tilføjer parameteren til forespørgslen, bliver filteret aktivt.

Parametertyper

Dashboardet understøtter følgende parametertyper:

• Standardparameter for tidsinterval
• Parametre med faste værdier for enkeltvalg
• Parametre med faste værdier med flere markeringer
• Forespørgselsbaserede parametre med enkeltvalg
• Forespørgselsbaserede parametre med flere markeringer
• Parametre for fritekst
• Datakildeparametre

I følgende eksempler beskrives det, hvordan du bruger parametre i en forespørgsel til forskellige parametertyper.

Standardparameter for tidsinterval

Hvert dashboard indeholder som standard en tidsintervalparameter . Det vises kun som et filter, når du bruger det i en forespørgsel. Brug og _endTime nøgleordene _startTime til at anvende standard tidsintervalparameteren, som vist i følgende eksempel:

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

Når du gemmer forespørgslen, vises tidsintervallfilteret på dashboardet. Du kan derefter filtrere det visuelle ved at vælge en forudindstilling i Tidsinterval eller ved at vælge Brugerdefineret tidsinterval.

Parametre med faste værdier for enkeltvalg

Faste værdiparametre er baseret på foruddefinerede værdier, som du angiver. Følgende eksempel viser, hvordan man opretter en enkelt-udvalgt, fastværdi parameter.

Opret en parameter med faste værdier med en enkelt markering

1. Vælg Parametre for at åbne Parameter-panelet , og vælg derefter Ny parameter.

2. Indtast følgende oplysninger:

   • Navn: Hændelsestype

   • Parametertype: Enkelt markering

   • Variabelnavn: _eventType

   • Datatype: Streng

   • Pin som dashboardfilter: Valgt

   • Kilde: Faste værdier

     I dette eksempel skal du bruge følgende værdier:

     Værdi	Parametervisningsnavn
     Tordenstorm, vind	Tordenstormvind
     Hagl	Hagl
     Lynflod	Lynflod
     Tørke	Tørke
     Vintervejr	Vintervejr

   • Tilføj en Select all-værdi : Ikke markeret

   • Standardværdi: Tordenvejrvind

3. Vælg Udført for at oprette parameteren.

Parameteren vises i Parameters-panelet , men du bruger den endnu ikke i nogen visuelle funktioner.

Brug en parameter med faste værdier med en enkelt markering

1. Kør en eksempelforespørgsel, der bruger den nye Event Type-parameter , ved at bruge _eventType variabelnavnet:

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

   Den nye parameter vises i parameterlisten øverst på dashboardet.

2. Vælg forskellige værdier for at opdatere visualiseringerne.

   

Parametre med faste værdier med flere markeringer

Faste værdiparametre er baseret på foruddefinerede værdier, som du angiver. Følgende eksempel viser, hvordan man opretter og bruger en flervalgsparameter med fast værdi.

Opret en parameter med faste værdier med flere markeringer

1. Vælg Parametre for at åbne Parameter-panelet , og vælg derefter Ny parameter.

2. Udfyld detaljerne som beskrevet i Opret en enkeltvalgsparameter med faste værdier med følgende ændringer:

   • Navn: Hændelsestype
   • Parametertype: Flere markeringer
   • Variabelnavn: _eventType

3. Vælg Udført for at oprette parameteren.

Den nye parameter vises i Parameters-panelet , men du bruger den endnu ikke i nogen visuals.

Brug en parameter med faste værdier med flere markeringer

1. Kør en eksempelforespørgsel, der bruger den nye Event Type-parameter og variablen _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 parameter vises i parameterlisten øverst på dashboardet.

2. Vælg en eller flere forskellige værdier for at opdatere visualiseringerne.

   

Forespørgselsbaserede parametre med enkeltvalg

Forespørgselsbaserede parameterværdier hentes under indlæsning af dashboardet ved at udføre parameterforespørgslen. I følgende eksempel kan du se, hvordan du opretter og bruger en forespørgselsbaseret parameter med en enkelt markering.

Opret en forespørgselsbaseret parameter med én markering

1. Vælg Parametre for at åbne Parameter-panelet , og vælg derefter Ny parameter.

2. Udfyld detaljerne som beskrevet i Opret en enkeltvalgsparameter med faste værdier med følgende ændringer:

   • Navn: Tilstand

   • Variabelnavn: _state

   • Kilde: Forespørgsel

   • Datakilde: StormEventsSample

   • Vælg Rediger forespørgsel , og angiv følgende forespørgsel. Vælg Udført.

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

   • Værdi: Tilstand

   • Vist navn: Tilstand

   • Standardværdi: Vælg en standardværdi

3. Vælg Udført for at oprette parameteren.

Brug en forespørgselsbaseret parameter med én markering

1. I følgende eksempelforespørgsel med den nye tilstandsparameter bruges variablen _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 parameter vises i parameterlisten øverst på dashboardet.

2. Vælg forskellige værdier for at opdatere visualiseringerne.

Forespørgselsbaserede parametre med flere markeringer

Forespørgselsbaserede parameterværdier kommer fra at køre en brugerspecificeret forespørgsel, når dashboardet indlæses. Følgende eksempel viser, hvordan man opretter en parameter, der bygger på flere udvalg, forespørgsler.

Opret en forespørgselsbaseret parameter med flere valg

1. Vælg Parametre for at åbne Parameter-panelet , og vælg derefter + Ny parameter.

2. Indtast detaljerne som beskrevet i Opret en enkeltvalgsbaseret forespørgselsparameter med følgende ændringer:

   • Navn: Tilstand
   • Parametertype: Flere markeringer
   • Variabelnavn: _state

3. Vælg Udført for at oprette parameteren.

Brug en forespørgselsbaseret parameter med flere valg

1. Følgende eksempelforespørgsel bruger den nye tilstandsparameter ved hjælp af variablen _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
   

   Bemærk

   I dette eksempel bruges indstillingen Vælg alle ved at søge efter tomme værdier med funktionen isempty() .

   Den nye parameter vises i parameterlisten øverst på dashboardet.

2. Vælg en eller flere forskellige værdier for at opdatere visualiseringerne.

Parametre for fritekst

Fritekstparametre indeholder ingen værdier. De giver dig mulighed for at introducere din egen værdi.

Opret en fritekstparameter

1. Vælg Parametre for at åbne Parameter-panelet , og vælg derefter + Ny parameter.
2. Indtast følgende oplysninger:
   • Navn: Tilstand
   • Parametertype: Fri tekst
   • Variabelnavn: _state
   • Datatype: Streng
   • Standardværdi: Ingen standardværdi
3. Vælg Udført for at oprette parameteren.

Brug en fritekstparameter

1. Kør en eksempelforespørgsel ved hjælp af den nye tilstandsparameter ved hjælp _state af 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
   

Datakildeparametre

Når du har tilføjet datakilder til dit dashboard, kan du oprette en parameter, der vælger en eller flere af de tilgængelige datakilder. Brug denne parameter i fliser og andre parametre.

Opret en datakildeparameter

1. Vælg Parametre for at åbne Parameter-panelet , og vælg derefter + Ny parameter.

2. Indtast følgende oplysninger:

   • Navn: Kilde
   • Parametertype: Datakilde
   • Vis på sider: Markér alle
   • Værdier: Markér alle
   • Standardværdi: StormEvents

   

3. Vælg Udført.

Parameterlisten øverst på dashboardet viser nu den nye parameter.

Brug en datakildeparameter

1. Gå til forespørgslen på en ny eller eksisterende flise.

2. I Source skal du vælge navnet på den nye parameter under Datakildeparametre, f.eks. den nye kildeparameter .

   

3. Vælg Anvend ændringer.

4. Brug parameteren Source til at ændre datakilden for denne forbundne forespørgsel.

Krydsfilterparametre

Et krydsfilter er en funktion i et dashboard, som du bruger til at vælge en værdi i én visuel grafik og filtrere dataene i andre visuals på samme dashboard. Brug af tværgående filtre opnår det samme resultat som at vælge den tilsvarende værdi for parameteren på parameterlisten øverst på dashboardet.

Definer tværgående filtre

For at oprette et krydsfilter aktiveres muligheden i det visuelle billede, og angiv derefter parameteren, der filtrerer dataene.

1. Gå til forespørgslen i flisen, hvor du vil tilføje krydsfiltre.

2. Vælg Visualisering.

3. I ruden til højre skal du vælge Interaktioner og derefter aktivere tværgående filtre.

4. Du kan også angive interaktionstypen. Standarden er punktet , hvor du vælger en værdi i det visuelle. Hvis du vil vælge et interval af værdier, f.eks. i et tidsdiagram, skal du vælge Træk.

5. Angiv både kolonnen, der giver værdien, og en parameter, der filtrerer forespørgslen på visualiseringerne.

   Vigtigt

   Kolonnen og parameteren skal være af samme datatype.

Interager med dine data ved at bruge krydsfilter

Når du har defineret krydsfilteret, brug det til at interagere med dine data. I visuals, hvor du definerer krydsfiltre, vælger datapunkter og bruger deres værdier til at filtrere den aktuelle dashboard-side. For tabelvisualiseringer, højreklik på den relevante celle, og vælg derefter krydsfilter.

Du kan nulstille krydsfilteret ved at vælge Reset øverst i det visuelle billede, hvor du valgte det.

Brug detaljeadgang som dashboardparametre

Drillthroughs lader dig vælge en værdi i en visuel værdi og bruge den til at filtrere visuelle ting på en målside i det samme dashboard. Når målsiden åbnes, vælges værdien på forhånd i de relevante filtre. Billederne på siden, såsom linje- eller spredningsdiagrammer, viser kun relaterede data. Denne funktion er nyttig, når du vil bore dig igennem fra en oversigtsside til en detaljeside. Du kan få oplysninger om oprettelse af sider under Tilføj side.

Definer en detaljeadgang

For at oprette en drillthrough skal du slå indstillingen til i det visuelle billede, og derefter angive en eller flere drillthrough-parametre, der filtrerer dataene.

1. På din primære side skal du gå til Redigeringstilstand .

2. Rediger det visuelle element, hvor du vil tilføje en detaljeadgang. Sørg for, at fanen Visual er markeret.

   

3. I højre panel vælger du Interaktioner, og slår drillthrough til.

   

4. Under Detaljeadgang skal du vælge Opret ny og angive følgende oplysninger. Du kan også vælge Tilføj et andet par for at tilføje flere parametre for en destinationsside. Gentag dette trin for at tilføje drillthroughs til andre sider i det nuværende dashboard ved at bruge forskellige parametre.

   Felt	Beskrivelse
   Destinationsside	En eller flere målsider til at bore igennem ved at bruge de definerede parametre.
   Kolonne	Den kolonne i forespørgselsresultatet, der skal bruges som værdi for en parameter på destinationssiden.
   Parameter	Parameteren, der bruges til at filtrere visualiseringer på målsiden ved at bruge kolonneværdien.
   Bemærkninger	Valgfri kort beskrivelse.

   Vigtigt

   Kolonne- og parameterpar skal være af samme datatype.

   

Interager med dine data ved at bruge drillthroughs

Når du har defineret drillthroughs, skal du bruge dem til at interagere med dine data. I visuals eller tabeller, hvor du definerer en drillthrough, højreklikker du på et datapunkt og vælger derefter Drill through to>destination-siden. Værdierne fra datapunktet filtrerer de visuelle elementer på målsiden.

Brug filtersøgning til enkeltvalg og flerudvalgsfiltre

I enkelt-udvalgs- og flerudvalgsfiltre skal du indtaste den værdi, du ønsker. Filteret opdateres til kun at vise værdier, der matcher søgeordet.

Relateret indhold

• Visualiser data med dashboards i realtid
• Tilpas dashboardvisualiseringer i realtid