Erstellen und verwalten Sie Real-Time Dashboard-Parameter

Parameter sind die Bausteine für Filter in Real-Time Dashboards. Erstellen und verwalten Sie Parameter auf Dashboard-Ebene, um die Filterwerte zu steuern, die Dashboard-Abfragen verwenden können.

Hinweis

Sie können Parameter nur im Bearbeitungsmodus für Dashboard-Editoren verwalten.

Voraussetzungen

Hinweis

Bei Verwendung der Identität des Dashboard-Editors werden parameterisierte Abfragen nur für Azure Data Explorer (ADX) und Fabric Eventhouse Datenquellen unterstützt. Weitere Informationen zur Konfiguration des Datenquellenzugriffs finden Sie unter Konfigurieren der Identität des Dashboard-Editors für ein Real-Time Dashboard.

Sehen Sie sich die Parameterliste an

Um die Liste aller Dashboard-Parameter anzuzeigen, wählen Sie Verwalten>Parameter aus.

Erstellen eines Parameters

Zum Erstellen eines Parameters:

  1. Wählen Sie im oberen Menü die Schaltfläche "Neuer Parameter " aus. Der Bereich Parameter wird geöffnet.
  2. Wählen Sie am oberen Rand des rechten Bereichs +Hinzufügen aus.
  3. Füllen Sie die relevanten Eigenschaften für Ihren Parameter aus.
  4. Wählen Sie Fertig aus, um den Parameter zu erstellen.

Parametereigenschaften konfigurieren

Konfigurieren Sie im Bereich Parameter hinzufügen die folgenden Eigenschaften.

Feld Description
Etikett Der Name des Parameters, der auf dem Dashboard oder auf der Bearbeitungskarte angezeigt wird.
Parametertyp Einer der folgenden Parametertypen:
- Einzelne Auswahl: Benutzer wählen einen Wert im Filter aus.
- Mehrfachauswahl: Benutzer wählen einen oder mehrere Werte im Filter aus.
- Zeitspanne: Fügt zeitbasierte Parameter zu Filterabfragen und Dashboards hinzu. Jedes Dashboard enthält standardmäßig eine Zeitbereichsauswahl.
- Freier Text: Benutzer geben einen Wert ein oder fügen ihn in den Filter ein. Der Filter behält die zuletzt verwendeten Werte bei.
- Datenquelle: Benutzer wählen eine oder mehrere Dashboard-Datenquellen aus.
Beschreibung Optionale Beschreibung des Parameters.
Variablenname Der Parametername, den Sie in der Abfrage verwenden.
Datentyp Der Datentyp des Parameterwerts.
Auf Seiten anzeigen Die Seiten, auf denen dieser Parameter angezeigt wird. Alles auswählen zeigt den Parameter auf allen Seiten an.
Source Die Quelle der Parameterwerte:
- Feste Werte: Statische Filterwerte wurden manuell eingegeben.
- Abfrage: Werte, die von einer KQL-Abfrage zurückgegeben werden.
Wert "Alle auswählen" hinzufügen Gilt nur für Parameter vom Typ Einfachauswahl und Mehrfachauswahl. Verwenden Sie diese Option, um Daten für alle Parameterwerte abzurufen. Erstellen Sie die Unterstützung für diese Option in der Abfrage. Ein Beispiel finden Sie unter Verwenden eines abfragebasierten Mehrfachauswahlparameters.
Standardwert Der Wert, den der Filter beim ersten Rendern des Dashboards verwendet.

Kaskadierende Parameter erstellen

Kaskadierende Parameter erzeugen eine Eltern-Kind-Beziehung zwischen Dashboard-Filtern. Der fragebasierte Kindparameter verwendet die Auswahl des übergeordneten Parameters, um seine verfügbaren Werte zu bestimmen. In diesem Beispiel ist der festwertige Ereignistyp-Parameter () der Elternteil und_eventType der fragebasierte Zustandsparameter (_state) das Kind.

  1. Erstelle den Elternparameter mit folgenden Eigenschaften:

    • Beschriftung: Ereignistyp

    • Parametertyp: Mehrfachauswahl

    • Variablenname: _eventType

    • Datentyp: String

    • Quelle: Feste Werte

    • Werte:

      Wert Anzeigename des Parameters
      Gewitterwind Gewitterwind
      Hagel Hagel
      Überschwemmung Überschwemmung
      Dürre Dürre
      Winterwetter Winterwetter
    • Standardwert: Gewitterwind

  2. Erstelle den Kindparameter mit folgenden Eigenschaften:

    • Etikett: Status
    • Parametertyp: Einzelauswahl
    • Variablenname: _state
    • Datentyp: String
    • Quelle: Abfrage
    • Datenquelle: StormEventsSample
  3. Geben Sie in der Bearbeitungsanfrage die folgende Wertanfrage ein und wählen Sie dann Fertig:

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

    Diese Abfrage liefert bis zu fünf Zustandswerte , weil sie verwendet top 5. Es filtert die Werte nach den ausgewählten Ereignistyp-Werten . Wenn du "Alle auswählen " für den übergeordneten Parameter aktivierst, isempty(_eventType) wendet diese Auswahl an.

  4. Setzen Sie Wert und Anzeigenamen auf Zustand, wählen Sie einen Standardwert aus und wählen Sie dann Fertig.

  5. Im Abfrageeditor des Visuals geben Sie folgende Abfrage ein, um beide Parameter zu verwenden:

    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
    

    Die Wertanfrage filtert die verfügbaren Zustandswerte nach Ereignistyp. Die visuelle Abfrage filtert dann die visuelle Auswahl sowohl nach Ereignistyp als auch nach Zustandsauswahl .

Parameter verwalten

Nachdem Sie " Parameter" auf der oberen Leiste ausgewählt haben, können Sie die Liste der vorhandenen Parameter anzeigen. Wählen Sie in jeder Parameterkarte das Bearbeitungssymbol aus, um den Parameter zu ändern, oder wählen Sie "Mehr " [...] aus, um ihn zu duplizieren, zu löschen oder zu verschieben.

Sie können die folgenden Indikatoren auf der Parameterkarte anzeigen:

  • Anzeigename des Parameters.
  • Variablenname.
  • Anzahl der Abfragen, die den Parameter verwenden.
  • Seiten, auf denen der Parameter angezeigt wird.

Ordne die Parameterkarten neu an, indem du sie ziehst und ablegst oder indem du Move to >auswählst.

Screenshot von Beispiel-Parameterkarten.