Membuat dan memanggil fungsi kustom

Fungsi kustom menggunakan bahasa rumus M, mengambil sekumpulan nilai input, lalu mengembalikan nilai output tunggal. Jika Anda memiliki logika yang ingin digunakan kembali berkali-kali atau menerapkan kumpulan transformasi yang sama ke kueri atau nilai yang berbeda, pertimbangkan untuk membuat fungsi kustom lalu memanggil fungsi di mana dan kapan anda membutuhkannya. Ada beberapa cara untuk membuat fungsi kustom:

• Gunakan Editor Lanjutan untuk menambahkan pernyataan izinkan Anda sendiri dan mulai dari awal.
• Gunakan perintah Invoke Custom Function .
• Ada cara tambahan untuk membuat fungsi yang tidak dibahas dalam topik bantuan ini termasuk perintah Buat Fungsi dan Tambahkan sebagai Kueri . Untuk diskusi mendalam, lihat Memahami fungsi M Power Query (docs.com) dan Menggunakan fungsi kustom (docs.com).

Membuat dan memanggil fungsi kustom sederhana dengan Editor Lanjutan

Berikut ini adalah contoh sederhana dari fungsi kustom yang mengikuti tradisi pemrograman lama.

1. Untuk membuat kueri kosong:

   Excel Pilih Data>Dapatkan Data> DariKueri KosongSumber> Lain.

   Power Query Klik kanan tempat kosong di panel Kueri di sebelah kiri, lalu pilih Kueri> BaruKueri KosongSumber> Lain.

2. Di panel Kueri di sebelah kiri, klik ganda nama, lalu ganti nama kueri kosong baru menjadi "HelloWorld".

3. Pilih kueri baru lalu pilih Beranda>Editor Lanjutan.

4. Ganti kode permulaan templat dengan kode berikut:
   let
     HelloWorld = () => ("Hello World")
in
     HelloWorld

5. Pilih Selesai.

6. Anda telah mengubah kueri, "HelloWorld", menjadi fungsi kustom. Perhatikan di sebelah kirinya.

7. Untuk memanggil fungsi, pilih fungsi, lalu pilih Memanggil di Pratinjau Data.

   

8. Hasil fungsi ditampilkan dalam Pratinjau data dan ditambahkan ke panel Kueri sebagai kueri dengan nama default, Fungsi Yang Diinvokasi. Anda mungkin ingin mengganti namanya menjadi sesuatu yang lebih bermakna, seperti "HelloWorldResult".

9. Pilih kueri tersebut, lalu pilih Tutup Beranda>& Muat untuk melihat hasil dalam lembar kerja.

Hasil

Membuat dan memanggil fungsi kustom yang memiliki parameter dengan Editor Lanjutan

Contoh berikut ini memperlihatkan cara mengirimkan parameter ke fungsi kustom untuk mengonversi angka desimal menjadi heksadesimal.

1. Untuk membuat kueri kosong:

   Excel Pilih Data>Dapatkan Data> DariKueri KosongSumber> Lain.

   Power Query Klik kanan tempat kosong di panel Kueri di sebelah kiri, lalu pilih Kueri> BaruKueri KosongSumber> Lain.

2. Di panel Kueri di sebelah kiri, ganti nama kueri kosong baru menjadi "MyHex".

3. Pilih kueri baru lalu pilih Beranda>Editor Lanjutan.

4. Ganti kode permulaan templat dengan kode berikut:
   let
     MyHex = (parameter1) => Number.ToText(parameter1,"X")
in
     MyHex

5. Pilih Selesai.

6. Anda telah mengubah kueri, "MyHex", menjadi fungsi kustom. Perhatikan di sebelah kirinya.

7. Untuk memanggil fungsi, pilih fungsi, lalu di Pratinjau Data, masukkan angka dalam kotak parameter1 , lalu pilih Batalkan.
   

8. Hasil fungsi ditampilkan dalam Pratinjau data dan ditambahkan ke panel Kueri sebagai kueri dengan nama default, Fungsi Yang Diinvokasi. Anda mungkin ingin mengganti namanya menjadi sesuatu yang lebih bermakna, seperti "MyHexResult".

9. Pilih kueri tersebut, lalu pilih Tutup Beranda>& Muat untuk melihat hasil dalam lembar kerja.

Hasil

Menambahkan kolom dengan memanggil fungsi kustom

Jika Anda telah membuat fungsi dengan setidaknya satu parameter, Anda bisa memanggilnya sebagai fungsi kustom untuk membuat kolom baru dan nilai baru untuk setiap baris dalam tabel.

1. Untuk membuka kueri, temukan yang sebelumnya dimuat dari Editor Power Query, pilih sel dalam data, lalu pilihEditKueri>. Untuk informasi selengkapnya, lihat Membuat, mengedit, dan memuat kueri di Excel (Power Query).

   Catatan Untuk contoh ini, kueri Anda memerlukan setidaknya satu kolom tipe data Bilangan Bulat .

2. Buat fungsi kustom "MyHex" seperti yang dijelaskan di bagian, Membuat dan memanggil fungsi kustom yang memiliki parameter dengan Editor Lanjutan.

3. Dalam kueri, pilih Tambahkan Kolom>Memanggil Fungsi Kustom. Kotak dialog Sebutkan Fungsi Kustom akan muncul.

4. Masukkan nama kolom baru, seperti "HexConvert", dalam kotak Nama kolom baru .

5. Pilih nama fungsi kustom yang telah ditentukan sebelumnya dari menu menurun Kueri fungsi. Dalam contoh ini, pilih "MyHex".

6. Karena fungsi kustom mereferensikan parameter, parameter sekarang ditampilkan.

7. Pilih kolom tipe data Bilangan Bulat sebagai parameter untuk fungsi tersebut.

   

8. Pilih OK.

Hasil

Kolom baru dibuat yang memperlihatkan nilai Heksadesimal dari kolom Bilangan Bulat yang Anda masukkan sebagai parameter.

Lihat Juga

Power Query untuk Bantuan Excel

Membuat rumus Power Query di Excel

Membuat kueri parameter

Mengelola kueri

Memahami fungsi M Power Query (docs.com)

Menggunakan fungsi kustom (docs.com)