Kohandatud funktsiooni loomine ja kutsumine

Kohandatud funktsioon kasutab valemikeelt M, võtab sisendväärtuste kogumi ja tagastab seejärel ühe väljundväärtuse. Kui soovite korduvalt kasutada loogikat või rakendada sama teisenduste kogumit mõnele muule päringule või väärtusele, kaaluge kohandatud funktsiooni loomist ja seejärel funktsiooni käivitamist, kus ja millal seda vajate. Kohandatud funktsiooni loomiseks on mitu võimalust.

• Täpsem redaktor abil saate lisada oma let-lause ja alustada nullist.
• Käsu Käivita kohandatud funktsioon kasutamine.
• Selles spikriteemas käsitlemata funktsioonide loomiseks on veel võimalusi, sh käsud Loo funktsioon ja Lisa päringuna . Põhjalikuma ülevaate leiate teemadest Power Query M-funktsioonide (docs.com) mõistmine ja Kohandatud funktsioonide kasutamine (docs.com).

Lihtsa kohandatud funktsiooni loomine ja kutsumine Täpsem redaktor

Järgmine näide on lihtne näide kohandatud funktsioonist, mis järgib pikka aega kestnud programmeerimistraditsiooni.

1. Tühja päringu loomiseks tehke järgmist.

   Excel Valige DataGet Data> from Other Sources Blank Query (Andmed>muudest allikatest>) Tühi päring.

   Power Query paremklõpsake vasakul paanil Päringud tühja kohta ja seejärel valige Uus päring>Muud allikad>Tühi päring.

2. Topeltklõpsake vasakul asuval paanil Päringud nime ja nimetage uus tühi päring ümber nimeks "HelloWorld".

3. Valige uus päring ja seejärel avaleht>Täpsem redaktor.

4. Asendage malli alguskood järgmise koodiga:
   let
     HelloWorld = () => ("Hello World")
in
     HelloWorld

5. Valige Valmis.

6. Muutsite päringu "HelloWorld" kohandatud funktsiooniks. Pöörake tähelepanu , mis jääb sellest vasakule.

7. Funktsiooni kutsumiseks valige see ja seejärel valige andmeeelvaates Käsk Käivita .

   

8. Funktsiooni tulemid kuvatakse andmete eelvaates ja lisatakse päringute paanile vaikenimega Kutsutud funktsioonina. Võib-olla soovite selle ümber nimetada millekski tähenduslikumaks( nt HelloWorldResult).

9. Valige see päring ja seejärel valige tulemite töölehel kuvamiseks Avakuva>& Laadi .

Tulemid

Looge ja kutsuge kohandatud funktsioon, mis sisaldab parameetrit koos Täpsem redaktor

Järgmises näites kirjeldatakse parameetri edastamist kohandatud funktsioonile kümnendarvu teisendamiseks kuueteistkümnendarvuks.

1. Tühja päringu loomiseks tehke järgmist.

   Excel Valige DataGet Data> from Other Sources Blank Query (Andmed>muudest allikatest>) Tühi päring.

   Power Query paremklõpsake vasakul paanil Päringud tühja kohta ja seejärel valige Uus päring>Muud allikad>Tühi päring.

2. Nimetage uus tühi päring vasakul asuval paanil Päringud ümber päringuks "MinuHex".

3. Valige uus päring ja seejärel avaleht>Täpsem redaktor.

4. Asendage malli alguskood järgmise koodiga:
   let
     MyHex = (parameter1) => Number.ToText(parameter1,"X")
in
     MyHex

5. Valige Valmis.

6. Olete muutnud päringu "MyHex" kohandatud funktsiooniks. Pöörake tähelepanu , mis jääb sellest vasakule.

7. Funktsiooni kutsumiseks valige see ja seejärel sisestage andmeeelvaates number väljale parameeter1 ja valige Käsk Käivita.
   

8. Funktsiooni tulemid kuvatakse andmete eelvaates ja lisatakse päringute paanile vaikenimega Kutsutud funktsioonina. Võib-olla soovite selle ümber nimetada millekski tähenduslikumaks, näiteks "MyHexResult".

9. Valige see päring ja seejärel valige tulemite töölehel kuvamiseks Avakuva>& Laadi .

Tulemid

Veeru lisamine kohandatud funktsiooni kutsumise teel

Kui olete loonud vähemalt ühe parameetriga funktsiooni, saate selle kutsuda kohandatud funktsioonina, et luua tabeli iga rea jaoks uus veerg ja uus väärtus.

1. Päringu avamiseks otsige üles Power Query redaktor varem laaditud päring, valige andmetes lahter ja seejärel valige Päringu>redigeerimine. Lisateavet leiate teemast Päringu loomine, redigeerimine ja laadimine Excelis (Power Query).

   Märkus Selles näites vajab päring vähemalt ühte veergu, mille andmetüüp on Täisarv .

2. Looge kohandatud funktsioon "MyHex", nagu on selgitatud jaotises, looge ja käivitage kohandatud funktsioon, mis sisaldab Täpsem redaktor parameetrit.

3. Valige päringus Lisa veeru>kutsumise kohandatud funktsioon. Kuvatakse dialoogiboks Kohandatud funktsiooni kutsumine .

4. Sisestage uue veeru nimi (nt "HexConvert") väljale Uue veeru nimi.

5. Valige funktsioonipäringu ripploendist eelmääratletud kohandatud funktsiooni nimi. Selles näites valige "MyHex".

6. Kuna kohandatud funktsioon viitab parameetrile, kuvatakse parameeter nüüd.

7. Valige funktsiooni parameetriks andmetüübiga Täisarv veerg.

   

8. Klõpsake nuppu OK.

Tulem

Luuakse uus veerg, mis näitab parameetrina sisestatud veeru Täisarv kuueteistkümnendväärtust.

Lisateave

Power Query for Exceli spikker

Power Query valemite koostamine Excelis

Parameeterpäringu loomine

Päringute haldamine

M-Power Query funktsioonide ülevaade (docs.com)

Kohandatud funktsioonide kasutamine (docs.com)