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 artikkelissa Tietoja Power Query M:n funktioista ja Mukautettujen funktioiden käyttäminen.

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

Seuraavassa esimerkissä esitellään yksinkertainen mukautettu funktio, joka noudattaa vanhaa ohjelmointiperinnettä.

1. Tyhjän kyselyn luominen:

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

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

2. Kaksoisnapsauta nimeä vasemmalla olevassa Kyselyt-ruudussa ja anna uuden tyhjän kyselyn nimeksi 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. Muutit kyselyn , HelloWorldmukautetuksi funktioksi. Huomaa sen vasemmalla puolella oleva toimintokuvake .

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

   

8. Funktion tulokset näkyvät tietojen esikatselussa ja lisätään Kyselyt-ruutuun kyselynä oletusnimellä Kutsuttu funktio. Haluat ehkä muuttaa sen kuvaavammaksi, 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 hiiren kakkospainikkeella vasemmalla olevan Kyselyt-ruudun tyhjää kohtaa ja valitse sitten Uusi kysely>Muut lähteet>Tyhjä kysely.

2. Anna vasemmalla olevassa Kyselyt-ruudussa uuden tyhjän kyselyn nimeksi 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. Muutit kyselyn , MyHexmukautetuksi funktioksi. Huomaa sen vasemmalla puolella oleva toimintokuvake .

7. Käynnistä funktio valitsemalla se. Kirjoita tietojen esikatselussa luku parametri1-ruutuun ja valitse Käynnistä.
   

8. Funktion tulokset näkyvät tietojen esikatselussa. Power Query lisää tulokset Kyselyt-ruutuun kyselynä, jonka oletusnimenä on Kutsuttu funktio. Haluat ehkä muuttaa sen kuvaavammaksi, kuten .MyHexResult

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

Tulokset

Sarakkeen lisääminen mukautetun funktion avulla

Jos luot funktion, jossa on vähintään yksi parametri, voit kutsua sen mukautettuna funktiona ja luoda 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 MyHex mukautettu 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

Uusi sarake luodaan, ja se näyttää parametrina antamasi Kokonaisluku-sarakkeen heksadesimaaliarvon.

Katso myös

Microsoft Power Query for Excelin ohje

Parametrikyselyn luominen (Power Query)

Kyselyjen hallinta (Power Query)

Tietoja Power Query M:n funktioista

Mukautettujen funktioiden käyttäminen