Bruk av parametere

En parameter fungerer som en måte å enkelt lagre og administrere en verdi som kan gjenbrukes.

Parametere gir deg fleksibilitet til dynamisk å endre utdataene fra spørringene dine avhengig av verdien deres, og kan brukes til:

• Endring av argumentverdiene for bestemte transformasjoner og datakildefunksjoner.
• Innganger i egendefinerte funksjoner.

Du kan enkelt administrere parameterne dine inne i Administrer parametere-vinduet . For å komme til vinduet Administrer parametere , velg alternativet Administrer parametere i Administrer parametere i Hjem-fanen .

Opprettelse av en parameter

Power Query tilbyr to enkle måter å lage parametere på:

• Fra en eksisterende spørring: Høyreklikk på en spørring hvis verdi er en enkel ustrukturert konstant, som en dato, tekst eller tall, og velg deretter Konverter til parameter.

  

  Du kan også konvertere en parameter til en spørring ved å høyreklikke på parameteren og deretter velge Konverter til spørring.

  

• Bruk vinduet Administrer parametere: Velg alternativet Ny parameter fra nedtrekksmenyen for Administrer parametere i Hjem-fanen . Eller åpne vinduet Administrer parametere og velg Ny øverst for å lage en parameter. Fyll ut dette skjemaet, og velg deretter OK for å opprette en ny parameter.

  

Etter at du har opprettet parameteren, kan du alltid gå tilbake til Administrer parametere-vinduet for å endre noen av parameterne dine når som helst.

Parameteregenskaper

En parameter lagrer en verdi som kan brukes til transformasjoner i Power Query. Bortsett fra navnet på parameteren og verdien den lagrer, har den også andre egenskaper som gir metadata til den. Egenskapene til en parameter er:

• Navn: Gi et navn til denne parameteren som lar deg enkelt gjenkjenne og skille den fra andre parametere du måtte opprette.

• Beskrivelse: Beskrivelsen vises ved siden av parameternavnet når parameterinformasjon vises, noe som hjelper brukere som spesifiserer parameterverdien med å forstå formålet og semantikken.

• Påkrevd: Avkrysningsboksen indikerer om påfølgende brukere kan spesifisere om en verdi for parameteren må oppgis.

• Type: Spesifiserer datatypen til parameteren. Vi anbefaler at du alltid setter opp datatypen til parameteren din. For å lære mer om viktigheten av datatyper, gå til Datatyper.

• Foreslåtte verdier: Gir brukeren forslag til å velge en verdi for den nåværende verdien fra de tilgjengelige alternativene:

  • Enhver verdi: Den nåværende verdien kan være en hvilken som helst manuelt inntastet verdi.

  • Liste over verdier: Gir deg en enkel tabelllignende opplevelse slik at du kan definere en liste med foreslåtte verdier som du senere kan velge fra for Nåværende verdi. Når dette valget velges, blir et nytt alternativ kalt Default Value tilgjengelig. Herfra kan du velge hva som skal være standardverdien for denne parameteren, som er standardverdien som vises til brukeren når parameteren refereres. Denne verdien er ikke den samme som Current Value, som er verdien lagret inne i parameteren og kan sendes som et argument i transformasjoner. Ved å bruke listen over verdier vises en nedtrekksmeny i feltene Standardverdi og Nåværende verdi , hvor du kan velge en av verdiene fra den foreslåtte listen over verdier.

    

    Note

    Du kan fortsatt manuelt skrive inn hvilken som helst verdi du vil sende til parameteren. Listen over foreslåtte verdier fungerer kun som enkle forslag.

  • Spørring: Bruker en listespørring (en spørring hvis utdata er en liste) for å gi listen over foreslåtte verdier som du senere kan velge for Nåværende verdi.

    

• Nåværende verdi: Verdien som lagres i denne parameteren.

Hvor parametere skal brukes

En parameter kan brukes på mange forskjellige måter, men brukes oftere i to scenarioer:

• Stegargument: Du kan bruke en parameter som argumentet for flere transformasjoner drevet av brukergrensesnittet (UI).
• Argument for egendefinert funksjon: Du kan lage en ny funksjon fra en spørring og referere til parametere som argumentene til din egendefinerte funksjon.

De neste seksjonene inneholder eksempler for disse to scenarioene.

Trinnargumentet

For å aktivere denne funksjonen, gå først til fanen Vis i Power Query-editoren og velg Always tillat-alternativet i parametergruppen .

For eksempel inneholder følgende Order-tabell feltene OrderID, Total Units og Margin .

I dette eksempelet opprettes en ny parameter med navnet Minimum Margin med desimaltype og en nåværende verdi på 0,2.

Gå til Ordre-spørringen , og velg i Margin-feltet filteralternativet Større enn .

I Filterrader-vinduet finnes det en knapp med en datatype for det valgte feltet. Velg Parameter-alternativet fra nedtrekksmenyen for denne knappen. Fra feltvalget rett ved siden av datatypeknappen, velg parameteren du vil sende til dette argumentet. I dette tilfellet er det minimumsmarginparameteren .

Etter at du har valgt OK, filtreres tabellen din ved å bruke Current Value for parameteren din.

Hvis du endrer Current Value for Minimum Margin-parameteren til 0,3, oppdateres ordrespørringen din umiddelbart og viser deg kun radene hvor marginen er over 30%.

Tips

Mange transformasjoner i Power Query lar deg velge parameteren din fra en nedtrekksmeny. Vi anbefaler at du alltid ser etter det og benytter deg av det parameterne kan tilby deg.

Argumentet om egendefinert funksjon

Med Power Query kan du lage en egendefinert funksjon fra en eksisterende spørring med et enkelt valg. Etter forrige eksempel, høyreklikk på Orders-spørringen og velg Create Function. Denne handlingen åpner et nytt Opprett funksjon-vindu . I dette vinduet navngir du den nye funksjonen din, og den forteller deg hvilke parametere som refereres til i spørringen din. Disse parameterne brukes som parametere for den tilpassede funksjonen.

Du kan kalle denne nye funksjonen akkurat som du vil. For demonstrasjonsformål heter denne nye funksjonen MyFunction. Etter at du har valgt OK, opprettes en ny gruppe i Spørringspanelet med navnet på den nye funksjonen din. I denne gruppen finner du parameterne som brukes for funksjonen, spørringen som ble brukt til å lage funksjonen, og selve funksjonen.

For å teste denne nye funksjonen, skriv inn en verdi, for eksempel 0,4, i feltet under Minimum Margin-etiketten . Deretter velger du Aktiver-knappen . Denne handlingen oppretter en ny spørring med navnet Invoked Function, og sender effektivt verdien 0,4 som brukes som argument for funksjonen og gir deg kun radene hvor marginen er over 40%.

For å lære mer om hvordan du lager tilpassede funksjoner, gå til Å lage en egendefinert funksjon.

Flerverdi- eller listeparametere

En ny type parameter som kun er tilgjengelig i Power Query Online, er multi-verdi- eller listeparametere. Denne delen beskriver hvordan du oppretter en ny listeparameter og hvordan du bruker den i spørringene dine.

I tråd med forrige eksempel, endre gjeldende verdi for minimumsmargin fra 0,3 til 0,1. Det nye målet er å lage en listeparameter som kan holde ordrenumrene til ordenene du er interessert i å analysere. For å opprette den nye parameteren, gå til dialogen Administrer parametere og velg Ny for å opprette en ny parameter. Fyll inn denne nye parameteren med følgende informasjon:

• Navn: Interessante ordener
• Beskrivelse: Et sett med ordenstall som er interessante for en spesifikk analyse
• Påkrevd: Sann
• Type: Liste

Etter at du har definert disse feltene, dukker det opp et nytt rutenett hvor du kan legge inn verdiene du vil lagre for parameteren din. I dette tilfellet er verdiene 125, 777 og 999.

Note

Selv om dette eksempelet bruker tall, kan du også lagre andre datatyper i listen din, som tekst, datoer, dato og mer. Mer informasjon: Datatyper i Power Query

Tips

Hvis du vil ha mer kontroll over hvilke verdier som brukes i listeparameteren din, kan du alltid lage en liste med konstante verdier. Konverter deretter listespørringen din til en parameter som tidligere vist i denne artikkelen.

Med de nye parameterne for Interessante Ordre-listen på plass, gå tilbake til Ordre-forespørselen . Velg autofiltermenyen i OrderID-feltet . Velg antall filtre>inn.

Tips

For noen av de andre datatypene kan Inn-filteret ikke vises i hovedfiltermenyen. Velg et annet filteralternativ og rediger deretter filteret under Spørringsinnstillinger. Deretter velger du In, fra filternedtrekksmenyen i editoren.

Etter at du har valgt dette alternativet, dukker det opp en ny dialogboks for Filterrader . Herfra kan du velge listeparameteren fra en nedtrekksmeny.

Note

Listeparametere kan fungere med enten In- eller Not In-alternativene . I lar deg filtrere kun etter verdiene fra listen din. Not in gjør akkurat det motsatte, og prøver å filtrere kolonnen din for å få alle verdier som ikke er like de som er lagret i parameteren din.

Etter å ha valgt OK, blir du ført tilbake til forespørselen din. Der filtreres spørringen din ved hjelp av listeparameteren du opprettet, med det resultat at kun radene hvor OrderID-en var lik enten 125, 777 eller 999 ble beholdt.