Brug af parametre

En parameter fungerer som en måde nemt at lagre og administrere en værdi, der kan genbruges.

Parametre giver dig fleksibilitet til dynamisk at ændre outputtet af dine forespørgsler afhængigt af deres værdi, og kan bruges til:

• Ændring af argumentværdierne for bestemte transformationer og datakildefunktioner.
• Input i brugerdefinerede funktioner.

Du kan nemt administrere dine parametre inde i Manage Parameters-vinduet . For at komme til vinduet Administrer parametre , vælg muligheden Administrer parametre inde i Administrer parametre i fanen Hjem .

Oprettelse af en parameter

Power Query giver to nemme måder at oprette parametre på:

• Fra en eksisterende forespørgsel: Højreklik på en forespørgsel, hvis værdi er en simpel ustruktureret konstant, såsom en dato, tekst eller et tal, og vælg derefter Konverter til Parameter.

  

  Du kan også konvertere en parameter til en forespørgsel ved at højreklikke på parameteren og derefter vælge Konverter til forespørgsel.

  

• Brug af vinduet Administrer parametre: Vælg muligheden Ny Parameter i dropdown-menuen for Administrer parametre i fanen Hjem . Eller start vinduet Administrer parametre og vælg Ny øverst for at oprette en parameter. Udfyld denne formular, og vælg derefter OK for at oprette en ny parameter.

  

Når du har oprettet parameteren, kan du altid gå tilbage til vinduet Administrer parametre for at ændre en hvilken som helst af dine parametre når som helst.

Parameteregenskaber

En parameter gemmer en værdi, der kan bruges til transformationer i Power Query. Udover navnet på parameteren og den værdi, den gemmer, har den også andre egenskaber, der leverer metadata til den. Egenskaberne ved en parameter er:

• Navn: Giv et navn til denne parameter, der gør det nemt at genkende og skelne den fra andre parametre, du måtte oprette.

• Beskrivelse: Beskrivelsen vises ved siden af parameternavnet, når parameterinformation vises, hvilket hjælper brugere, der specificerer parameterværdien, med at forstå dens formål og dens semantik.

• Påkrævet: Afkrydsningsfeltet angiver, om efterfølgende brugere kan angive, om en værdi for parameteren skal angives.

• Type: Angiver datatypen for parameteren. Vi anbefaler, at du altid opsætter datatypen for din parameter. For at lære mere om vigtigheden af datatyper, gå til Datatyper.

• Foreslåede værdier: Giver brugeren forslag til at vælge en værdi for den aktuelle værdi fra de tilgængelige muligheder:

  • Enhver værdi: Den aktuelle værdi kan være en hvilken som helst manuelt indtastet værdi.

  • Liste over værdier: Giver dig en simpel tabel-lignende oplevelse, så du kan definere en liste over foreslåede værdier, som du senere kan vælge fra til den aktuelle værdi. Når denne mulighed vælges, bliver en ny mulighed kaldet Default Value tilgængelig. Herfra kan du vælge, hvad der skal være standardværdien for denne parameter, hvilket er standardværdien, der vises til brugeren, når parameteren refereres. Denne værdi er ikke den samme som Current Value, som er værdien lagret inde i parameteren og kan gives som et argument i transformationer. Brug af Listen over værdier giver en rullemenu, der vises i felterne Default Value og Current Value , hvor du kan vælge en af værdierne fra den foreslåede liste over værdier.

    

    Notat

    Du kan stadig manuelt indtaste enhver værdi, du vil sende til parameteren. Listen over foreslåede værdier fungerer kun som simple forslag.

  • Forespørgsel: Bruger en listeforespørgsel (en forespørgsel, hvis output er en liste) til at levere listen over foreslåede værdier, som du senere kan vælge til den aktuelle værdi.

    

• Nuværende værdi: Den værdi, der er gemt i denne parameter.

Hvor parametre skal bruges

En parameter kan bruges på mange forskellige måder, men bruges oftere i to scenarier:

• Trinargument: Du kan bruge en parameter som argumentet for flere transformationer drevet af brugergrænsefladen (UI).
• Brugerdefineret funktionsargument: Du kan oprette en ny funktion ud fra en forespørgsel og referere parametre som argumenter for din brugerdefinerede funktion.

De næste afsnit indeholder eksempler på disse to scenarier.

Step-argumentet

For at aktivere denne funktion skal du først gå til fanen Vis i Power Query-editoren og vælge muligheden Altid tillad i Parameters-gruppen .

For eksempel indeholder følgende Order-tabel felterne OrderID, Total Units og Margin .

I dette eksempel opret en ny parameter med navnet Minimum Margin med en decimaltype og en Current Value på 0,2.

Gå til forespørgslen Ordrer , og vælg i Margin-feltet filtermuligheden Større end .

I vinduet Filterrækker er der en knap med en datatype for det valgte felt. Vælg Parameter-muligheden i dropdown-menuen for denne knap. Fra feltvalget lige ved siden af datatypeknappen skal du vælge den parameter, du vil sende til dette argument. I dette tilfælde er det minimumsmargin-parameteren .

Efter du har valgt OK, filtreres din tabel ved hjælp af Current Value for din parameter.

Hvis du ændrer den aktuelle værdi af din minimumsmarginparameter til 0,3, opdateres din ordreforespørgsel straks og viser kun de rækker, hvor marginen er over 30%.

Tips

Mange transformationer i Power Query lader dig vælge din parameter fra en dropdown-menu. Vi anbefaler, at du altid leder efter det og udnytter, hvad parametrene kan tilbyde dig.

Argumentet om brugerdefineret funktion

Med Power Query kan du oprette en brugerdefineret funktion ud fra en eksisterende forespørgsel med en simpel valgmulighed. Efter det forrige eksempel højreklikker du på forespørgslen Ordrer og vælger Opret funktion. Denne handling åbner et nyt Opret Funktion-vindue . I dette vindue navngiver du din nye funktion, og den fortæller dig de parametre, der refereres til i din forespørgsel. Disse parametre bruges som parametre for den tilpassede funktion.

Du kan navngive denne nye funktion, som du vil. Til demonstrationsformål hedder denne nye funktion MyFunction. Efter du har valgt OK, oprettes en ny gruppe i Forespørgselspanelet med navnet på din nye funktion. I denne gruppe finder du parametrene, der bruges til funktionen, forespørgslen, der blev brugt til at oprette funktionen, og selve funktionen.

For at teste denne nye funktion indtast en værdi, såsom 0,4, i feltet under Minimum Margin-labelen . Vælg derefter knappen Invoke . Denne handling opretter en ny forespørgsel med navnet Invoked Function, hvilket effektivt sender værdien 0,4 til brug som argument for funktionen og kun giver dig de rækker, hvor marginen er over 40%.

For at lære mere om, hvordan du opretter brugerdefinerede funktioner, gå til Oprettelse af en brugerdefineret funktion.

Multi-værdi eller listeparametre

En ny type parameter, der kun findes i Power Query Online, er multi-værdi- eller listeparametre. Dette afsnit beskriver, hvordan man opretter en ny listeparameter og bruger den i dine forespørgsler.

Ifølge det tidligere eksempel ændres den aktuelle værdi for minimumsmargin fra 0,3 til 0,1. Det nye mål er at skabe en listeparameter, der kan indeholde ordrenumrene for de ordrer, du er interesseret i at analysere. For at oprette den nye parameter skal du gå til dialogen Administrer parametre og vælge Ny for at oprette en ny parameter. Udfyld denne nye parameter med følgende information:

• Navn: Interessante ordrer
• Beskrivelse: Et sæt ordenstal, der er interessante for en specifik analyse
• Kræves: Sand
• Slags: Liste

Efter du har defineret disse felter, dukker et nyt gitter op, hvor du kan indtaste de værdier, du vil gemme for din parameter. I dette tilfælde er disse værdier 125, 777 og 999.

Notat

Selvom dette eksempel bruger tal, kan du også gemme andre datatyper i din liste, såsom tekst, datoer, dato og mere. Flere oplysninger: Datatyper i Power Query

Tips

Hvis du vil have mere kontrol over, hvilke værdier der bruges i din listeparameter, kan du altid oprette en liste med konstante værdier. Konverter derefter din listeforespørgsel til en parameter, som tidligere vist i denne artikel.

Med de nye Interesting Orders-listeparametre på plads, gå tilbage til forespørgslen om Orders . Vælg autofiltermenuen i OrderID-feltet . Vælg Nummer filtrerer>ind.

Tips

For nogle af de andre datatyper kan In-filteret ikke vises i hovedfiltermenuen. Vælg en anden filtermulighed og rediger derefter filteret under Forespørgselsindstillinger. Derefter vælger du I, fra filter-dropdown-menuen i editoren.

Efter du har valgt denne mulighed, vises en ny Filter-række-dialogboks . Herfra kan du vælge listeparameteren fra en rullemenu.

Notat

Listeparametre kan fungere med enten In- eller Not-in-indstillingerne . I lader dig filtrere kun efter værdierne fra din liste. Not in gør præcis det modsatte og prøver at filtrere din kolonne for at få alle værdier, der ikke er lig med de værdier, der er gemt i din parameter.

Efter at have valgt OK, bliver du ført tilbage til din forespørgsel. Der filtreres din forespørgsel ved hjælp af den listeparameter, du har oprettet, med det resultat, at kun de rækker, hvor OrderID'et var lig med enten 125, 777 eller 999 , blev bevaret.