Mukautetun funktion luominen ja kutsuminen

Seuraavassa on yksinkertainen esimerkki mukautetusta funktiosta, joka noudattaa pitkäaikaista ohjelmointiperinnettä.

1. Tyhjän kyselyn luominen:
   
   Excel    Select Data > Get Data > From Other Sources > Blank Query.
   
   Power Query    napsauta hiiren kakkospainikkeella tyhjää kohtaa Kyselyt-ruudussa vasemmalla ja valitse sitten Uusi kysely > Muut lähteet > Tyhjä kysely.

2. Kaksoisnapsauta vasemmalla olevassa Kyselyt-ruudussa nimeä ja nimeä uusi tyhjä kysely uudelleen nimellä "HelloWorld".

3. Valitse uusi kysely ja valitse sitten Aloitus > Laajennettu editori.

4. Korvaa mallin aloituskoodi seuraavalla koodilla:

   let
        HelloWorld = () => ("Hello World")
   in
        HelloWorld

5. Valitse Valmis.

6. Olet muuttanut HelloWorld-kyselyn mukautetuksi funktioksi. Huomaa funktiokuvake, sen vasemmalla puolella.

7. Jos haluat käynnistää funktion, valitse se ja valitse sitten Käynnistä tietojen esikatselussa.
   
   

8. Funktion tulokset näytetään tietojen esikatselussa ja lisätään Kyselyt-ruutuun kyselynä, jonka oletusnimenä on Invoked-funktio. Haluat ehkä nimetä sen uudelleen joksikin merkityksellisemmäksi, kuten "HelloWorldResult".

9. Valitse kysely ja valitse sitten Aloitus > Sulje & Lataa nähdäksesi tulokset laskentataulukossa.

Tulokset 

Seuraavassa esimerkissä näytetään, miten voit siirtää parametrin mukautettuun funktioon desimaaliluvun muuntamiseksi heksadesimaaliluvuksi.

1. Tyhjän kyselyn luominen:
   
   Excel    Select Data > Get Data > From Other Sources > Blank Query.
   
   Power Query    napsauta hiiren kakkospainikkeella tyhjää kohtaa Kyselyt-ruudussa vasemmalla ja valitse sitten Uusi kysely > Muut lähteet > Tyhjä kysely.

2. Nimeä uusi tyhjä kysely uudelleen vasemman reunan Kyselyt-ruudussa nimeksi "OmaHex".

3. Valitse uusi kysely ja valitse sitten Aloitus > Laajennettu editori.

4. Korvaa mallin aloituskoodi seuraavalla koodilla:

   let
        MyHex = (parameter1) => Number.ToText(parameter1,"X")
   in
        MyHex

5. Valitse Valmis.

6. Olet muuttanut kyselyn MyHex mukautetuksi funktioksi. Huomaa funktiokuvake, sen vasemmalla puolella.

7. Jos haluat käynnistää funktion, valitse se ja kirjoita sitten Tietojen esikatselu -kohdassa luku parametri1 -ruutuun ja valitse Kutsu.

   

8. Funktion tulokset näytetään tietojen esikatselussa ja lisätään Kyselyt-ruutuun kyselynä, jonka oletusnimi on Invoked Function. Haluat ehkä nimetä sen uudelleen merkityksellisemmäksi, kuten "MyHexResult".

9. Valitse kysely ja valitse sitten Aloitus > Sulje & Lataa nähdäksesi tulokset laskentataulukossa.

Tulokset 

Jos olet luonut funktion, jossa on vähintään yksi parametri, voit käyttää sitä mukautettuna funktiona uuden sarakkeen ja uuden arvon luomiseksi taulukon jokaiselle riville.

1. Jos haluat avata kyselyn, etsi Power Query -editori aiemmin ladattu kysely, valitse tiedoista solu ja valitse sitten Kysely > Muokkaa. Lisätietoja on artikkelissa Kyselyn luominen, muokkaaminen ja lataaminen Excelissä (Power Query).
   
   Muistiinpano    Tässä esimerkissä kyselyssä on oltava vähintään yksi koko luku -tietotyypin sarake.

2. Luo mukautettu OmaHex-funktio kohdassa Kuvatulla tavalla Luo ja käynnistä mukautettu funktio, jolla on parametri Laajennettu editori kanssa.

3. Valitse kyselyssä Lisää sarake > Käynnistä mukautettu funktio. Näkyviin tulee Kutsu mukautettu funktio -valintaikkuna.

4. Kirjoita uuden sarakkeen nimi, kuten "HexConvert", Uusi sarakkeen nimi -ruutuun.

5. Valitse ennalta määritetyn mukautetun funktion nimi avattavasta Funktiokysely-valikosta. Valitse tässä esimerkissä MyHex.

6. Koska mukautettu funktio viittaa parametriin, parametri näkyy nyt.

7. Valitse koko luku -tietotyypin sarake funktion parametrina.
   
   

8. Valitse OK.

Tulos

Luodaan uusi sarake, joka näyttää parametrina kirjoittamasi Kokonaisluku-sarakkeen Heksadesimaaliarvon.