Použití parametrů
Parametr slouží jako způsob, jak snadno uložit a spravovat hodnotu, kterou lze znovu použít.
Parametry umožňují dynamicky měnit výstup dotazů v závislosti na jejich hodnotě a dají se použít pro:
- Změna hodnot argumentů pro konkrétní transformace a funkce zdroje dat
- Vstupy ve vlastních funkcích.
Parametry můžete snadno spravovat v okně Spravovat parametry . Do okna Spravovat parametry se dostanete tak, že na kartě Domů vyberete možnost Spravovat parametry na kartě Spravovat parametry.
Vytvoření parametru
Power Query poskytuje dva jednoduché způsoby vytváření parametrů:
Z existujícího dotazu: Klikněte pravým tlačítkem myši na dotaz, jehož hodnotou je jednoduchá nestrukturovaná konstanta, například datum, text nebo číslo, a pak vyberte Převést na parametr.
Parametr můžete také převést na dotaz tak, že na parametr kliknete pravým tlačítkem a pak vyberete Převést na dotaz.
Použití okna Spravovat parametry: V rozevírací nabídce Spravovat parametry na kartě Domů vyberte možnost Nový parametr. Nebo spusťte okno Spravovat parametry a v horní části vyberte Nový a vytvořte parametr. Vyplňte tento formulář a pak výběrem OK vytvořte nový parametr.
Po vytvoření parametru se můžete kdykoli vrátit do okna Spravovat parametry a upravit kterýkoli z parametrů.
Vlastnosti parametru
Parametr ukládá hodnotu, která se dá použít pro transformace v Power Query. Kromě názvu parametru a hodnoty, kterou ukládá, má také další vlastnosti, které mu poskytují metadata. Vlastnosti parametru jsou:
Název: Zadejte název tohoto parametru, který vám umožní snadno ho rozpoznat a odlišit od ostatních parametrů, které můžete vytvořit.
Popis: Při zobrazení informací o parametru se vedle názvu parametru zobrazí popis, který pomáhá uživatelům, kteří zadávají hodnotu parametru, porozumět jeho účelu a sémantice.
Povinné: Zaškrtávací políčko označuje, jestli další uživatelé můžou určit, jestli musí být zadána hodnota parametru.
Typ: Určuje datový typ parametru. Doporučujeme vždy nastavit datový typ parametru. Další informace o důležitosti datových typů najdete v tématu Datové typy.
Navrhované hodnoty: Poskytuje uživateli návrhy, jak vybrat hodnotu aktuální hodnoty z dostupných možností:
Libovolná hodnota: Aktuální hodnota může být libovolná ručně zadaná hodnota.
Seznam hodnot: Poskytuje jednoduché prostředí podobné tabulce, abyste mohli definovat seznam navrhovaných hodnot, ze kterého můžete později vybrat aktuální hodnotu. Když vyberete tuto možnost, zpřístupní se nová možnost s názvem Výchozí hodnota . Tady můžete vybrat výchozí hodnotu tohoto parametru, což je výchozí hodnota, která se uživateli zobrazí při odkazování na parametr. Tato hodnota není stejná jako Aktuální hodnota, což je hodnota, která je uložená v parametru a dá se předat jako argument v transformacích. Pomocí seznamu hodnot získáte rozevírací nabídku, která se zobrazí v polích Výchozí hodnota a Aktuální hodnota , kde můžete vybrat jednu z hodnot z navrhovaného seznamu hodnot.
Poznámka
Přesto můžete ručně zadat libovolnou hodnotu, kterou chcete předat parametru. Seznam navrhovaných hodnot slouží jenom jako jednoduché návrhy.
Dotaz: Používá dotaz seznamu (dotaz, jehož výstupem je seznam) k poskytnutí seznamu navrhovaných hodnot, které můžete později vybrat pro aktuální hodnotu.
Aktuální hodnota: Hodnota, která je uložená v tomto parametru.
Kde použít parametry
Parametr se dá použít mnoha různými způsoby, ale častěji se používá ve dvou scénářích:
- Argument kroku: Parametr můžete použít jako argument více transformací řízených z uživatelského rozhraní.
- Argument vlastní funkce: Novou funkci můžete vytvořit z dotazu a odkazovat na parametry jako argumenty vlastní funkce.
V dalších částech uvidíte příklad pro tyto dva scénáře.
Argument kroku
Pokud chcete tuto funkci povolit, přejděte nejprve na kartu Zobrazení v editoru Power Query a vyberte možnost Vždy povolit ve skupině Parametry.
Například následující tabulka Orders (Objednávky) obsahuje pole OrderID (ID objednávky), Units (Jednotky) a Margin (Okraj).
V tomto příkladu vytvořte nový parametr s názvem Minimální okraj s typem Desetinné číslo a aktuální hodnotou 0,2.
Přejděte do dotazu Orders (Objednávky) a v poli Margin (Okraj ) vyberte možnost Větší než filtr.
V okně Filtrovat řádky je tlačítko s datovým typem vybraného pole. V rozevírací nabídce tohoto tlačítka vyberte možnost Parametr . Z výběru pole vpravo vedle tlačítka datového typu vyberte parametr, který chcete předat tomuto argumentu. V tomto případě je to parametr Minimální marže .
Jakmile vyberete OK, tabulka se vyfiltruje pomocí aktuální hodnoty parametru.
Pokud upravíte aktuální hodnotu parametru Minimální marže na 0,3, dotaz objednávky se okamžitě aktualizuje a zobrazí pouze řádky, ve kterých je margin vyšší než 30 %.
Tip
Mnoho transformací v Power Query umožňuje vybrat parametr z rozevíracího seznamu. Doporučujeme, abyste ho vždy hledali a využili toho, jaké parametry vám můžou nabídnout.
Argument vlastní funkce
Pomocí Power Query můžete vytvořit vlastní funkci z existujícího dotazu jednoduchým kliknutím. Podle předchozího příkladu klikněte pravým tlačítkem na dotaz Orders a vyberte Vytvořit funkci. Tato akce spustí nové okno Vytvořit funkci . V tomto okně pojmenujte novou funkci a řekne vám parametry, na které se odkazuje v dotazu. Tyto parametry se používají jako parametry pro vlastní funkci.
Tuto novou funkci můžete pojmenovat podle potřeby. Pro demonstrační účely je název této nové funkce MyFunction. Jakmile vyberete OK, vytvoří se v podokně Dotazy nová skupina s názvem nové funkce. V této skupině najdete parametry používané pro funkci, dotaz použitý k vytvoření funkce a samotnou funkci.
Pokud chcete otestovat tuto novou funkci, zadejte do pole pod popiskem Minimální okraj hodnotu, například 0,4. Pak vyberte tlačítko Vyvolat . Tím se vytvoří nový dotaz s názvem Vyvolaná funkce, která ve skutečnosti předá hodnotu 0,4, která se použije jako argument pro funkci, a poskytne vám pouze řádky, ve kterých je okraj vyšší než 40 %.
Další informace o vytváření vlastních funkcí najdete v tématu Vytvoření vlastní funkce.
Parametry s více hodnotami nebo seznamem
Nový typ parametru, který je k dispozici pouze v Power Query Online, jsou parametry s více hodnotami nebo parametry seznamu. Tato část popisuje, jak vytvořit nový parametr seznamu a jak ho použít v dotazech.
Podle předchozího příkladu změňte aktuální hodnotu minimálního okraje z 0,3 na 0,1. Novým cílem je vytvořit parametr seznamu, který může obsahovat čísla objednávek objednávek, které vás zajímají. Pokud chcete vytvořit nový parametr, přejděte do dialogového okna Spravovat parametry a vyberte Nový a vytvořte nový parametr. Do tohoto nového parametru zadejte následující informace:
- Jméno: Zajímavé objednávky
- Popis: Sada čísel objednávek, která jsou zajímavá pro konkrétní analýzu
- Požadované: Pravda
- Typ: Seznamu
Po definování těchto polí se zobrazí nová mřížka, do které můžete zadat hodnoty, které chcete uložit pro parametr. V tomto případě jsou to hodnoty 125, 777 a 999.
Poznámka
I když tento příklad používá čísla, můžete do seznamu uložit i jiné datové typy, například text, kalendářní data, datum a čas a další. Další informace: Datové typy v Power Query
Tip
Pokud chcete mít větší kontrolu nad tím, jaké hodnoty se používají v parametru seznamu, můžete vždy vytvořit seznam s konstantními hodnotami a převést dotaz seznamu na parametr, jak je uvedeno výše v tomto článku.
S novými parametry seznamu Zajímavých objednávek přejděte zpět k dotazu Objednávky . Vyberte nabídku automatického filtru pole OrderID (ID objednávky ). Vyberte Filtry> číselv.
Po výběru této možnosti se zobrazí nové dialogové okno Filtrovat řádky . Tady můžete vybrat parametr seznamu z rozevírací nabídky.
Poznámka
Parametry seznamu můžou fungovat s možnostmi In nebo Not in . V umožňuje filtrovat pouze podle hodnot ze seznamu. Funkce Not in dělá pravý opak a pokusí se vyfiltrovat sloupec, aby získal všechny hodnoty, které se nerovnají hodnotám uloženým v parametru.
Po výběru OK se vrátíte k dotazu. Tam se váš dotaz vyfiltroval pomocí parametru seznamu, který jste vytvořili, a výsledkem je, že se zachovaly jenom řádky, ve kterých se ID objednávky rovnalo hodnotě 125, 777 nebo 999 .
