Freigeben über


Optionsgruppenparameter

Wenn Sie einen Optionsgruppenparameter verwenden, können Sie einen Wert aus einem bekannten Satz auswählen. Sie können beispielsweise eine der Anforderungen Ihrer App auswählen. Wenn Sie mit einigen Werten arbeiten, kann eine Optionsgruppe eine bessere Wahl als ein Dropdown-Parameter sein. Sie können alle möglichen Werte sehen, und Sie sehen, welcher ausgewählt ist.

Optionengruppen werden häufig für Auswahlmöglichkeiten der Form „Ja/Nein“ oder „Ein/Aus“ verwendet. Wenn es eine große Anzahl möglicher Werte gibt, ist eine Dropdownliste die bessere Wahl. Im Gegensatz zu Dropdown-Parametern erlaubt eine Optionsgruppe immer nur die Auswahl eines Werts.

Sie können die Liste wie folgt angeben:

  • Angeben einer statischen Liste in der Parametereinstellung.
  • Verwenden einer KQL-Abfrage zum dynamischen Abrufen der Liste.

Erstellen eines statischen Optionsgruppenparameters

  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: Environment
    • Typ des Parameters: Options Group
    • Erforderlich: checked
    • Daten abrufen aus: JSON
  4. Fügen Sie im Textblock der JSON-Eingabe diesen JSON-Codeausschnitt ein:

    [
        { "value":"dev", "label":"Development" },
        { "value":"ppe", "label":"Pre-production" },
        { "value":"prod", "label":"Production", "selected":true }
    ]
    

    Sie sind nicht auf JSON beschränkt. Sie können einen beliebigen Abfrageanbieter verwenden, um Anfangswerte bereitzustellen, aber Sie sind auf die ersten 100 Ergebnisse beschränkt.

  5. Wählen Sie Aktualisieren aus.

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

  7. Der Parameter Umgebung ist ein Optionsgruppen-Steuerelement mit den drei Werten.

    Der Screenshot zeigt die Erstellung einer statischen Optionsgruppe in einer Arbeitsmappe.

Nächste Schritte