Parameters gebruiken in realtime dashboards

Parameters zijn de bouwstenen voor filters in Real-Time Dashboards. U beheert ze op dashboardniveau en voegt ze toe aan query's om de gegevens te filteren die in een visual worden weergegeven. Een query kan een of meer parameters gebruiken.

In dit artikel wordt uitgelegd hoe u parameters, kruisfilters en doorklikacties in dashboards maakt en gebruikt. U kunt dashboardvisuals filteren door parameterwaarden te selecteren in de filterbalk of door kruislingse filters te gebruiken.

De queryvoorbeelden die in dit artikel worden gebruikt, zijn gebaseerd op de tabel StormEvents in de voorbeeldgegevens van Weather Analytics die beschikbaar zijn in de galerie met voorbeelden.

Vereisten

• Een werkruimte met een ingeschakelde Microsoft Fabric-capaciteit.
• Editormachtigingen voor een realtime dashboard
• Een dashboard met visuals

Lijst met parameters weergeven

Als u de lijst met alle dashboardparameters wilt weergeven, selecteert u Beheren>Parameters.

Een parameter maken

Een parameter maken:

1. Selecteer de knop Nieuwe parameter in het bovenste menu. Het deelvenster Parameters wordt geopend.
2. Selecteer + Toevoegen bovenaan het rechterdeelvenster.
3. Vul de relevante eigenschappen voor uw parameter in.
4. Selecteer Gereed om de parameter te maken.

Eigenschappen

Configureer in het deelvenster Parameter toevoegen de volgende eigenschappen.

Parameters beheren

Nadat u Parameters op de bovenste balk hebt geselecteerd, kunt u de lijst met bestaande parameters weergeven. Selecteer in elke parameterkaart het bewerkingspictogram om de parameter te wijzigen of selecteer Meer [...] om deze te dupliceren, te verwijderen of te verplaatsen.

U kunt de volgende indicatoren weergeven in de parameterkaart:

• Weergavenaam van de parameter.
• Variabelenaam.
• Aantal query's dat gebruikmaakt van de parameter.
• Pagina's waarop de parameter wordt weergegeven.

U kunt parameterkaarten opnieuw ordenen via slepen en neerzetten of door Move to > te gebruiken.

Parameters gebruiken in uw query

Een parameter moet in de query worden gebruikt voordat het filter effect heeft op die visualisatie. Nadat u een parameter hebt gedefinieerd, kunt u deze zien in de filterbalk op de pagina Query en in Query IntelliSense.

Parametertypen

Het dashboard ondersteunt de volgende parametertypen:

• Standaardtijdbereikparameter
• Parameters met één selectie met vaste waarden
• Parameters voor meerdere selecties met vaste waarden
• Parameters op basis van query's met één selectie
• Parameters op basis van meerdere selectiequery's
• Vrije tekstparameters
• Gegevensbronparameters

In de volgende voorbeelden wordt beschreven hoe u parameters gebruikt in een query voor verschillende parametertypen.

Standaardtijdbereikparameter

Elk dashboard bevat standaard een tijdsbereikparameter . Het wordt alleen weergegeven als een filter wanneer u deze in een query gebruikt. Gebruik de _startTime parameter en _endTime trefwoorden om de standaardtijdbereikparameter toe te passen, zoals wordt weergegeven in het volgende voorbeeld:

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

Wanneer u de query opslaat, wordt het tijdsbereikfilter weergegeven op het dashboard. Vervolgens kunt u de visual filteren door een vooraf ingestelde tijdsbereik te selecteren of door aangepast tijdsbereik te selecteren.

Parameters met één selectiemogelijkheid en vaste waarden

Parameters voor vaste waarden zijn gebaseerd op vooraf gedefinieerde waarden die u opgeeft. In het volgende voorbeeld ziet u hoe u een parameter met één selectie met vaste waarde maakt.

Een parameter met één selectie met vaste waarden maken

1. Selecteer Parameters om het deelvenster Parameters te openen en selecteer vervolgens Nieuwe parameter.

2. Voer de volgende gegevens in:

   • Label: Gebeurtenistype

   • Parametertype: Enkele selectie

   • Variabelenaam: _eventType

   • Gegevenstype: tekenreeks

   • Vastzetten als dashboardfilter: Geselecteerd

   • Bron: Vaste waarden

     In dit voorbeeld gebruikt u de volgende waarden:

     Waarde	Weergavenaam van de parameter
     Onweer Wind	Onweer wind
     Hagel	Hagel
     Stortvloed	Stortvloed
     Droogte	Droogte
     Winterweer	Winterweer

   • Voeg een waarde Alles selecteren toe: Niet aangevinkt

   • Standaardwaarde: Thunderstorm Wind

3. Selecteer Gereed om de parameter te maken.

De parameter wordt weergegeven in het deelvenster Parameters , maar u gebruikt deze nog niet in visuals.

Een parameter met één selectie met vaste waarden gebruiken

1. Voer een voorbeeldquery uit die gebruikmaakt van de nieuwe parameter Gebeurtenistype met behulp van de naam van de _eventType variabele:

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

   De nieuwe parameter wordt boven aan het dashboard weergegeven in de lijst met parameters.

2. Selecteer verschillende waarden om de visuals bij te werken.

   

Parameters voor meerdere selecties met vaste waarden

Parameters voor vaste waarden zijn gebaseerd op vooraf gedefinieerde waarden die u opgeeft. In het volgende voorbeeld ziet u hoe u een parameter met een vaste waarde met meerdere selecties maakt en gebruikt.

Een parameter met meerdere selectie vaste waarden maken

1. Selecteer Parameters om het deelvenster Parameters te openen en selecteer vervolgens Nieuwe parameter.

2. Vul de details in zoals beschreven in Een parameter met één selectie met vaste waarden maken, met de volgende wijzigingen:

   • Label: Gebeurtenistype
   • Parametertype: Meerdere selectie
   • Variabelenaam: _eventType

3. Selecteer Gereed om de parameter te maken.

De nieuwe parameter wordt weergegeven in het deelvenster Parameters , maar u gebruikt deze nog niet in visuals.

Een parameter met meerdere selecties met vaste waarden gebruiken

1. Voer een voorbeeldquery uit die gebruikmaakt van de nieuwe parameter Gebeurtenistype en de _eventType variabele.

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

   De nieuwe parameter wordt boven aan het dashboard weergegeven in de lijst met parameters.

2. Selecteer een of meer andere waarden om de visuals bij te werken.

   

Parameters op basis van query's met één selectie

Parameterwaarden op basis van query's worden opgehaald tijdens het laden van het dashboard door de parameterquery uit te voeren. In het volgende voorbeeld ziet u hoe u een op query's gebaseerde parameter met één selectie maakt en gebruikt.

Een querygebaseerde parameter met één selectie maken

1. Selecteer Parameters om het deelvenster Parameters te openen en selecteer vervolgens Nieuwe parameter.

2. Vul de details in zoals beschreven in Een parameter met één selectie met vaste waarden maken, met de volgende wijzigingen:

   • Label: status

   • Variabelenaam: _state

   • Bron: Zoekopdracht

   • Gegevensbron: StormEventsSample

   • Selecteer Query bewerken en voer de volgende query in. Selecteer Klaar.

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

   • Waarde: Status

   • Weergavenaam: Status

   • Standaardwaarde: Een standaardwaarde kiezen

3. Selecteer Gereed om de parameter te maken.

Een op query's gebaseerde parameter met één selectie gebruiken

1. De volgende voorbeeldquery met de nieuwe parameter State maakt gebruik van de _state variabele:

   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
   

   De nieuwe parameter wordt boven aan het dashboard weergegeven in de lijst met parameters.

2. Selecteer verschillende waarden om de visuals bij te werken.

Parameters op basis van meerdere selectiequery's

Op query's gebaseerde parameterwaarden zijn afkomstig van het uitvoeren van een door de gebruiker opgegeven query wanneer het dashboard wordt geladen. In het volgende voorbeeld ziet u hoe u een op meerdere selectiequery's gebaseerde parameter maakt.

Een parameter op basis van meerdere selectiequery's maken

1. Selecteer Parameters om het deelvenster Parameters te openen en selecteer vervolgens + Nieuwe parameter.

2. Voer de details in zoals beschreven in Een op query's gebaseerde parameter met één selectie maken, met de volgende wijzigingen:

   • Label: status
   • Parametertype: Meerdere selectie
   • Variabelenaam: _state

3. Selecteer Gereed om de parameter te maken.

Een op query's gebaseerde parameter met meerdere selecties gebruiken

1. In de volgende voorbeeldquery wordt de nieuwe statusparameter gebruikt met behulp van de _state variabele.

   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
   

   Notitie

   In dit voorbeeld wordt de optie Alles selecteren gebruikt door te controleren op lege waarden met de isempty() functie.

   De nieuwe parameter wordt boven aan het dashboard weergegeven in de lijst met parameters.

2. Selecteer een of meer andere waarden om de visuals bij te werken.

Vrije tekstparameters

Vrije tekstparameters bevatten geen waarden. Hiermee kunt u uw eigen waarde introduceren.

Een parameter voor vrije tekst maken

1. Selecteer Parameters om het deelvenster Parameters te openen en selecteer vervolgens + Nieuwe parameter.
2. Voer de volgende gegevens in:
   • Label: status
   • Parametertype: Vrije tekst
   • Variabelenaam: _state
   • Gegevenstype: tekenreeks
   • Standaardwaarde: geen standaardwaarde
3. Selecteer Gereed om de parameter te maken.

Een gratis tekstparameter gebruiken

1. Voer een voorbeeldquery uit met behulp van de nieuwe parameter State met behulp van de naam van de _state variabele:

   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
   

Gegevensbronparameters

Nadat u gegevensbronnen aan uw dashboard hebt toegevoegd, kunt u een parameter maken waarmee een of meer van de beschikbare gegevensbronnen worden geselecteerd. Gebruik deze parameter in tegels en in andere parameters.

Een gegevensbronparameter maken

1. Selecteer Parameters om het deelvenster Parameters te openen en selecteer vervolgens + Nieuwe parameter.

2. Voer de volgende gegevens in:

   • Label: Bron
   • Parametertype: Gegevensbron
   • Weergeven op pagina's: Alles selecteren
   • Waarden: Alles selecteren
   • Standaardwaarde: StormEvents

   

3. Selecteer Klaar.

In de lijst met parameters bovenaan het dashboard wordt nu de nieuwe parameter weergegeven.

Een gegevensbronparameter gebruiken

1. Ga naar de query voor een nieuwe of bestaande tegel.

2. Selecteer in Bron de naam van de nieuwe parameter onder Gegevensbronparameters, zoals de nieuwe bronparameter .

   

3. Selecteer Wijzigingen toepassen.

4. Gebruik de parameter Bron om de gegevensbron voor deze verbonden query te wijzigen.

Parameters voor kruisfilter

Een kruisfilter is een functie in een dashboard die u gebruikt om een waarde in één visual te selecteren en de gegevens in andere visuals op hetzelfde dashboard te filteren. Als u kruisfilters gebruikt, wordt hetzelfde resultaat bereikt als het selecteren van de equivalente waarde voor de parameter in de parameterlijst boven aan het dashboard.

Definieer kruisfilters

Als u een kruisfilter wilt maken, schakelt u de optie in de visual in en geeft u vervolgens de parameter op waarmee de gegevens worden gefilterd.

1. Ga naar de query van de tegel waaraan u kruislingse filters wilt toevoegen.

2. Selecteer Visual.

3. Selecteer Interacties in het rechterdeelvenster en schakel kruislingse filters in.

4. Geef desgewenst het type interactie op. De standaardwaarde is Punt waar u een waarde in de visual selecteert. Als u een reeks waarden wilt selecteren, zoals in een tijdsgrafiek, selecteert u Sleep.

5. Geef zowel de kolom op die de waarde als een parameter opgeeft waarmee de query van de visuals wordt gefilterd.

   Belangrijk

   De kolom en parameter moeten van hetzelfde gegevenstype zijn.

Communiceer met uw gegevens via kruisfilters

Nadat u het kruisfilter hebt gedefinieerd, gebruikt u het om te communiceren met uw gegevens. In visuals waarin u kruislingse filters definieert, selecteert u gegevenspunten en gebruikt u de bijbehorende waarden om de huidige dashboardpagina te filteren. Voor tabelvisuals klikt u met de rechtermuisknop op de relevante cel en selecteert u Kruislings filteren.

U kunt het kruisfilter opnieuw instellen door boven aan de visual waarin u het hebt geselecteerd Resetten te selecteren.

Drillthroughs gebruiken als dashboardparameters

Met Drillthroughs kunt u een waarde in een visual selecteren en deze gebruiken om visuals op een doelpagina in hetzelfde dashboard te filteren. Wanneer de doelpagina wordt geopend, wordt de waarde vooraf geselecteerd in de relevante filters. In de visuals op de pagina, zoals lijn- of spreidingsdiagrammen, worden alleen gerelateerde gegevens weergegeven. Deze functie is handig als u wilt inzoomen vanaf een overzichtspagina naar een detailpagina. Zie Pagina toevoegen voor meer informatie over het maken van pagina's.

Een drillthrough definiëren

Als u een drillthrough wilt maken, schakelt u de optie in de visual in en geeft u vervolgens een of meer drillthrough-parameters op waarmee de gegevens worden gefilterd.

1. Voer op de primaire pagina de bewerkingsmodus in.

2. Bewerk de visual waaraan u een drillthrough wilt toevoegen. Zorg ervoor dat het tabblad Visual is geselecteerd.

   

3. Selecteer Interacties in het rechterdeelvenster en schakel drillthrough in.

   

4. Selecteer nieuwe maken onder Drillthrough en geef de volgende informatie op. Selecteer desgewenst Nog een paar toevoegen om meerdere parameters toe te voegen voor een doelpagina. Herhaal deze stap om drillthroughs toe te voegen aan andere pagina's in het huidige dashboard met behulp van verschillende parameters.

   Veld	Beschrijving
   Doelpagina	Een of meer doelpagina's waarop u wilt inzoomen met behulp van de gedefinieerde parameters.
   Kolom	De kolom van het queryresultaat die moet worden gebruikt als de waarde voor een parameter op de doelpagina.
   Kenmerk	De parameter die wordt gebruikt om visuals op de doelpagina te filteren met behulp van de kolomwaarde.
   Opmerkingen	Optionele korte beschrijving.

   Belangrijk

   Kolom- en parameterparen moeten van hetzelfde gegevenstype zijn.

   

Interactie met uw gegevens met behulp van drillthroughs

Nadat u drillthroughs hebt gedefinieerd, kunt u deze gebruiken om met uw gegevens te werken. In visuals of in tabellen waarin u doordrillen hebt gedefinieerd, klikt u met de rechtermuisknop op een gegevenspunt en selecteert u Doordrillen naar>de doelpagina. De waarden uit het gegevenspunt filteren de visualisaties op de doelpagina.

Filterzoekopdrachten gebruiken voor filters met één selectie en filters met meerdere selecties

Typ in filters met één selectie en meerdere selecties de gewenste waarde. Het filter wordt bijgewerkt om alleen waarden weer te geven die overeenkomen met de zoekterm.

Gerelateerde inhoud

• Gegevens visualiseren met realtime dashboards
• Visuals van realtime dashboards aanpassen