Parameter verwenden

Ein Parameter dient als Möglichkeit zum einfachen Speichern und Verwalten eines Werts, der wiederverwendet werden kann.

Parameter bieten Ihnen die Flexibilität, die Ausgabe Ihrer Abfragen je nach Wert dynamisch zu ändern und kann für Folgendes verwendet werden:

• Ändern der Argumentwerte für bestimmte Transformationen und Datenquellenfunktionen.
• Eingaben in benutzerdefinierten Funktionen.

Sie können Ihre Parameter ganz einfach im Fenster " Parameter verwalten" verwalten. Um zum Fenster "Parameter verwalten" zu gelangen, wählen Sie die Option "Parameter verwalten" in der Registerkarte "Start" aus.

Erstellen eines Parameters

Power Query bietet zwei einfache Möglichkeiten zum Erstellen von Parametern:

• Klicken Sie in einer vorhandenen Abfrage mit der rechten Maustaste auf eine Abfrage, deren Wert eine einfache nicht strukturierte Konstante ist, z. B. ein Datum, text oder eine Zahl, und wählen Sie dann "In Parameter konvertieren" aus.

  

  Sie können einen Parameter auch in eine Abfrage konvertieren, indem Sie mit der rechten Maustaste auf den Parameter klicken und dann "In Abfrage konvertieren" auswählen.

  

• Verwenden des Fensters "Parameter verwalten": Wählen Sie die Option "Neuer Parameter " im Dropdownmenü " Parameter verwalten " auf der Registerkarte " Start " aus. Oder starten Sie das Fenster "Parameter verwalten" , und wählen Sie oben " Neu " aus, um einen Parameter zu erstellen. Füllen Sie dieses Formular aus, und wählen Sie dann "OK " aus, um einen neuen Parameter zu erstellen.

  

Nachdem Sie den Parameter erstellt haben, können Sie jederzeit zum Fenster " Parameter verwalten " zurückkehren, um die Parameter jederzeit zu ändern.

Parametereigenschaften

Ein Parameter speichert einen Wert, der für Transformationen in Power Query verwendet werden kann. Neben dem Namen des Parameters und dem zu speichernden Wert verfügt er auch über andere Eigenschaften, die Metadaten bereitstellen. Die Eigenschaften eines Parameters sind:

• Name: Geben Sie einen Namen für diesen Parameter an, mit dem Sie ihn leicht erkennen und von anderen Parametern unterscheiden können, die Sie möglicherweise erstellen.

• Beschreibung: Die Beschreibung wird neben dem Parameternamen angezeigt, wenn Parameterinformationen angezeigt werden, und hilft Benutzern, die den Parameterwert angeben, um den Zweck und die Semantik zu verstehen.

• Erforderlich: Das Kontrollkästchen gibt an, ob nachfolgende Benutzer angeben können, ob ein Wert für den Parameter angegeben werden muss.

• Typ: Gibt den Datentyp des Parameters an. Es wird empfohlen, immer den Datentyp Ihres Parameters einzurichten. Weitere Informationen zur Wichtigkeit von Datentypen finden Sie unter "Datentypen".

• Vorgeschlagene Werte: Bietet dem Benutzer Vorschläge zum Auswählen eines Werts für den aktuellen Wert aus den verfügbaren Optionen:

  • Jeder Wert: Der aktuelle Wert kann ein beliebiger manuell eingegebener Wert sein.

  • Liste der Werte: Bietet Ihnen eine einfache tabellenähnliche Oberfläche, damit Sie eine Liste der vorgeschlagenen Werte definieren können, aus denen Sie später für den aktuellen Wert auswählen können. Wenn diese Option ausgewählt ist, wird eine neue Option namens "Standardwert " verfügbar gemacht. Von hier aus können Sie auswählen, was der Standardwert für diesen Parameter sein soll. Dabei handelt es sich um den Standardwert, der dem Benutzer beim Verweisen auf den Parameter angezeigt wird. Dieser Wert entspricht nicht dem aktuellen Wert, der im Parameter gespeichert ist und als Argument in Transformationen übergeben werden kann. Die Verwendung der Liste der Werte stellt ein Dropdownmenü bereit, das in den Feldern "Standardwert " und " Aktueller Wert " angezeigt wird, in dem Sie einen der Werte aus der vorgeschlagenen Liste der Werte auswählen können.

    

    Hinweis

    Sie können weiterhin manuell einen beliebigen Wert eingeben, den Sie an den Parameter übergeben möchten. Die Liste der vorgeschlagenen Werte dient nur als einfache Vorschläge.

  • Abfrage: Verwendet eine Listenabfrage (eine Abfrage, deren Ausgabe eine Liste ist), um die Liste der vorgeschlagenen Werte bereitzustellen, die Sie später für den aktuellen Wert auswählen können.

    

• Aktueller Wert: Der in diesem Parameter gespeicherte Wert.

Anwendungsbereiche für Parameter

Ein Parameter kann auf viele verschiedene Arten verwendet werden, wird jedoch in zwei Szenarien häufiger verwendet:

• Schrittargument: Sie können einen Parameter als Argument mehrerer Transformationen verwenden, die von der Benutzeroberfläche (UI) gesteuert werden.
• Benutzerdefiniertes Funktionsargument: Sie können eine neue Funktion aus einer Abfrage und Referenzparametern als Argumente der benutzerdefinierten Funktion erstellen.

Die nächsten Abschnitte enthalten Beispiele für diese beiden Szenarien.

Schritt-Argument

Um dieses Feature zu aktivieren, wechseln Sie zuerst zur Registerkarte "Ansicht " im Power Query-Editor, und wählen Sie die Option "Immer zulassen " in der Gruppe "Parameter " aus.

Die folgende Tabelle "Orders " enthält beispielsweise die Felder "OrderID", "Total Units" und " Margin" .

Erstellen Sie in diesem Beispiel einen neuen Parameter mit dem Namen "Minimum Margin " mit einem Typ "Dezimalzahl " und einem aktuellen Wert von 0,2.

Wechseln Sie zur Orders-Abfrage, und wählen Sie im Feld Marge die Filteroption Größer als aus.

Im Fenster " Zeilen filtern " gibt es eine Schaltfläche mit einem Datentyp für das ausgewählte Feld. Wählen Sie im Dropdownmenü für diese Schaltfläche die Option "Parameter " aus. Wählen Sie in der Feldauswahl rechts neben der Schaltfläche für den Datentyp den Parameter aus, den Sie an dieses Argument übergeben möchten. In diesem Fall ist dies der Parameter "Minimum Margin ".

Nachdem Sie "OK" ausgewählt haben, wird die Tabelle mithilfe des aktuellen Werts für den Parameter gefiltert.

Wenn Sie den aktuellen Wert des Parameters "Minimum Margin " auf 0,3 ändern, wird die Auftragsabfrage sofort aktualisiert und zeigt nur die Zeilen an, in denen der Rand über 30%liegt.

Tipp

Mit vielen Transformationen in Power Query können Sie Ihren Parameter aus einer Dropdownliste auswählen. Es wird empfohlen, immer danach zu suchen und zu nutzen, was Parameter Ihnen bieten können.

Argument 'Benutzerdefinierte Funktion'

Mit Power Query können Sie eine benutzerdefinierte Funktion aus einer vorhandenen Abfrage mit einer einfachen Auswahl erstellen. Klicken Sie im vorherigen Beispiel mit der rechten Maustaste auf die Orders-Abfrage , und wählen Sie "Funktion erstellen" aus. Diese Aktion startet ein neues Fenster " Funktion erstellen ". Benennen Sie in diesem Fenster Ihre neue Funktion, und sie teilt Ihnen mit, auf welche Parameter in Ihrer Abfrage verwiesen wird. Diese Parameter werden als Parameter für die benutzerdefinierte Funktion verwendet.

Sie können diese neue Funktion wie gewünscht benennen. Zu Demonstrationszwecken lautet der Name dieser neuen Funktion "MyFunction". Nachdem Sie "OK" ausgewählt haben, wird im Bereich "Abfragen " eine neue Gruppe mit dem Namen ihrer neuen Funktion erstellt. In dieser Gruppe finden Sie die Parameter, die für die Funktion verwendet werden, die Abfrage, die zum Erstellen der Funktion und die Funktion selbst verwendet wurde.

Um diese neue Funktion zu testen, geben Sie einen Wert ein, z. B. 0,4, in das Feld unter der Bezeichnung "Mindestrand ". Wählen Sie dann die Schaltfläche "Aufrufen" aus . Diese Aktion erstellt eine neue Abfrage mit dem Namen Invoked Function und übergibt effektiv den Wert 0,4, der als Argument für die Funktion verwendet werden soll, und gibt Ihnen nur die Zeilen, in denen der Rand über 40%liegt.

Weitere Informationen zum Erstellen benutzerdefinierter Funktionen finden Sie unter Erstellen einer benutzerdefinierten Funktion.

Mehrfachwert- oder Listenparameter

Ein neuer Parametertyp, der nur in Power Query Online verfügbar ist, ist mehrwertige oder Listenparameter. In diesem Abschnitt wird beschrieben, wie Sie einen neuen Listenparameter erstellen und in Ihren Abfragen verwenden.

Ändern Sie nach dem vorherigen Beispiel den aktuellen Wert für den minimalen Rand von 0,3 auf 0,1. Das neue Ziel besteht darin, einen Listenparameter zu erstellen, der die Bestellnummern der Bestellungen enthalten kann, die Sie analysieren möchten. Um den neuen Parameter zu erstellen, wechseln Sie zum Dialogfeld "Parameter verwalten ", und wählen Sie "Neu " aus, um einen neuen Parameter zu erstellen. Geben Sie diesen neuen Parameter mit den folgenden Informationen ein:

• Name: Interessante Bestellungen
• Beschreibung: Eine Reihe von Bestellnummern, die für eine bestimmte Analyse interessant sind
• Erforderlich: STIMMT
• Art: Liste

Nachdem Sie diese Felder definiert haben, wird ein neues Raster angezeigt, in dem Sie die Werte eingeben können, die Sie für den Parameter speichern möchten. In diesem Fall sind diese Werte 125, 777 und 999.

Hinweis

Obwohl in diesem Beispiel Zahlen verwendet werden, können Sie auch andere Datentypen in Ihrer Liste speichern, z. B. Text, Datumsangaben, Zeitangaben und andere. Weitere Informationen: Datentypen in Power Query

Tipp

Wenn Sie mehr Kontrolle darüber haben möchten, welche Werte in Ihrem Listenparameter verwendet werden, können Sie immer eine Liste mit Konstantenwerten erstellen. Konvertieren Sie dann Ihre Listenabfrage in einen Parameter, wie zuvor in diesem Artikel gezeigt.

Wenn die neuen Parameter für die Liste "Interessante Bestellungen " vorhanden sind, kehren Sie zur Abfrage "Bestellungen " zurück. Wählen Sie das Menü "AutoFilter" des Felds "OrderID " aus. Wählen Sie Zahlenfilter>aus.

Tipp

Bei einigen anderen Datentypen wird der In-Filter möglicherweise nicht im Hauptfiltermenü angezeigt. Wählen Sie eine beliebige andere Filteroption aus, und bearbeiten Sie dann den Filter unter den Abfrageeinstellungen. Wählen Sie dann in der Filterdropdownliste im Editor "In" aus.

Nachdem Sie diese Option ausgewählt haben, wird ein neues Dialogfeld " Filterzeilen " angezeigt. Von hier aus können Sie den Listenparameter aus einem Dropdownmenü auswählen.

Hinweis

Listenparameter können entweder mit den Optionen "In" oder "Nicht in" verwendet werden. In können Sie nur nach den Werten aus Ihrer Liste filtern. Nicht in tut genau das Gegenteil und versucht, Ihre Spalte zu filtern, um alle Werte zu erhalten, die nicht den Werten entsprechen, die in Ihrem Parameter gespeichert sind.

Nachdem Sie "OK" ausgewählt haben, gelangen Sie zurück zu Ihrer Abfrage. Dort wird Die Abfrage mithilfe des von Ihnen erstellten Listenparameters gefiltert, wobei nur die Zeilen, in denen die OrderID gleich 125, 777 oder 999 war, beibehalten wurden.