Egyéni függvény létrehozása és meghívása

Az egyéni függvények az M képletnyelvet használva bemeneti értékeket vesznek alapul, majd egyetlen kimeneti értéket adnak vissza. Ha van olyan logikája, amelyet sokszor szeretne újrahasználni, vagy ugyanazt a átalakításkészletet szeretné alkalmazni egy másik lekérdezésre vagy értékre, érdemes létrehozni egy egyéni függvényt, majd meghívni ott, ahol és amikor szüksége van rá. Egyéni függvények többféle módon is létrehozhatók:

• A Speciális szerkesztő segítségével saját "letét" kifejezést adhat hozzá, és az alapoktól kezdheti az indulást.
• Használja az Egyéni függvény meghívása parancsot.
• Vannak olyan további függvények létrehozási módjai is, amelyekről ez a súgótémakör nem beszél, például a Függvény létrehozása és a Hozzáadás lekérdezésként parancs. A részletes ismertetést "A Power Query M-függvényeinek ismertetése és Az egyéni függvények használata" című témakörben találja.

Egyszerű egyéni függvény létrehozása és meghívása a Speciális szerkesztő segítségével

Az alábbi példa egy egyszerű egyéni függvényt mutat be, amely régi programozási hagyományokat követ.

1. Hozzon létre egy üres lekérdezést:

   Excel Select Data>Get Data> fromOther sources>Üres lekérdezés.

   Power Query Kattintson a jobb gombbal egy üres helyre a bal oldali Lekérdezések ablaktáblán, és válassza az Új lekérdezés>Egyéb források>üres lekérdezés parancsot.

2. A bal oldali Lekérdezések panelen kattintson duplán a névre, majd nevezze át az új üres lekérdezést a következőre HelloWorld: .

3. Válassza ki az új lekérdezést, majd válassza a Kezdőlap>Speciális szerkesztő lehetőséget.

4. Cserélje le a sablon kezdőkódját a következő kódra:
   let
     HelloWorld = () => ("Hello World")
in
     HelloWorld

5. Válassza a Kész lehetőséget.

6. Módosította a lekérdezést, , HelloWorldegyéni függvényre. Figyelje meg a függvény a tőle balra.

7. A függvény meghívásához jelölje ki, majd válassza a Meghívás az Adatelőnézetben lehetőséget.

   

8. A függvény eredményei megjelennek az Adatbetekintő nézetben, és lekérdezésként jelennek meg a Lekérdezések ablaktáblában az alapértelmezett Meghívott függvény nevű lekérdezésként. Lehet, hogy át szeretné nevezni valami értelmesebbre, például a HelloWorldResult.

9. Jelölje ki a lekérdezést, majd a Kezdőlap>bezárás & Betöltés elemre kattintva tekintse meg az eredményeket egy munkalapon.

Eredmény:

Hozzon létre és hívjon meg egy paraméterrel rendelkező egyéni függvényt a Speciális szerkesztő segítségével

A következő példa bemutatja, hogyan lehet paramétert átadni egy egyéni függvénynek egy decimális szám hexadecimálissá alakításához.

1. Hozzon létre egy üres lekérdezést:

   Excel Select Data>Get Data> fromOther sources>Üres lekérdezés.

   Power Query Kattintson a jobb gombbal egy üres helyre a bal oldali Lekérdezések ablaktáblán, és válassza az Új lekérdezés>Egyéb források>üres lekérdezés parancsot.

2. A bal oldali Lekérdezések panelen nevezze át az új, üres lekérdezést a következő névre MyHex: .

3. Válassza ki az új lekérdezést, majd válassza a Kezdőlap>Speciális szerkesztő lehetőséget.

4. Cserélje le a sablon kezdőkódját a következő kódra:
   let
     MyHex = (parameter1) => Number.ToText(parameter1,"X")
in
     MyHex

5. Válassza a Kész lehetőséget.

6. Módosította a lekérdezést, , MyHexegyéni függvényre. Figyelje meg a függvény a tőle balra.

7. A függvény meghívásához jelölje ki azt. Az Adatok előnézete párbeszédpanelen adjon meg egy számot a paraméter1 mezőben, és válassza a Meghívás lehetőséget.
   

8. A függvény eredményei megjelennek az Adatvillámnézetben. A Power Query az eredményeket lekérdezésként adja hozzá a Lekérdezések ablaktáblához, az alapértelmezett Meghívott függvény néven. Lehet, hogy át szeretné nevezni valami értelmesebbre, például a MyHexResult.

9. Jelölje ki a lekérdezést, majd a Kezdőlap>bezárás & Betöltés elemre kattintva tekintse meg az eredményeket egy munkalapon.

Eredmény:

Oszlop hozzáadása egyéni függvény meghívásával

Ha létrehoz egy függvényt, amely legalább egy paraméterrel rendelkezik, meghívhatja egyéni függvényként, és létrehozhat egy új oszlopot és egy új értéket a táblázat minden egyes sorához.

1. Lekérdezés megnyitásához keresse meg a korábban a Power Query-szerkesztőből betöltött egyet, jelöljön ki egy cellát az adatok között, majd válassza a Lekérdezés>szerkesztése lehetőséget. További információt a Lekérdezés létrehozása, szerkesztése és betöltése az Excelben (Power Query) című témakörben talál.

   Megjegyzés

   Ebben a példában a lekérdezéshez legalább egy oszlopban szerepelnie kell egész szám adattípusnak.

2. Hozza létre az egyéni függvényt MyHex a Paraméterrel rendelkező egyéni függvény létrehozása és meghívása című szakaszban leírtak szerint a Speciális szerkesztő segítségével.

3. A lekérdezésben válassza az Oszlop> hozzáadásalehetőséget Egyéni függvény meghívása. Megjelenik az Egyéni függvény meghívása párbeszédpanel.

4. Írja be az új oszlop nevét, például HexConvertaz Új oszlop neve mezőbe.

5. Válassza egy előre definiált egyéni függvény nevét a Függvénylekérdezés legördülő listában. Ebben a példában válassza a .MyHex

6. Mivel az egyéni függvény egy paraméterre hivatkozik, megjelenik a paraméter.

7. Jelöljön ki egy egész szám adattípusú oszlopot a függvény paramétereként.

   

8. Kattintson az OK gombra.

Eredmény

Létrejön egy új oszlop, amelyben a paraméterként megadott Egész szám oszlop hexadecimális értéke látható.

Lásd még

Excelhez készült Microsoft Power Query – súgó

Paraméteres lekérdezés létrehozása (Power Query)

Lekérdezések kezelése (Power Query)

A Power Query M-függvényeinek ismertetése

Egyéni függvények használata