Pielāgotas funkcijas izveide un izsaukšana

Pielāgota funkcija izmanto M formulu valodu, izmanto ievades vērtību kopu un pēc tam atgriež vienu izvades vērtību. Ja jums ir loģika, kuru vēlaties izmantot atkārtoti vairākas reizes vai lietot vienu un to pašu transformāciju kopu citam vaicājumam vai vērtībai, apsveriet iespēju izveidot pielāgotu funkciju un pēc tam to izmantot vajadzīgajā vietā. Ir vairāki veidi, kā izveidot pielāgotu funkciju:

• Izmantojiet Paplašinātais redaktors, lai pievienotu savu izīrēšanas priekšrakstu un sāktu no nulles.
• Izmantojiet komandu Izsaukt pielāgotu funkciju .
• Pastāv arī citi veidi, kā izveidot funkcijas, kas nav aplūkotas šajā palīdzības tēmā, tostarp komandas Izveidot funkciju unPievienot kā vaicājumu . Detalizētu aprakstu skatiet sadaļā Power Query M funkciju izpratne un Pielāgoto funkciju izmantošana.

Izveidojiet un izsauciet vienkāršu pielāgotu funkciju, izmantojot Paplašinātais redaktors

Piemērā tālāk ir parādīta vienkārša pielāgota funkcija, kas seko senai programmēšanas tradīcijai.

1. Izveidojiet tukšu vaicājumu:

   Excel Atlasīt datus> Datuiegūšana>no citiem avotiem>Tukšs vaicājums.

   Power Query Ar peles labo pogu noklikšķiniet uz tukšas vietas vaicājumu rūtī kreisajā pusē un pēc tam atlasiet Jauns vaicājums>Citi avoti>Tukšs vaicājums.

2. Kreisajā rūtī Vaicājumi veiciet dubultklikšķi uz nosaukuma un pēc tam pārdēvējiet jauno tukšo vaicājumu par HelloWorld.

3. Atlasiet jauno vaicājumu un pēc tam atlasiet SākumsPaplašinātais>redaktors.

4. Aizstājiet veidnes sākuma kodu ar šādu kodu:
   let
     HelloWorld = () => ("Hello World")
in
     HelloWorld

5. Atlasiet Gatavs.

6. Jūs mainījāt vaicājumu HelloWorlduz pielāgotu funkciju. Ievērojiet funkcijas ikonu kreisi no tās.

7. Lai izsauktu funkciju, atlasiet to un pēc tam atlasiet Izsaukt datu priekšskatījumā.

   

8. Funkcijas rezultāti tiek parādīti datu priekšskatījumā un tiek pievienoti vaicājumu rūtij kā vaicājums ar noklusējuma nosaukumu Izsaukta funkcija. Iespējams, vēlēsities to pārdēvēt ar jēgpilnāku nosaukumu, piemēram HelloWorldResult, .

9. Atlasiet šo vaicājumu un pēc tam atlasiet Sākums>Aizvērt & Ielādēt , lai redzētu rezultātus darblapā.

Rezultāti

Pielāgotas funkcijas, kurai ir parametrs, izveide un izsaukšana, izmantojot Paplašinātais redaktors

Tālāk esošajā piemērā ir parādīts, kā nodot parametru pielāgotai funkcijai, lai decimālu skaitli pārvērstu par heksadecimālu.

1. Izveidojiet tukšu vaicājumu:

   Excel Atlasīt datus> Datuiegūšana>no citiem avotiem>Tukšs vaicājums.

   Power Query Ar peles labo pogu noklikšķiniet uz tukšas vietas vaicājumu rūtī kreisajā pusē un pēc tam atlasiet Jauns vaicājums>Citi avoti>Tukšs vaicājums.

2. Vaicājumu rūtī pa kreisi pārdēvējiet jauno tukšo vaicājumu par MyHex.

3. Atlasiet jauno vaicājumu un pēc tam atlasiet SākumsPaplašinātais>redaktors.

4. Aizstājiet veidnes sākuma kodu ar šādu kodu:
   let
     MyHex = (parameter1) => Number.ToText(parameter1,"X")
in
     MyHex

5. Atlasiet Gatavs.

6. Jūs mainījāt vaicājumu MyHexuz pielāgotu funkciju. Ievērojiet funkcijas ikonu kreisi no tās.

7. Lai izsauktu funkciju, atlasiet to. Datu priekšskatījumā lodziņā parameter1 ievadiet skaitli un atlasiet Izsaukt.
   

8. Funkcijas rezultāti tiek parādīti datu priekšskatījumā. Power Query pievieno rezultātus vaicājumu rūtij kā vaicājumu ar noklusējuma nosaukumu Izsaukta funkcija. Iespējams, vēlēsities to pārdēvēt ar jēgpilnāku nosaukumu, piemēram MyHexResult, .

9. Atlasiet šo vaicājumu un pēc tam atlasiet Sākums>Aizvērt & Ielādēt , lai redzētu rezultātus darblapā.

Rezultāti

Kolonnas pievienošana, izsaucot pielāgotu funkciju

Ja izveidojat funkciju ar vismaz vienu parametru, varat to izsaukt kā pielāgotu funkciju, lai izveidotu jaunu kolonnu un jaunu vērtību katrai tabulas rindai.

1. Lai atvērtu vaicājumu, atrodiet kādu no iepriekš ielādētajiem vaicājumiem no Power Query redaktora, atlasiet šūnu datos un pēc tam atlasiet Vaicājuma>rediģēšana. Papildinformāciju skatiet sadaļā Vaicājuma izveide, rediģēšana un ielāde programmā Excel (Power Query).

   Piezīme

   Šajā piemērā jūsu vaicājumam ir nepieciešama vismaz viena kolonna ar veselu skaitli datu tipu.

2. Izveidojiet pielāgoto MyHex funkciju, kā paskaidrots sadaļā Pielāgotas funkcijas, kurai ir parametrs, izveide un izsaukšana ar Paplašinātais redaktors.

3. Vaicājumā atlasiet Pievienot kolonnu>Izsaukt pielāgotu funkciju. Tiek atvērts dialoglodziņš Izsaukt pielāgotu funkciju .

4. Ievadiet jaunu kolonnas nosaukumu, piemēram HexConvert, , lodziņā Jaunas kolonnas nosaukums.

5. Funkciju vaicājuma nolaižamajā izvēlnē atlasiet iepriekš definētas pielāgotas funkcijas nosaukumu. Šajā piemērā atlasiet MyHex.

6. Tā kā pielāgotā funkcija atsaucas uz parametru, parametrs tagad tiek parādīts.

7. Atlasiet veselu skaitļu datu tipa kolonnu kā funkcijas parametru.

   

8. Atlasiet Labi.

Rezultāts

Tiek izveidota jauna kolonna, kurā tiek rādīta kā parametrs ievadītās kolonnas Vesels skaitlis heksadecimālā vērtība.

Skatiet arī

Palīdzība par Power Query programmai Excel

Parametru vaicājuma izveide (Power Query)

Vaicājumu pārvaldība (Power Query)

Izpratne par Power Query M funkcijām

Pielāgoto funkciju izmantošana