Met behulp van parameters

Een parameter fungeert als een manier om eenvoudig een waarde op te slaan en te beheren die opnieuw kan worden gebruikt.

Parameters bieden u de flexibiliteit om de uitvoer van uw query's dynamisch te wijzigen, afhankelijk van hun waarde, en kunnen worden gebruikt voor:

  • De argumentwaarden voor bepaalde transformaties en gegevensbronfuncties wijzigen
  • Invoer in aangepaste functies

U kunt uw parameters eenvoudig beheren in het venster Parameters beheren. U kunt naar het venster Parameters beheren gaan door de optie Parameters beheren te selecteren in Parameters beheren op het tabblad Start.

Het venster Parameters beheren.

Een parameter maken

Power Query biedt twee eenvoudige manieren om parameters te maken:

  • Vanuit een bestaande query — U kunt eenvoudig met de rechtermuisknop op een query klikken waarvan de waarde een eenvoudige niet-gestructureerde constante is, zoals, maar niet beperkt tot, een datum, tekst of getal, en Converteren naar parameter selecteren.

    Converteren naar parameter.

    Notitie

    U kunt een parameter ook converteren naar een query door met de rechtermuisknop op de parameter te klikken en vervolgens Converteren naar query te selecteren, zoals wordt weergegeven in de volgende afbeelding.

    Converteren naar query.

  • Het venster Parameters beheren gebruiken — U kunt de optie Nieuwe parameter selecteren in de vervolgkeuzelijst van Parameters beheren op het tabblad Start of u kunt het venster Parameters beheren openen en in de knop Nieuw bovenaan selecteren om een parameter te maken. U kunt dit formulier invullen en OK selecteren om een nieuwe parameter te maken.

    Maak een parameter in het venster Parameters beheren.

Nadat u de parameter hebt gemaakt, kunt u altijd teruggaan naar het venster Parameters beheren om uw parameters op elk moment te wijzigen.

Parametereigenschappen

Een parameter slaat een waarde op die kan worden gebruikt voor transformaties in Power Query. Afgezien van de naam van de parameter en de waarde die wordt opgeslagen, heeft deze ook andere eigenschappen die er metagegevens aan leveren. De eigenschappen van een parameter zijn als volgt.

  • Naam — Geef een naam op voor deze parameter waarmee u deze gemakkelijk kunt herkennen en onderscheiden van andere parameters die u kunt maken.

  • Beschrijving — De beschrijving wordt weergegeven naast de parameternaam wanneer parametergegevens worden weergegeven, zodat gebruikers die de parameterwaarde opgeven, inzicht krijgen in het doel en de semantiek ervan.

  • Vereist — Het selectievakje geeft aan of volgende gebruikers kunnen opgeven of een waarde voor de parameter moet worden opgegeven.

  • Type — We raden u aan om altijd het gegevenstype van uw parameter in te stellen. Meer informatie over het belang van gegevenstypen vindt u in het artikel Gegevenstypen.

  • Voorgestelde waarden — Geeft de gebruiker suggesties om een waarde voor de huidige waarde te selecteren uit de beschikbare opties:

    • Elke waarde — De huidige waarde kan elke handmatig ingevoerde waarde zijn.

    • Lijst met waarden — Biedt u een eenvoudige tabel-achtige ervaring, zodat u een lijst met voorgestelde waarden kunt definiëren waar u later uit kunt kiezen voor de Huidige waarde. Wanneer deze optie is geselecteerd, wordt er een nieuwe optie met de naam Standaardwaarde beschikbaar gemaakt. Hier kunt u selecteren wat de standaardwaarde voor deze parameter moet zijn. Dit is de standaardwaarde die aan de gebruiker wordt weergegeven wanneer naar de parameter wordt verwezen. Deze waarde is niet hetzelfde als de huidige waarde . Dit is de waarde die is opgeslagen in de parameter en kan worden doorgegeven als een argument in transformaties. Met behulp van de lijst met waarden wordt een vervolgkeuzelijst weergegeven in de velden Standaardwaarde en Huidige waarde, waar u een van de waarden uit de voorgestelde lijst met waarden kunt kiezen.

      Parameter met een lijst met waarden voorstellen.

      Notitie

      U kunt nog steeds handmatig een waarde typen die u aan de parameter wilt doorgeven. De lijst met voorgestelde waarden fungeert alleen als eenvoudige suggesties.

    • Query uitvoeren — Maakt gebruik van een lijstquery (een query waarvan de uitvoer een lijst is) om de lijst met voorgestelde waarden op te geven die u later kunt selecteren voor de Huidige waarde.

      Parameter met lijstquery.

  • Huidige waarde — De waarde die wordt opgeslagen in deze parameter.

Waar kunt u parameters gebruiken?

Een parameter kan op veel verschillende manieren worden gebruikt, maar wordt vaker gebruikt in twee scenario's:

  • Stapargument — U kunt een parameter gebruiken als het argument van meerdere transformaties die worden aangestuurd vanuit de gebruikersinterface (UI).
  • Argument Aangepaste functie — U kunt een nieuwe functie maken op basis van een query en verwijzen naar parameters als de argumenten van uw aangepaste functie.

In de volgende secties ziet u een voorbeeld voor deze twee scenario's.

Argument stap

Als u deze functie wilt inschakelen, gaat u eerst naar het tabblad Weergave in Power Query Editor en schakel u de optie Altijd toestaan in de groep Parameters in.

Parameters altijd toestaan.

Notitie

Deze functie is momenteel niet beschikbaar in Power Query Online.

U kunt bijvoorbeeld de volgende Orders-query zien met de velden OrderID, Units en Margin.

Voorbeeldtabel voor Orders met marge.

U kunt een nieuwe parameter maken met de naam Minimummarge met het type Decimaal getal en de huidige waarde 0,2, zoals wordt weergegeven in de volgende afbeelding.

Voorbeeldparameter.

U kunt naar de query Orders gaan en in het veld Marge de filteroptie Groter dan selecteren.

De filteroptie Groter dan voor het veld Marge.

In het venster Rijen filteren ziet u een knop met een gegevenstype voor het geselecteerde veld. U kunt de optie Parameter selecteren in de vervolgkeuzelijst voor deze knop. In de veldselectie rechts naast de knop gegevenstype kunt u de parameter selecteren die u aan dit argument wilt doorgeven. In dit geval is dit de parameter Minimum margin.

Selecteer parameter voor transformatieargument.

Nadat u OK hebt geselecteerd, kunt u zien dat uw tabel is gefilterd met behulp van de huidige waarde voor uw parameter.

Voorbeeldparameter die wordt gebruikt als een transformatieargument.

Als u de huidige waarde van de parameter Minimummarge wijzigt in 0,3, kunt u onmiddellijk zien hoe uw ordersquery wordt bijgewerkt en ziet u alleen de rijen waarin de marge hoger is dan 30%.

Huidige waarde bijgewerkt voor parameter.

Tip

Meerdere transformaties in Power Query bieden deze ervaring waar u uw parameter kunt selecteren in een vervolgkeuzekeuze. Daarom raden we u aan deze altijd te zoeken en te profiteren van de parameters die u kunnen bieden.

Argument voor aangepaste functie

Met Power Query kunt u met een eenvoudige klik een aangepaste functie maken van een bestaande query. In het vorige voorbeeld kunt u met de rechtermuisknop op de query Orders klikken en Functie maken selecteren. Hiermee wordt een nieuw venster Functie maken geopend. In dit venster kunt u de nieuwe functie een naam geven en krijgt u te zien naar de parameters waarnaar wordt verwezen in uw query. Deze parameters worden gebruikt als parameters voor de aangepaste functie.

Functie maken.

U kunt deze nieuwe functie een naam geven zoals u wilt. Ter demonstratie is de naam van deze nieuwe functie MyFunction. Nadat u OK hebt geselecteerd, wordt er een nieuwe groep gemaakt in het deelvenster Query's met de naam van de nieuwe functie. In deze groep vindt u de parameters die worden gebruikt voor de functie, de query die is gebruikt om de functie te maken en de functie zelf.

Functie gemaakt.

U kunt deze nieuwe functie testen door een waarde, zoals 0,4, in te geven in het veld onder het label Minimale marge. Selecteer vervolgens de knop Aanroepen. Hiermee maakt u een nieuwe query met de naam Aangeroepen functie , waarbij de waarde 0,4 die moet worden gebruikt als argument voor de functie, wordt door gegeven en krijgt u alleen de rijen waar de marge hoger is dan 40%.

Aangeroepen functie met waarde 0.4.

Meer informatie over het maken van aangepaste functies vindt u in het artikel Een aangepaste functie maken.