Mukautetun funktion luominen ja käynnistäminen

Seuraavassa on yksinkertainen esimerkki mukautetusta funktiosta, joka noudattaa pitkäkestoista ohjelmointiperinteitä.

1. Tyhjän kyselyn luominen:
   
   Excel      valitse tiedot>tiedot >muista lähteistä -> tyhjä kysely.
   
   Power Query      Napsauta hiiren kakkospainikkeella tyhjää kohtaa Kyselyt-ruudussa vasemmalla ja valitse sitten Uusi kysely > muista lähteistä > Tyhjä kysely.

2. Kaksoisnapsauta vasemman reunan Kyselyt-ruudussa nimeä ja nimeä sitten uusi tyhjä kysely uudelleen nimellä HelloWorld.

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

4. Korvaa mallin käynnistyskoodi seuraavalla koodilla:

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

5. Valitse Valmis.

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

7. Voit käynnistää funktion valitsemalla sen ja valitsemalla sitten Invoke Tietojen esikatselussa.
   
   

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

9. Valitse kysely ja valitse sitten Aloitus > sulje & Lataa, jotta näet tulokset laskentataulukossa.

Tulos 

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

1. Tyhjän kyselyn luominen:
   
   Excel      valitse tiedot>tiedot >muista lähteistä -> tyhjä kysely.
   
   Power Query      Napsauta hiiren kakkospainikkeella tyhjää kohtaa Kyselyt-ruudussa vasemmalla ja valitse sitten Uusi kysely > muista lähteistä > Tyhjä kysely.

2. Nimeä vasemman reunan Kyselyt-ruudussa uuden tyhjän kyselyn nimeksi "MyHex".

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

4. Korvaa mallin käynnistyskoodi seuraavalla koodilla:

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

5. Valitse Valmis.

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

7. Voit käynnistää funktion valitsemalla sen ja kirjoittamalla sitten tietojen esikatselussa numeron parametri1-ruutuun ja valitsemalla Invoke.

   

8. Funktion tulokset näytetään tietojen esikatselussa ja lisätään Kyselyt-ruutuun kyselynä, jolla on oletusnimi Invoked-funktio. Haluat ehkä nimetä sen uudelleen merkityksellisempään nimeen, kuten "MyHexResult".

9. Valitse kysely ja valitse sitten Aloitus > sulje & Lataa, jotta näet tulokset laskentataulukossa.

Tulos 

Jos olet luonut funktion, jossa on vähintään yksi parametri, voit käynnistää sen mukautettuna funktiona ja luoda uuden sarakkeen ja uuden arvon taulukon kullekin riville.

1. Avaa kysely etsimällä se aiemmin Power Query -editorista, valitsemalla solu tiedoista ja valitsemalla sitten Kysely > Muokkaa. Lisätietoja on kohdassa Kyselyn luominen, muokkaaminen ja lataaminen Excel (Power Query).
   
   Huomautus    Tässä esimerkissä kysely tarvitsee vähintään yhden Kokonaisluku-tietotyypin sarakkeen.

2. Luo mukautettu MyHex-funktio kohdassa Mukautetun funktion luominen ja käynnistäminen lisäeditorin avulla.

3. Valitse kyselyssä Add Column >Invoke Custom Function. Esiin tulee Avaa 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 Kokonaisluku-tietotyypin sarake funktion parametrina.
   
   

8. Valitse OK.

Tulos

Luodaan uusi sarake, jossa näkyy parametrina syötetvän Koko luku -sarakkeen heksadesimaaliarvo.