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

Az alábbiakban egy egyszerű példa látható egy olyan egyéni függvényre, amely egy hosszú távú programozási hagyományt követ.

1. Üres lekérdezés létrehozása:
   
   Az Excel    Adatok kijelölése> Adatok lekérése > más forrásokból > üres lekérdezés.
   
   Power Query    kattintson a jobb gombbal egy üres pontra a bal oldali Lekérdezések panelen, majd válassza az Új lekérdezés > Egyéb források > az Üres lekérdezés lehetőséget.

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

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. A "HelloWorld" lekérdezést egyéni függvényre módosította. Figyelje meg a függvény ikonját, a bal oldalán.

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 Adatelőnézetben, és a Lekérdezések panelre kerülnek az alapértelmezett nevű , Meghívt függvény nevű lekérdezésként. Érdemes lehet átnevezni valami értelmesebb névre, például a "HelloWorldResult" névre.

9. Jelölje ki a lekérdezést, majd válassza a Kezdőlap > Bezárás & Betöltés lehetőséget az eredmények munkalapon való megtekintéséhez.

Eredmények 

Az alábbi példa bemutatja, hogyan adhat át egy paramétert egy egyéni függvénynek a decimális szám hexadecimálissá konvertálásához.

1. Üres lekérdezés létrehozása:
   
   Az Excel    Adatok kijelölése> Adatok lekérése > más forrásokból > üres lekérdezés.
   
   Power Query    kattintson a jobb gombbal egy üres pontra a bal oldali Lekérdezések panelen, majd válassza az Új lekérdezés > Egyéb források > az Üres lekérdezés lehetőséget.

2. A bal oldali Lekérdezések panelen nevezze át az új üres lekérdezést "MyHex" névre.

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. A "MyHex" lekérdezést egyéni függvényre módosította. Figyelje meg a függvény ikonját, a bal oldalán.

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

   

8. A függvény eredményei az Adatelőnézetben jelennek meg, és a Lekérdezések panelre kerülnek az alapértelmezett , Meghívt függvény nevű lekérdezésként. Érdemes lehet átnevezni valami értelmesebb névre, például a "MyHexResult" névre.

9. Jelölje ki a lekérdezést, majd válassza a Kezdőlap > Bezárás & Betöltés lehetőséget az eredmények munkalapon való megtekintéséhez.

Eredmények 

Ha létrehozott egy függvényt legalább egy paraméterrel, meghívhatja egyéni függvényként, hogy új oszlopot és új értéket hozzon létre a tábla minden sorához.

1. Lekérdezés megnyitásához keresse meg a Power Query-szerkesztő korábban betöltöttet, jelöljön ki egy cellát az adatokban, majd válassza a Lekérdezés > Szerkesztés lehetőséget. További információ: Lekérdezés létrehozása, szerkesztése és betöltése az Excelben (Power Query).
   
   Jegyzet    Ebben a példában a lekérdezéshez legalább egy Egész szám adattípusú oszlopra van szükség.

2. Hozza létre a "MyHex" egyéni függvényt a Create and invoke a custom function that has a parameter with the Speciális szerkesztő (Egyéni függvény létrehozása és meghívása) című szakaszban leírtak szerint.

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

4. Írja be az új oszlop nevét (például "HexConvert") az Új oszlop neve mezőbe.

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

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

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, amely a paraméterként megadott Egész szám oszlop hexadecimális értékét jeleníti meg.