Parameter mit mehreren Werten

Ein Mehrwertparameter ermöglicht es dem Benutzer, einen oder mehrere beliebige Textwerte festzulegen. Parameter mit mehreren Werten werden häufig für die Filterung verwendet, so z. B. wenn ein Dropdownsteuerelement zu viele Werte enthält, um nützlich zu sein.

Erstellen eines statischen Parameters mit mehreren Werten

  1. Beginnen Sie mit einer leeren Arbeitsmappe im Bearbeitungsmodus.

  2. Wählen Sie Parameter hinzufügen>Parameter hinzufügen aus.

  3. Geben Sie in das sich öffnende neue Parameterfenster ein:

    • Name des Parameters: Filter
    • Typ des Parameters: Multi-value
    • Erforderlich: unchecked
    • Daten abrufen aus: None
  4. Wählen Sie Speichern aus, um den Parameter zu erstellen.

  5. Der Parameter Filter ist ein Parameter mit mehreren Werten, zunächst ohne Werte.

    Screenshot, der die Erstellung eines Parameters mit mehreren Werten in einer Arbeitsmappe zeigt.

  6. Sie können dann mehrere Werte hinzufügen.

    Screenshot, der die Hinzufügung eines dritten Werts in eine Arbeitsmappe zeigt.

Ein Parameter mit mehreren Werten verhält sich ähnlich wie ein Dropdownparameter mit mehreren Auswahlmöglichkeiten und wird häufig in einem „in“ ähnlichen Szenario verwendet.

    let computerFilter = dynamic([{Computer}]);
    Heartbeat
    | where array_length(computerFilter) == 0 or Computer in (computerFilter)
    | summarize Heartbeats = count() by Computer
    | order by Heartbeats desc

Stil für Parameterfeld

Der Parameter mit mehreren Werten unterstützt folgende Feldstile:

  1. Standard: ermöglicht Ihnen, beliebige Textelemente hinzuzufügen oder zu entfernen

    Screenshot, der das Standardfeld mit mehreren Werten in der Arbeitsmappe zeigt.

  2. Kennwort: ermöglicht Ihnen, beliebige Kennwortfelder hinzuzufügen oder zu entfernen. Die Kennwortwerte werden auf der Benutzeroberfläche nur bei der Eingabe ausgeblendet. Die Werte sind als Parameterwert weiterhin vollständig zugänglich, wenn auf sie verwiesen wird. Beim Speichern der Arbeitsmappe werden sie unverschlüsselt gespeichert.

    Screenshot, der ein Kennwortfeld mit mehreren Werten in einer Arbeitsmappe zeigt.

Erstellen eines Parameters mit mehreren Werten mit Ausgangswerten

Sie können eine Abfrage verwenden, um den Mehrwertparameter mit anfänglichen Werten zurückzusetzen. Sie können dann Werte manuell entfernen oder weitere Werte hinzufügen. Wenn eine Abfrage verwendet wird, um den Parameter mit mehreren Werten aufzufüllen, wird die Schaltfläche „Standardwerte wiederherstellen“ auf dem Parameter angezeigt, um die ursprünglich abgefragten Werte wiederherzustellen.

  1. Beginnen Sie mit einer leeren Arbeitsmappe im Bearbeitungsmodus.

  2. Wählen Sie Parameter hinzufügen>Parameter hinzufügen aus.

  3. Geben Sie in das sich öffnende neue Parameterfenster ein:

    • Name des Parameters: Filter
    • Typ des Parameters: Multi-value
    • Erforderlich: unchecked
    • Daten abrufen aus: JSON
  4. Fügen Sie im Textblock der JSON-Eingabe diesen JSON-Schnipsel ein:

    ["apple", "banana", "carrot" ]
    

    Alle Elemente, die das Ergebnis der Abfrage bilden, werden als Elemente mit mehreren Werten angezeigt. Sie sind nicht auf JSON beschränkt. Sie können jeden Abfrageanbieter verwenden, um die Ausgangswerte bereitzustellen, was jedoch auf die ersten 100 Ergebnisse begrenzt ist.

  5. Wählen Sie Run Query (Abfrage ausführen) aus.

  6. Wählen Sie Speichern aus, um den Parameter zu erstellen.

  7. Der Parameter Filter ist ein Parameter mit mehreren Werten mit drei Ausgangswerten.

    Screenshot, der die Erstellung eines dynamischen Dropdownparameters in einer Arbeitsmappe zeigt.

Nächste Schritte