Mukautetun funktion luominen ja käynnistäminen

Mukautettu funktio käyttää M-kaavakieltä, ottaa joukon syöttöarvoja ja palauttaa sitten yhden tulosarvon. Jos haluat käyttää logiikkaasi monta kertaa uudelleen tai käyttää samoja muunnoksia eri kyselyyn tai arvoon, voit luoda mukautetun funktion ja käynnistää funktion sitten tarvittaessa ja milloin sitä tarvitset. Mukautetun funktion voi luoda useilla tavoilla:

• Laajennettu editori avulla voit lisätä oman let-lausekkeen ja aloittaa alusta.
• Käytä Käynnistä mukautettu funktio -komentoa.
• Funktioita voi luoda myös muilla tavoilla, joita ei ole käsitelty tässä ohjeessa, kuten Luo funktio ja Lisää kyselynä -komennot. Tarkempia tietoja on artikkeleissa M Power Query funktioiden ymmärtäminen (docs.com) ja Mukautettujen funktioiden käyttäminen (docs.com).

Yksinkertaisen mukautetun funktion luominen ja käynnistäminen Laajennettu editori avulla

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

1. Tyhjän kyselyn luominen:

   Excel Valitse tiedot>,nouda tiedot>muista lähteistä>,tyhjä kysely.

   Power Query Napsauta vasemmalla olevan Kyselyt-ruudun tyhjää kohtaa hiiren kakkospainikkeella ja valitse sitten Uusi kysely>Muut lähteet>Tyhjä kysely.

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

3. Valitse uusi kysely ja valitse sitten HomeLaajennettu>editori.

4. Korvaa mallin aloituskoodi seuraavalla koodilla:
   let
     HelloWorld = () => ("Hello World")
in
     HelloWorld

5. Valitse Valmis.

6. Olet muuttanut HelloWorld-kyselyn mukautetuksi funktioksi. Huomaa sen vasemmalla puolella oleva toimintokuvake .

7. Käynnistä funktio valitsemalla se ja valitsemalla sitten Käynnistä tietojen esikatselussa.

   

8. Funktion tulokset näytetään tietojen esikatselussa ja lisätään Kyselyt-ruutuun kyselynä oletusnimellä Kutsuttu funktio. Voit nimetä sen uudelleen joksikin merkityksellisemmäksi, kuten "HelloWorldResult".

9. Valitse kyseinen kysely ja valitse sitten Aloitus>Sulje & Lataa, niin näet tulokset laskentataulukossa.

Tulokset

Parametrin sisältävän mukautetun funktion luominen ja käynnistäminen Laajennettu editori avulla

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

1. Tyhjän kyselyn luominen:

   Excel Valitse tiedot>,nouda tiedot>muista lähteistä>,tyhjä kysely.

   Power Query Napsauta vasemmalla olevan Kyselyt-ruudun tyhjää kohtaa hiiren kakkospainikkeella ja valitse sitten Uusi kysely>Muut lähteet>Tyhjä kysely.

2. Nimeä vasemmalla olevassa Kyselyt-ruudussa oleva uusi tyhjä kysely uudelleen nimellä MyHex.

3. Valitse uusi kysely ja valitse sitten HomeLaajennettu>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 sen vasemmalla puolella oleva toimintokuvake .

7. Voit käynnistää funktion valitsemalla sen, kirjoittamalla Tietojen esikatselussa luvun parametri1-ruutuun ja valitsemalla Käynnistä.
   

8. Funktion tulokset näytetään tietojen esikatselussa ja lisätään Kyselyt-ruutuun kyselynä oletusnimellä Kutsuttu funktio. Voit nimetä sen uudelleen joksikin kuvaavammaksi, kuten "Omaheksatulos".

9. Valitse kyseinen kysely ja valitse sitten Aloitus>Sulje & Lataa, niin näet tulokset laskentataulukossa.

Tulokset

Sarakkeen lisääminen mukautetun funktion avulla

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

1. Voit avata kyselyn etsimällä aiemmin Power Query -editorista ladatun kyselyn, valitsemalla tiedoissa olevan solun ja valitsemalla sitten Kyselyn>muokkaaminen. Lisätietoja on artikkelissa Kyselyn luominen, muokkaaminen ja lataaminen Excelissä (Power Query).

   Huomautus Tässä esimerkissä kyselyssä on oltava vähintään yksi Kokonaisluku-tietotyypin sarake.

2. Luo mukautettu MyHex-funktio kohdassa Parametrin sisältävän mukautetun funktion luominen ja käynnistäminen selitetyn osion ohjeiden mukaisesti Laajennettu editori avulla.

3. Valitse kyselyssä Lisää sarake>Käynnistä mukautettu toiminto. Näyttöön tulee Käynnistä mukautettu funktio -valintaikkuna.

4. Kirjoita uuden sarakkeen nimi, kuten "HexConvert", Uuden 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äytetään.

7. Valitse funktion parametriksi sarake, jonka tietotyyppi on Kokonaisluku .

   

8. Valitse OK.

Tulos

Luodaan uusi sarake, joka näyttää parametrina antamasi Kokonaisluku-sarakkeen heksadesimaaliarvon.

Katso myös

Microsoft Power Query for Excelin ohje

Power Query -kaavojen luominen Excelissä

Parametrikyselyn luominen

Kyselyjen hallinta

Tietoja Power Query M-funktioista (docs.com)

Mukautettujen funktioiden käyttäminen (docs.com)