Používanie parametrov

Parameter slúži ako spôsob, ako jednoducho ukladať a spravovať hodnotu, ktorú možno opätovne použiť.

Parametre vám poskytujú flexibilitu dynamickej zmeny výstupu dotazov v závislosti od ich hodnoty a môžu sa použiť na:

• Zmena hodnôt argumentu pre konkrétne transformácie a funkcie zdroja údajov.
• Vstupy vo vlastných funkciách.

Parametre môžete jednoducho spravovať v okne Spravovať parametre . Ak chcete prejsť do okna Spravovať parametre , vyberte možnosť Spravovať parametre v časti Spravovať parametre na karte Domov .

Vytvorenie parametra

Power Query poskytuje dva jednoduché spôsoby vytvorenia parametrov:

• Z existujúceho dotazu: kliknite pravým tlačidlom myši na dotaz, ktorého hodnota je jednoduchou neštrukturálnou konštantou, ako je napríklad dátum, text alebo číslo, a potom vyberte položku Konvertovať na parameter.

  

  Parameter môžete tiež previesť na dotaz kliknutím pravým tlačidlom myši na parameter a následne výberom položky Konvertovať na dotaz.

  

• Pomocou okna Spravovať parametre: v rozbaľovacej ponuke položky Spravovať parametre na karte Domov vyberte možnosť Nový parameter. Alebo spustite okno Spravovať parametre a v hornej časti vyberte položku Nové, čím vytvoríte parameter. Vyplňte tento formulár a potom výberom položky OK vytvorte nový parameter.

  

Po vytvorení parametra sa môžete kedykoľvek vrátiť do okna Spravovať parametre a upraviť ktorýkoľvek z parametrov.

Vlastnosti parametrov

Parameter ukladá hodnotu, ktorú možno použiť na transformácie v doplnku Power Query. Okrem názvu parametra a hodnoty, ktorú ukladá, má tiež ďalšie vlastnosti, ktoré doň poskytujú metaúdaje. Vlastnosti parametra sú:

• Názov: zadajte názov tohto parametra, ktorý vám umožní jednoducho ho rozpoznať a odlíšiť od iných parametrov, ktoré môžete vytvoriť.

• Popis: Popis sa zobrazuje vedľa názvu parametra pri zobrazení informácií o parametri, čo pomáha používateľom, ktorí špecifikujú hodnotu parametra, aby porozumeli jeho účelu a jeho sémantike.

• Povinné: Začiarkavacie políčko udáva, či následní používatelia môžu určiť, či má byť zadaná hodnota parametra.

• Typ: Určuje typ údajov parametra. Odporúčame, aby ste vždy nastavili typ údajov parametra. Ďalšie informácie o dôležitosti typov údajov nájdete v téme Typy údajov.

• Navrhované hodnoty: poskytne používateľovi návrhy na výber hodnoty aktuálnej hodnoty z dostupných možností:

  • Ľubovoľná hodnota: Aktuálnou hodnotou môže byť ľubovoľná manuálne zadaná hodnota.

  • Zoznam hodnôt: Poskytuje jednoduchú tabuľkovú skúsenosť, aby ste mohli definovať zoznam navrhovaných hodnôt, z ktoré si môžete neskôr vybrať pre aktuálnu hodnotu. Po výbere tejto možnosti sa sprístupní nová možnosť s názvom Predvolená hodnota . Tu môžete vybrať predvolenú hodnotu tohto parametra, ktorá je predvolenou hodnotou, ktorá sa používateľovi zobrazí pri odkazovaní na parameter. Táto hodnota nie je rovnaká ako aktuálna hodnota, čo je hodnota uložená vo vnútri parametra a môže sa odovzdať ako argument pri transformáciách. Pomocou zoznamu hodnôt sa zobrazí rozbaľovacia ponuka, ktorá sa zobrazuje v poliach Predvolená hodnota a Aktuálna hodnota, kde si môžete vybrať jednu z hodnôt z navrhovaného zoznamu hodnôt.

    

    Poznámka

    Stále môžete manuálne zadať ľubovoľnú hodnotu, ktorú chcete odovzdať do parametra. Zoznam navrhovaných hodnôt slúži len ako jednoduché návrhy.

  • Dotaz: Používa dotaz zoznamu (dotaz, ktorého výstupom je zoznam) na poskytnutie zoznamu navrhovaných hodnôt, ktoré môžete neskôr vybrať pre aktuálnu hodnotu.

    

• Aktuálna hodnota: hodnota, ktorá je uložená v tomto parametri.

Kde použiť parametre

Parameter možno použiť mnohými rôznymi spôsobmi, ale častejšie sa používa v dvoch scenároch:

• Argument kroku: Parameter môžete použiť ako argument viacerých transformácií riadených z používateľského rozhrania (UI).
• Argument Vlastná funkcia: Novú funkciu môžete vytvoriť z dotazu a odkazovať na parametre ako argumenty vlastnej funkcie.

V ďalších častiach si ukážeme príklad týchto dvoch scenárov.

Argument kroku

Ak chcete túto funkciu povoliť, najprv prejdite na kartu Zobraziť v editore Power Query a vyberte možnosť Vždy povoliť v skupine Parametre .

Napríklad nasledujúca tabuľka Objednávky obsahuje polia OrderID (ID Objednávky), Units (Jednotky) a Margin (Marža).

V tomto príklade vytvorte nový parameter s názvom Minimálny okraj s typom Desatinné číslo a aktuálnou hodnotou 0,2.

Prejdite na dotaz Orders (Objednávky ) a v poli Margin (Marža ) vyberte možnosť filtra Väčšie ako .

V okne Filtrovať riadky je k dispozícii tlačidlo s vybratým typom údajov pre pole. V rozbaľovacej ponuke tohto tlačidla vyberte možnosť Parameter . Z výberu poľa priamo vedľa tlačidla typ údajov vyberte parameter, ktorý chcete preniesť do tohto argumentu. V tomto prípade je to parameter Minimum Margin (Minimálny okraj ).

Po výbere tlačidla OK sa tabuľka vyfiltruje pomocou aktuálnej hodnoty parametra.

Ak upravíte parameter Minimálna marža na hodnotu 0,3, dotaz na objednávky sa okamžite aktualizuje a zobrazia sa len riadky, v ktorých je marža nad 30 %.

Prepitné

Mnohé transformácie v doplnku Power Query umožňujú vybrať parameter v rozbaľovacom zozname. Odporúčame vám, aby ste ju vždy vyhľadali a využili, aké parametre vám môžu ponúknuť.

Vlastný argument funkcie

Pomocou Power Query môžete pomocou jednoduchého kliknutia vytvoriť vlastnú funkciu z existujúceho dotazu. V nadväznosti na predchádzajúci príklad kliknite pravým tlačidlom myši na dotaz Orders (Objednávky ) a vyberte položku Create Function (Vytvoriť funkciu). Táto akcia spustí nové okno Vytvoriť funkciu . V tomto okne pomenujte svoju novú funkciu, ktorá vám povie parametre, na ktoré sa odkazuje v dotaze. Tieto parametre sa používajú ako parametre pre vlastnú funkciu.

Túto novú funkciu môžete pomenovať, ako chcete. Na účely demonštrácie je názov tejto novej funkcie MyFunction. Po výbere tlačidla OK sa na table Dotazy vytvorí nová skupina pomocou názvu novej funkcie. V tejto skupine nájdete parametre používané pre funkciu, dotaz použitý na vytvorenie funkcie a samotnú funkciu.

Ak chcete otestovať túto novú funkciu, zadajte hodnotu, napríklad 0,4, do poľa pod označením minimálneho okraja . Potom vyberte tlačidlo Vyvolať . Tým sa vytvorí nový dotaz s názvom Vyvolaná funkcia, ktorý efektívne odovzdá hodnotu 0,4, ktorá sa má použiť ako argument funkcie, a poskytne vám iba riadky, v ktorých je okraj nad 40 %.

Ďalšie informácie o vytváraní vlastných funkcií nájdete v téme Vytvorenie vlastnej funkcie.

Parametre s viacerými hodnotami alebo zoznamami

Nový typ parametra, ktorý je k dispozícii iba v doplnku Power Query Online, je parameter s viacerými hodnotami alebo zoznamom. Táto časť popisuje, ako vytvoriť nový parameter zoznamu a ako ho používať v dotazoch.

V nadväznosti na predchádzajúci príklad zmeňte aktuálnu hodnotu pre minimálnu maržu z 0,3 na 0,1. Novým cieľom je vytvoriť parameter zoznamu, ktorý môže obsahovať čísla objednávok, ktoré chcete analyzovať. Ak chcete vytvoriť nový parameter, prejdite do dialógového okna Spravovať parametre a výberom položky Nové vytvorte nový parameter. Do tohto nového parametra zadajte nasledujúce informácie:

• Názov: Zaujímavé objednávky
• Popis: Množina čísel objednávok, ktoré sú zaujímavé pre konkrétnu analýzu
• Povinné: True
• Typ: Zoznam

Po definovaní týchto polí sa objaví nová mriežka, kde môžete zadať hodnoty, ktoré chcete uložiť pre parameter. V tomto prípade sú tieto hodnoty 125, 777 a 999.

Poznámka

Hoci tento príklad používa čísla, do zoznamu môžete ukladať aj iné typy údajov, napríklad text, dátumy, dátumy a čas a ďalšie. Ďalšie informácie: Typy údajov v doplnku Power Query

Prepitné

Ak chcete mať väčšiu kontrolu nad hodnotami použitými v parametri zoznamu, môžete vždy vytvoriť zoznam s konštantnými hodnotami a konvertovať dotaz zoznamu na parameter, ako bolo uvedené vyššie v tomto článku.

S novými parametrami zoznamu zaujímavých objednávok prejdite späť na dotaz Orders (Objednávky ). Vyberte ponuku automatického filtrovania poľa OrderID . Vyberte položky Filtre čísel>v.

Po výbere tejto možnosti sa zobrazí nové dialógové okno Filtrovať riadky . Tu môžete vybrať parameter zoznamu z rozbaľovacej ponuky.

Poznámka

Parametre zoznamu môžu fungovať s možnosťami In alebo Not . Funkcia In umožňuje filtrovať iba podľa hodnôt z vášho zoznamu. Možnosť Nie je v presne naopak a pokúsi sa filtrovať stĺpec tak, aby získal všetky hodnoty, ktoré sa nerovná hodnotám uloženým v parametri.

Po výbere tlačidla OK sa vrátite späť k svojmu dotazu. Tam bol dotaz filtrovaný pomocou parametra zoznamu, ktorý ste vytvorili, s výsledkom je, že sa zachovali iba riadky, v ktorých sa hodnota OrderID rovnla 125, 777 alebo 999 .