Parameters gebruiken in realtime dashboards
Parameters worden gebruikt als bouwstenen voor filters in realtime dashboards. Ze worden beheerd in het dashboardbereik en kunnen worden toegevoegd aan query's om de gegevens te filteren die door de onderliggende visual worden gepresenteerd. Een query kan een of meer parameters gebruiken.
In dit document wordt het maken en gebruiken van parameters en gekoppelde filters in dashboards beschreven. Parameters kunnen worden gebruikt om dashboardvisuals te 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.
Notitie
Parameterbeheer is beschikbaar in de bewerkingsmodus voor dashboardeditors.
Vereisten
- Een werkruimte met een Capaciteit met Microsoft Fabric
- Editormachtigingen voor een realtime dashboard
- Een dashboard met visuals
Lijst met parameters weergeven
Als u de lijst met alle dashboardparameters wilt weergeven, selecteert u Parameters beheren>.
Een parameter maken
Een parameter maken:
- Selecteer de knop Nieuwe parameters in het bovenste menu. Het deelvenster Parameters wordt geopend.
- Selecteer de knop + Toevoegen boven aan het rechterdeelvenster.
- Vul de relevante eigenschappen voor uw parameter in.
- Selecteer Gereed om de parameter te maken.
Eigenschappen
Configureer in het deelvenster Parameter toevoegen de volgende eigenschappen.
| Veld | Beschrijving |
|---|---|
| Label | De naam van de parameter die wordt weergegeven op het dashboard of de bewerkingskaart. |
| Parametertype | Een van de volgende parameters: - Eén selectie: er kan slechts één waarde in het filter worden geselecteerd als invoer voor de parameter. - Meerdere selectie: een of meer waarden kunnen in het filter worden geselecteerd als invoer voor de parameter. - Tijdsbereik: hiermee kunt u aanvullende parameters maken om de query's en dashboards te filteren op basis van tijd. Elk dashboard heeft standaard een tijdsbereikkiezer. - Vrije tekst: er zijn geen waarden ingevuld in het filter. De gebruiker kan een waarde typen of een waarde kopiëren/plakken in het tekstveld. Het filter bewaart de recente waarden die worden gebruikt. |
| Beschrijving | Optionele beschrijving van de parameter. |
| Variabelenaam | De naam van de parameter die moet worden gebruikt in de query. |
| Gegevenstype | Het gegevenstype van de parameterwaarden. |
| Weergeven op pagina's | Selecteer de pagina's waarop deze parameter wordt weergegeven. Met de optie Alles selecteren wordt de parameter op alle pagina's weergegeven. |
| Bron | De bron van de parameterwaarden: - Vaste waarden: er zijn handmatig statische filterwaarden geïntroduceerd. - Query: Dynamisch waarden geïntroduceerd met behulp van een KQL-query. |
| Waarde 'Alles selecteren' toevoegen | Alleen van toepassing op één selectie en meerdere selectieparametertypen. Wordt gebruikt om gegevens op te halen voor alle parameterwaarden. Deze waarde moet worden ingebouwd in de query om de functionaliteit te bieden. Zie De parameter op basis van meerdere selectiequery's gebruiken voor meer voorbeelden over het bouwen van dergelijke query's. |
| Standaardwaarde | De standaardwaarde van het filter. Het filter begint altijd met de standaardwaarde bij de eerste weergave van het dashboard. |
Parameters beheren
Nadat u Parameters hebt geselecteerd in de bovenste balk, kunt u de lijst met bestaande parameters bekijken. In elke parameterkaart kunt u de potloodwidget selecteren om de parameter te bewerken, of het menu Meer [...] selecteren om de parameter te dupliceren, verwijderen of verplaatsen.
De volgende indicatoren kunnen worden weergegeven in de parameterkaart:
- Weergavenaam van parameter
- Variabelenamen
- Aantal query's waarin de parameter is gebruikt
- Pagina's waaraan de parameter is vastgemaakt
U kunt de volgorde van de parameterkaarten wijzigen door slepen en neerzetten of door de optie Verplaatsen naar te > gebruiken.
Parameters gebruiken in uw query
Een parameter moet worden gebruikt in de query om het filter van toepassing te maken voor die queryvisual. Zodra u de parameters hebt gedefinieerd, ziet u de parameters in de bovenste balk van het querypaginafilter > en in de query-intellisense.
Notitie
Als de parameter niet wordt gebruikt in de query, blijft het filter inactief. Zodra de parameter is toegevoegd aan de query, wordt het filter actief.
Parametertypen
Verschillende typen dashboardparameters worden als volgt ondersteund:
- 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 heeft standaard een tijdsbereikparameter . Het wordt alleen weergegeven op het dashboard als filter wanneer deze wordt gebruikt in een query. Gebruik de parametertrefwoorden _startTime en _endTime gebruik de standaardtijdbereikparameter in een query, zoals te zien is in het volgende voorbeeld:
StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents
Zodra het tijdsbereik is opgeslagen, wordt het tijdsbereikfilter weergegeven op het dashboard. Deze kan nu worden gebruikt om de gegevens op de kaart te filteren. U kunt uw dashboard filteren door een selectie te maken in de vervolgkeuzelijst: Tijdsbereik (laatste x minuten/uren/dagen) of een aangepast tijdsbereik.
Parameters met één selectie met vaste waarden
Parameters voor vaste waarden zijn gebaseerd op vooraf gedefinieerde waarden die door de gebruiker zijn opgegeven. 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
Selecteer Parameters om het deelvenster Parameters te openen en selecteer Nieuwe parameter.
Vul de details als volgt in:
Label: Gebeurtenistype
Parametertype: Enkele selectie
Variabelenaam:
_eventTypeGegevenstype: tekenreeks
Vastmaken als dashboardfilter: ingeschakeld
Bron: Vaste waarden
In dit voorbeeld gebruikt u de volgende waarden:
Weergegeven als Weergavenaam van parameter Onweer Wind Onweer wind Hagel Hagel Stortvloed Stortvloed Droogte Droogte Winterweer Winterweer Een waarde alles selecteren toevoegen: Uitgeschakeld
Standaardwaarde: Thunderstorm Wind
Selecteer Gereed om de parameter te maken.
De parameter kan worden weergegeven in het zijvenster Parameters , maar wordt momenteel niet gebruikt in visuals.
Een parameter met één selectie met vaste waarden gebruiken
Voer een voorbeeldquery uit met behulp van de nieuwe parameter Gebeurtenistype met behulp van de naam van de
_eventTypevariabele:StormEvents | where StartTime between (_startTime.._endTime) | where EventType == _eventType | summarize TotalEvents = count() by State | top 5 by TotalEventsDe nieuwe parameter wordt boven aan het dashboard weergegeven in de lijst met parameters.
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 door de gebruiker zijn opgegeven. 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
Selecteer Parameters om het deelvenster Parameters te openen en selecteer Nieuwe parameter.
Vul de details in zoals vermeld in Een parameter met één selectie met vaste waarden gebruiken met de volgende wijzigingen:
- Label: Gebeurtenistype
- Parametertype: Meerdere selectie
- Variabelenaam:
_eventType
Selecteer Gereed om de parameter te maken.
De nieuwe parameters kunnen worden weergegeven in het zijvenster Parameters , maar worden momenteel niet gebruikt in visuals.
Een parameter met meerdere selecties met vaste waarden gebruiken
Voer een voorbeeldquery uit met behulp van de nieuwe parameter Gebeurtenistype met behulp van de
_eventTypevariabele.StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | summarize TotalEvents = count() by State | top 5 by TotalEventsDe nieuwe parameter wordt boven aan het dashboard weergegeven in de lijst met parameters.
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 op query's gebaseerde parameter voor één selectie maken
Selecteer Parameters om het deelvenster Parameters te openen en selecteer Nieuwe parameter.
Vul de details in zoals vermeld in Een parameter met één selectie met vaste waarden gebruiken met de volgende wijzigingen:
Label: status
Variabelenaam:
_stateBron: Query
Gegevensbron: StormEventsSample
Selecteer Query bewerken en voer de volgende query in. Selecteer Gereed.
StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | summarize TotalEvents = count() by State | top 5 by TotalEvents | project StateWaarde: Status
Weergavenaam: Status
Standaardwaarde: Een standaardwaarde kiezen
Selecteer Gereed om de parameter te maken.
Een op query's gebaseerde parameter met één selectie gebruiken
De volgende voorbeeldquery met de nieuwe parameter State maakt gebruik van de
_statevariabele:StormEvents | where StartTime between (_startTime.._endTime) | where EventType in (_eventType) or isempty(_eventType) | where State == _state | summarize TotalEvents = count() by State | top 5 by TotalEventsDe nieuwe parameter wordt boven aan het dashboard weergegeven in de lijst met parameters.
Selecteer verschillende waarden om de visuals bij te werken.
Parameters op basis van meerdere selectiequery's
Parameterwaarden op basis van query's worden tijdens de laadtijd van het dashboard afgeleid door de door de gebruiker opgegeven query uit te voeren. In het volgende voorbeeld ziet u hoe u een op meerdere selectiequery's gebaseerde parameter kunt maken:
Een parameter op basis van meerdere selectiequery's maken
Selecteer Parameters om het deelvenster Parameters te openen en selecteer + Nieuwe parameter.
Vul de details in zoals vermeld in Een parameter met één selectie met vaste waarden gebruiken met de volgende wijzigingen:
- Label: status
- Parametertype: Meerdere selectie
- Variabelenaam:
_state
Selecteer Gereed om de parameter te maken.
Een op query's gebaseerde parameter met meerdere selecties gebruiken
In de volgende voorbeeldquery wordt de nieuwe statusparameter gebruikt met behulp van de
_statevariabele.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 TotalEventsNotitie
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.
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
- Selecteer Parameters om het deelvenster Parameters te openen en selecteer + Nieuwe parameter.
- Vul de details als volgt in:
- Label: status
- Parametertype: Vrije tekst
- Variabelenaam: _state
- Gegevenstype: tekenreeks
- Standaardwaarde: geen standaardwaarde
Een gratis tekstparameter gebruiken
Voer een voorbeeldquery uit met behulp van de nieuwe parameter State met behulp van de naam van de
_statevariabele: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
Zodra u gegevensbronnen aan uw dashboard hebt toegevoegd, kunt u een parameter maken waarmee een of meer van de beschikbare gegevensbronnen worden geselecteerd. Deze parameter kan worden gebruikt in tegels en andere parameters.
Een gegevensbronparameter maken
Selecteer Parameters om het deelvenster Parameters te openen en selecteer + Nieuwe parameter.
Vul de details als volgt in:
- Label: Bron
- Parametertype: Gegevensbron
- Weergeven op pagina's: Alles selecteren
- Waarden: Alles selecteren
- Standaardwaarde: StormEvents
Selecteer Gereed.
De nieuwe parameter is nu zichtbaar in de lijst met parameters boven aan het dashboard.
Een gegevensbronparameter gebruiken
Navigeer naar de query van een nieuwe of bestaande tegel.
Selecteer in Bron de naam van de nieuwe parameter onder Gegevensbronparameters, zoals de nieuwe bronparameter .
Selecteer Wijzigingen toepassen.
Gebruik de parameter Bron om de gegevensbron voor deze verbonden query te wijzigen.
Parameters voor kruislings filteren
Een kruislings filteren is een functie in een dashboard waarmee u een waarde in de ene visual kunt selecteren en de gegevens in andere visuals op hetzelfde dashboard kunt 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.
Kruisfilters definiëren
Als u een kruislings filter wilt maken, moet u de optie in de visual inschakelen en vervolgens de parameter opgeven die wordt gebruikt om de gegevens te filteren.
Navigeer naar de query van de tegel waaraan u kruislingse filters wilt toevoegen.
Selecteer Visual.
Selecteer Interacties in het rechterdeelvenster en schakel kruislingse filters in.
Geef desgewenst het type interactie op. De standaardwaarde is Punt waar u een waarde in de visual kunt selecteren. Als u een bereik met waarden wilt selecteren, zoals in een tijddiagram, selecteert u Slepen.
Geef zowel de kolom op die wordt gebruikt om de waarde op te geven als een parameter die wordt gebruikt om de query van de visuals te filteren.
Belangrijk
De kolom en parameter moeten van hetzelfde gegevenstype zijn.
Interactie met uw gegevens met behulp van kruislings filteren
Zodra het kruisfilter is gedefinieerd, kunt u het gebruiken om met uw gegevens te communiceren. In visuals waarin u kruislingse filters hebt gedefinieerd, kunt u gegevenspunten selecteren en hun waarden gebruiken om de huidige dashboardpagina te filteren. Voor tabelvisuals selecteert u gegevenspunten door met de rechtermuisknop op de relevante cel te klikken en vervolgens in het contextmenu kruislings filteren te selecteren.
U kunt het kruisfilter opnieuw instellen door Boven aan de visual opnieuw instellen te selecteren waar het is geselecteerd.
Drillthroughs gebruiken als dashboardparameters
Met Drillthroughs kunt u een waarde in een visual selecteren en deze gebruiken om de visuals op een doelpagina in hetzelfde dashboard te filteren. Wanneer de doelpagina wordt geopend, wordt de waarde vooraf geselecteerd in de relevante filters. De visuals op de pagina, zoals lijn- of spreidingsdiagrammen, worden gefilterd om alleen gerelateerde gegevens weer te geven. Deze functie is handig voor het maken van dashboards met drillthroughs van 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, moet u de optie in de visual inschakelen en vervolgens een of meer drillthrough-parameters opgeven die worden gebruikt om de gegevens te filteren.
Voer op de primaire pagina de bewerkingsmodus in.
Bewerk de visual waaraan u een drillthrough wilt toevoegen. Zorg ervoor dat het tabblad Visual is geselecteerd.
Selecteer Interacties in het rechterdeelvenster en schakel drillthrough in.
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 om in te zoomen op het gebruik van de gedefinieerde parameters. Kolom De kolom van het queryresultaat die moet worden gebruikt als de waarde voor een parameter op de doelpagina. Parameter De parameter die wordt gebruikt voor het filteren van visuals op de doelpagina 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
Zodra drillthroughs zijn gedefinieerd, kunt u deze gebruiken om met uw gegevens te communiceren. Hiervoor klikt u in visuals of tabellen waarin u een drillthrough hebt gedefinieerd met de rechtermuisknop op een gegevenspunt en selecteert u Drillthrough naar>doelpagina. De waarden van het gegevenspunt worden gebruikt als parameters om de visuals op de doelpagina te filteren.
Filterzoekopdrachten gebruiken voor filters met één en meerdere selectiefilters
Typ in één en meerdere selectiefilters de gewenste waarde. Het filter wordt bijgewerkt om alleen de waarden weer te geven die overeenkomen met de zoekterm.