Özel işlev oluşturma ve çağırma

Özel bir işlev, M formül dilini kullanır, bir dizi giriş değerini alır ve sonra tek bir çıkış değeri döndürür. Birçok kez yeniden kullanmak veya aynı dönüştürme kümesini farklı bir sorguya veya değere uygulamak istediğiniz bir mantığınız varsa, özel bir işlev oluşturmayı, sonra da gereken yerde ve zamanda işlevi çağırmayı düşünebilirsiniz. Özel işlev oluşturmanın birkaç yolu vardır:

• Kendi let deyiminizi eklemek ve sıfırdan başlamak için Gelişmiş DüzenleyiciGelişmiş Düzenleyici öğesini kullanın.
• Özel İşlevi Çağır komutunu kullanın.
• İşlev Oluşturma ve Sorgu Olarak Ekleme komutları gibi işlevlerin oluşturulmasının bu yardım konusunda açıklanmayan başka yolları da vardır. Ayrıntılı bilgi için bkz. Power Query M işlevlerini anlama (docs.com) ve Özel işlevleri kullanma (docs.com).

Gelişmiş Düzenleyici ile basit bir özel işlev oluşturun ve çağırın

Aşağıda, uzun süredir devam eden bir programlama geleneğini izleyen özel bir işlevin basit bir örneği verilmiştir.

1. Boş bir sorgu oluşturmak için:

   Excel Programlama Aracı Veri>Seç Diğer Kaynaklardan>Veri>Al Boş Sorgu.

   Power QueryPower Query Sol taraftaki Sorgular bölmesinde boş bir noktaya sağ tıklayın ve ardından Yeni SorguDiğer Kaynaklar>>Boş Sorgu'yu seçin.

2. Soldaki Sorgular bölmesinde, ada çift tıklayın ve yeni boş sorguyu "HelloWorld" olarak yeniden adlandırın.

3. Yeni sorguyu seçin ve ardından GirişGelişmiş>DüzenleyiciGelişmiş Düzenleyici'i seçin.

4. Şablon başlangıç kodunu aşağıdaki kodla değiştirin:
   let
     HelloWorld = () => ("Hello World")
in
     HelloWorld

5. Bitti’yi seçin.

6. "HelloWorld" sorgusunu özel bir işleve dönüştürdünüz. Solundaki simgesine dikkat edin.

7. İşlevi çağırmak için işlevi seçin ve sonra Veri Önizleme'de Çağır'ı seçin.

   

8. İşlevin sonuçları Veri önizlemesinde görüntülenir ve varsayılan adı olan Çağrılan İşlev ile sorgu olarak Sorgular bölmesine eklenir. Bunu "HelloWorldResult" gibi daha anlamlı bir adla değiştirmek isteyebilirsiniz.

9. Bu sorguyu seçin ve sonra sonuçları bir çalışma sayfasında görmek için Giriş Kapat>& Yükle'yi seçin.

Sonuçlar

TGelişmiş Düzenleyici ile bir parametresi olan özel bir işlev oluşturun ve çağırın Gelişmiş Düzenleyici Gelişmiş Düzenleyici

Aşağıdaki örnekte, bir ondalık sayıyı onaltılık tabana dönüştürmek için bir parametrenin özel bir işleve nasıl geçirileceği gösterilir.

1. Boş bir sorgu oluşturmak için:

   Excel Programlama Aracı Veri>Seç Diğer Kaynaklardan>Veri>Al Boş Sorgu.

   Power QueryPower Query Sol taraftaki Sorgular bölmesinde boş bir noktaya sağ tıklayın ve ardından Yeni SorguDiğer Kaynaklar>>Boş Sorgu'yu seçin.

2. Soldaki Sorgular bölmesinde, yeni boş sorguyu "MyHex" olarak yeniden adlandırın.

3. Yeni sorguyu seçin ve ardından GirişGelişmiş>DüzenleyiciGelişmiş Düzenleyici'i seçin.

4. Şablon başlangıç kodunu aşağıdaki kodla değiştirin:
   let
     MyHex = (parameter1) => Number.ToText(parameter1,"X")
in
     MyHex

5. Bitti’yi seçin.

6. "MyHex" sorgusunu özel bir işleve dönüştürdünüz. Solundaki simgesine dikkat edin.

7. İşlevi çağırmak için işlevi seçin ve ardından Veri Önizleme'de parameter1 kutusuna bir sayı girin ve Çağır'ı seçin.
   

8. İşlevin sonuçları Veri önizlemesinde görüntülenir ve varsayılan adı olan Çağrılan İşlev ile bir sorgu olarak Sorgular bölmesine eklenir. Bunu "MyHexResult" gibi daha anlamlı bir adla değiştirmek isteyebilirsiniz.

9. Bu sorguyu seçin ve sonra sonuçları bir çalışma sayfasında görmek için Giriş Kapat>& Yükle'yi seçin.

Sonuçlar

Özel bir işlev çağırarak sütun ekleme

En az bir parametreli bir işlev oluşturduysanız, tablodaki her satır için yeni bir sütun ve yeni bir değer oluşturmak üzere bu işlevi özel bir işlev olarak çağırabilirsiniz.

1. Bir sorguyu açmak için Power Query Düzenleyicisi daha önce yüklenmiş bir sorguyu bulun, verilerdeki bir hücreyi seçin ve ardından Sorgu Düzenle'yi> seçin. Daha fazla bilgi için bkz. Excel'de sorgu oluşturma, düzenleme ve yükleme (Power QueryPower Query).

   Notlar Bu örnekte, sorgunuz için en az bir Tam Sayı veri türünde sütun oluşturulması gerekir.

2. "MyHex" özel işlevini, Gelişmiş DüzenleyiciGelişmiş Düzenleyici ile bir parametresi olan özel bir işlev oluşturma ve çağırma bölümünde açıklandığı gibi oluşturun.

3. Sorguda Sütun Ekle>Özel İşlev Çağır'ı seçin. Özel İşlevi Çağır iletişim kutusu görüntülenir.

4. Yeni sütun adı kutusuna "HexConvert" gibi yeni bir sütun adı girin.

5. İşlev sorgusu açılan listesinden önceden tanımlanmış bir özel işlevin adını seçin. Bu örnekte, "MyHex" öğesini seçin.

6. Özel işlev bir parametreye başvurduğundan, parametre artık görüntülenir.

7. İşlevin parametresi olarak Tam Sayı veri türünde bir sütun seçin.

   

8. Tamam’ı seçin.

Sonuç

Parametre olarak girdiğiniz Tam Sayı sütununun Onaltılık değerini gösteren yeni bir sütun oluşturulur.

Ayrıca Bkz:

Excel için Power Query Yardımı

Excel’de Power Query formülleri oluşturma

Parametre sorgusu oluşturma

Sorguları yönetme

Power Query M fonksiyonlarını anlama (docs.com)

Özel işlevleri kullanma (docs.com)