Používanie parametrov

Parameter slúži ako spôsob, ako ľahko uložiť a spravovať hodnotu, ktorú je možné opätovne použiť.

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

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

Parametre môžete jednoducho spravovať v okne Správa parametrov. Do okna Spravovať parametre sa môžete dostať výberom možnosti Spravovať parametre v časti Spravovať parametre na karte Domov.

Spravovať okno Parametre.

Vytvorenie parametra

Power Query poskytuje dva jednoduché spôsoby vytvárania parametrov:

  • Z existujúceho dotazu — Môžete jednoducho kliknúť pravým tlačidlom myši na dotaz, ktorého hodnota je jednoduchá neštruktúrovaná konštanta, ako je napríklad dátum, text alebo číslo, a vybrať položku Konvertovať na parameter.

    Konvertovať na parameter.

    Poznámka

    Parameter môžete skonvertovať aj kliknutím pravým tlačidlom myši na parameter a výberom položky Konvertovať na dotaz, ako je znázornené na nasledujúcom obrázku.

    Konvertovať na dotaz.

  • Používanie okna — Spravovať parametre V rozbaľovacej ponuke Spravovať parametre na karte Domov môžete vybrať možnosť Nový parameter alebo môžete spustiť okno Spravovať parametre a vybrať v tlačidle Nové v hornej časti a vytvoriť parameter. Tento formulár môžete vyplniť a vybrať tlačidlo OK na vytvorenie nového parametra.

    Vytvorte parameter z okna Spravovať parametre.

Po vytvorení parametra sa môžete kedykoľvek vrátiť do okna Spravovať parametre a kedykoľvek upraviť niektorý z vašich 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á aj ďalšie vlastnosti, ktoré ho poskytujú metaúdaje. Vlastnosti parametra sú nasledovné.

  • Názov — Zadajte názov tohto parametra, ktorý vám umožní ľahko rozpoznať a odlíšiť ho od iných parametrov, ktoré by ste mohli vytvoriť.

  • Popis — Popis sa zobrazí vedľa názvu parametra pri zobrazení informácií o parametroch, čo pomáha používateľom, ktorí určujú hodnotu parametra, pochopiť jeho účel a sémantiku.

  • Vyžaduje sa — Začiarkavacie políčko označuje, či môžu následní používatelia určiť, či sa musí poskytnúť hodnota parametra.

  • Typ — Odporúčame vám, aby ste vždy nastavili typ údajov vášho parametra. Ďalšie informácie o dôležitosti typov údajov nájdete v článku Typy údajov.

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

    • Akákoľvek hodnota — Aktuálnou hodnotou môže byť ľubovoľná manuálne zadaná hodnota.

    • Zoznam hodnôt — Poskytuje jednoduché prostredie podobné tabuľke, aby ste mohli definovať zoznam navrhovaných hodnôt, z ktoré 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. Odtiaľ môžete vybrať, aká by mala byť predvolená hodnota pre tento parameter, čo bude predvolená hodnota zobrazená používateľovi pri odkazovaní na parameter. Táto hodnota nie je rovnaká ako aktuálna hodnota, čo je hodnota, ktorá je uložená vo vnútri parametra a môže byť odovzdaná ako argument v transformáciách. Pomocou zoznamu hodnôt sa v poliach Predvolená hodnota a Aktuálna hodnota zobrazí rozbaľovacia ponuka, kde môžete vybrať jednu z hodnôt z navrhovaného zoznamu hodnôt.

      Parameter s navrhovaným zoznamom hodnôt.

      Poznámka

      Stále môžete manuálne zadať ľubovoľnú hodnotu, ktorú chcete odovzdať parametru. 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.

      Parameter so dotazom zoznamu.

  • Aktuálna hodnota — Hodnota, ktorá bude uložená v tomto parametri.

Kde používať parametre

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

  • Argument — Krok 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 parametrov dotazu a odkazu ako argumenty vlastnej funkcie.

V nasledujúcich častiach sa zobrazí príklad pre tieto dva scenáre.

Argument Krok

Ak chcete povoliť túto funkciu, najprv prejdite na kartu Zobraziť v editore power query a povoľte možnosť Vždy povoliť v skupine Parametre.

Vždy povoliť parametre.

Poznámka

Táto funkcia momentálne nie je k dispozícii v doplnku Power Query Online.

Na účely sa napríklad zobrazuje nasledujúci dotaz objednávok s poľami OrderID, Jednotky a Marža.

Vzorová tabuľka pre objednávky s maržou.

Môžete vytvoriť nový parameter s názvom Minimálne okraje s typom desatinného čísla a aktuálnou hodnotou 0,2, ako je znázornené na nasledujúcom obrázku.

Vzorový parameter.

Môžete prejsť na dotaz Objednávky a v poli Marža vyberte možnosť Filter Väčší ako.

Väčšia ako možnosť filtra pre pole Okraj.

V okne Filtrovať riadky sa zobrazí tlačidlo s typom údajov pre vybraté pole. V rozbaľovacej ponuke pre toto tlačidlo môžete vybrať možnosť Parameter. Z výberu poľa hneď vedľa tlačidla typ údajov môžete vybrať parameter, ktorý chcete preniesť do tohto argumentu. V tomto prípade je to parameter minimálnej marže.

Vyberte parameter pre argument transformácie.

Po výbere možnosti OK sa zobrazí, že tabuľka bola filtrovaná pomocou aktuálnej hodnoty parametra.

Vzorový parameter použitý ako argument transformácie.

Ak upravíte aktuálnu hodnotu parametra minimálnej marže na 0,3, môžete okamžite zistiť, ako sa dotaz objednávok aktualizuje a zobrazia sa iba riadky, v ktorých je marža vyššia ako 30%.

Aktualizovaná aktuálna hodnota parametra.

Tip

Viaceré transformácie v doplnku Power Query ponúkajú toto prostredie, kde môžete vybrať parameter z rozbaľovacieho limitu. Preto odporúčame, aby ste ho vždy hľadali a využili, aké parametre vám môžu ponúknuť.

Argument vlastnej funkcie

Pomocou doplnku Power Query môžete vytvoriť vlastnú funkciu z existujúceho dotazu jednoduchým kliknutím. Podľa predchádzajúceho príkladu môžete kliknúť pravým tlačidlom myši na dotaz Objednávky a vybrať položku Vytvoriť funkciu, ktorá spustí nové okno Vytvoriť funkciu. V tomto okne môžete pomenovať svoju novú funkciu a povie vám parametre, na ktoré sa odkazuje v dotaze. Tieto parametre sa použijú ako parametre pre vlastnú funkciu.

Vytvoriť funkciu.

Túto novú funkciu môžete pomenovať akokoľvek chcete. Na demonštračné účely bude názov tejto novej funkcie MyFunction. Po výbere možnosti OK sa na table Dotazy vytvorí nová skupina s názvom novej funkcie. V tejto skupine nájdete parametre používané pre funkciu, dotaz, ktorý sa použil na vytvorenie funkcie, a samotnú funkciu.

Vytvorená funkcia.

Túto novú funkciu môžete otestovať zadaním hodnoty, napríklad 0,4, do poľa pod označením Minimálna marža. Potom vyberte tlačidlo Vyvolať. Tým sa vytvorí nový dotaz s názvom Vyvolaná funkcia, čím sa účinne odovzdá hodnota 0,4, ktorá sa má použiť ako argument pre funkciu, a poskytne sa iba riadky, v ktorých je okraj vyšší ako 40%.

Vyvolaná funkcia s hodnotou 0,4.

Ďalšie informácie o vytváraní vlastných funkcií nájdete v článku Vytvorenie vlastnej funkcie.