Vytvoření a vyvolání vlastní funkce

Vlastní funkce používá jazyk vzorců M, přebírá sadu vstupních hodnot a pak vrací jednu výstupní hodnotu. Pokud máte logiku, kterou chcete opakovaně použít nebo použít stejnou sadu transformací na jiný dotaz nebo hodnotu, zvažte vytvoření vlastní funkce a následné vyvolání funkce tam, kde ji potřebujete. Vlastní funkci můžete vytvořit několika způsoby:

Pomocí Rozšířený editor můžete přidat vlastní příkaz let a začít od začátku.
Použijte příkaz Volat vlastní funkci .
Existují další způsoby vytváření funkcí, které nejsou popsané v tomto tématu nápovědy, včetně příkazů Vytvořit funkci a Přidat jako dotaz . Podrobné informace najdete v tématech Principy funkcí Power Query M (docs.com)a Používání vlastních funkcí (docs.com).

Následuje jednoduchý příklad vlastní funkce, která se řídí dlouhou programovací tradici.

Vytvoření prázdného dotazu:Excel Vyberte Data > Získat data > z jiných zdrojů > prázdný dotaz.Power Query Klikněte pravým tlačítkem myši na prázdné místo v podokně Dotazy na levé straně a pak vyberte Nový dotaz > Další zdroje > Prázdný dotaz.
V podokně Dotazy na levé straně poklikejte na název a přejmenujte nový prázdný dotaz na HelloWorld.
Vyberte nový dotaz a pak vyberte Domů > Rozšířený editor.
Nahraďte úvodní kód šablony následujícím kódem:

let HelloWorld = () => ("Hello World") in HelloWorld
Vyberte Hotovo.
Změnili jste dotaz HelloWorld na vlastní funkci. Všimněte si ikony funkce vlevo od ní.
Pokud chcete funkci vyvolat, vyberte ji a pak vyberte Volat v náhledu dat.
Výsledky funkce se zobrazí v náhledu dat a přidají se do podokna Dotazy jako dotaz s výchozím názvem Vyvolaná funkce. Můžete ho přejmenovat na něco smysluplnějšího, například "HelloWorldResult".
Vyberte tento dotaz a pak vyberte Domů > Zavřít & Načíst , aby se zobrazily výsledky v listu.

Výsledky

Výsledky HelloWorld na listu

Následující příklad ukazuje, jak předat parametr vlastní funkci pro převod desetinného čísla na šestnáctkové.

Vytvoření prázdného dotazu:Excel Vyberte Data > Získat data > z jiných zdrojů > prázdný dotaz.Power Query Klikněte pravým tlačítkem myši na prázdné místo v podokně Dotazy na levé straně a pak vyberte Nový dotaz > Další zdroje > Prázdný dotaz.
V podokně Dotazy na levé straně přejmenujte nový prázdný dotaz na MyHex.
Vyberte nový dotaz a pak vyberte Domů > Rozšířený editor.
Nahraďte úvodní kód šablony následujícím kódem:

let MyHex = (parameter1) => Number.ToText(parameter1,"X") in MyHex
Vyberte Hotovo.
Změnili jste dotaz MyHex na vlastní funkci. Všimněte si ikony funkce vlevo od ní.
Pokud chcete funkci vyvolat, vyberte ji a pak v náhledu dat zadejte číslo do pole parametr1 a vyberte Volat.
Výsledky funkce se zobrazí v náhledu dat a přidají se do podokna Dotazy jako dotaz s výchozím názvem Vyvolaná funkce. Můžete ho přejmenovat na něco smysluplnějšího, například "MyHexResult".
Vyberte tento dotaz a pak vyberte Domů > Zavřít & Načíst , aby se zobrazily výsledky v listu.

Výsledky

Výsledek funkce MyHex na listu

Pokud jste vytvořili funkci s alespoň jedním parametrem, můžete ji vyvolat jako vlastní funkci a vytvořit tak nový sloupec a novou hodnotu pro každý řádek v tabulce.

Pokud chcete otevřít dotaz, vyhledejte dříve načtený z Editor Power Query, vyberte buňku v datech a pak vyberte Dotaz > Upravit. Další informace najdete v tématu Vytvoření, úprava a načtení dotazu v Excelu (Power Query).Poznámka V tomto příkladu váš dotaz potřebuje alespoň jeden sloupec datového typu Celé číslo .
Vytvořte vlastní funkci "MyHex", jak je vysvětleno v části Vytvoření a vyvolání vlastní funkce, která má parametr s Rozšířený editor.
V dotazu vyberte Přidat sloupec > Vyvolat vlastní funkci. Zobrazí se dialogové okno Vyvolat vlastní funkci .
Do pole Nový název sloupce zadejte nový název sloupce, například HexConvert.
V rozevíracím seznamu Dotaz na funkci vyberte název předdefinované vlastní funkce. V tomto příkladu vyberte MyHex.
Vzhledem k tomu, že vlastní funkce odkazuje na parametr, parametr se teď zobrazí.
Jako parametr funkce vyberte sloupec datového typu Celé číslo .
Vyberte OK.