İlk bağlayıcınızı oluşturma: Hello World

Bu örnek, Visual Studio Code'da çalıştırılabilen ve Power BI Desktop'a yüklenebilen basit bir veri kaynağı uzantısı sağlar.

Merhaba Dünya örneği

Genel bakış olarak bu örnek şunları gösterir:

• Seçenek metin parametresi alabilen dışa aktarma işlevi (HelloWorld.Contents).
• Şu özelliklere sahip bir veri kaynağı türü tanımlama:
  • Örtük (anonim) kimlik doğrulaması kullandığını bildirir.
  • Yerelleştirmeye izin veren dize kaynaklarını kullanır.
  • Uzantının Power BI Desktop Veri Al iletişim kutusunda görünebilmesi için kullanıcı arabirimi meta verilerini bildirme.

PowerQuery SDK'sını Yükleme başlığı altında verilen yönergeleri izleyerek "HelloWorld" adlı yeni bir bağlayıcı oluşturun, aşağıdaki M kodunu kopyalayıp bağlayıcı çalışma alanınızın HelloWorld.pq dosyasına yapıştırın ve ardından power BI'da açabilmek için yönergelerin geri kalanını izleyin.

Aşağıdaki bağlayıcı tanımında şunu bulursunuz:

• Bir section ifade.
• Kind HelloWorld ve Publish HelloWorld.Publishile bunu bir veri kaynağı tanımı olarak oluşturan meta veriler içeren bir veri kaynağı işlevi.
• Authentication Bu kaynağın tek kimlik doğrulama türü örtük (anonim) olduğunu belirten bir kayıttır.
• Bu bağlantının Beta'da olduğunu, resx dosyasından hangi metnin yüklendiğini, kaynak görüntüyü ve kaynak türü görüntüsünü belirten bir yayımlama kaydı.
• Simge boyutlarını derleme klasöründeki belirli PNG'lerle ilişkilendiren bir kayıt.

section HelloWorld;
 
[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;
 
HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];
 
HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];
 
HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

Dosyayı derleyip doğru dizine kopyaladıktan sonra PowerQuery SDK'sını yükleme öğreticisindeki yönergeleri izleyerek Power BI'ı açın. Veri Al iletişim kutusunda bağlayıcınızı bulmak için "merhaba" araması yapabilirsiniz.

Bu adımda bir kimlik doğrulaması iletişim kutusu açılır. Kimlik doğrulama seçeneği olmadığından ve işlev parametre gerektirmediğinden, bu iletişim kutusunda başka adım yoktur.

Bağlan'a bastığınızda, sorguda true olarak ayarlandığından iletişim kutusu bunun bir "Önizleme bağlayıcısı" olduğunu Beta bildirir. Kimlik doğrulaması olmadığından, kimlik doğrulama ekranı alanları olmayan Anonim kimlik doğrulaması için bir sekme sunar. Bitirmek için Yeniden Bağlan'a basın.

Son olarak, sorgu düzenleyicisi beklediğiniz şeyi (Merhaba dünya" metnini döndüren bir işlev) gösterir.

Tam olarak uygulanan örnek için Veri Bağlayıcıları örnek deposundaki Merhaba Dünya Örneği'ne bakın.