Bagikan melalui

Membuat konektor pertama Anda: Halo Dunia

  • Artikel

Sampel ini menyediakan ekstensi sumber data sederhana yang dapat dijalankan di Visual Studio Code, dan dimuat di Power BI Desktop.

sampel Halo Dunia

Sebagai gambaran umum, sampel ini menunjukkan:

  • Mengekspor fungsi (HelloWorld.Contents), yang mengambil parameter teks opsi.
  • Menentukan jenis sumber data yang:
    • Menyatakan bahwa ia menggunakan autentikasi Implisit (anonim).
    • Menggunakan sumber daya string yang memungkinkan pelokalan.
    • Mendeklarasikan metadata UI sehingga ekstensi dapat muncul dalam dialog Dapatkan Data Power BI Desktop.

Mengikuti instruksi dalam Menginstal PowerQuery SDK, buat konektor baru yang disebut "HelloWorld", salin dalam kode M berikut dan tempelkan di file HelloWorld.pq ruang kerja konektor Anda, lalu ikuti instruksi lainnya untuk dapat membukanya di Power BI.

Dalam definisi konektor berikut, Anda menemukan:

  • Sebuah section pernyataan.
  • Fungsi sumber data dengan metadata yang menetapkannya sebagai definisi sumber data dengan Jenis HelloWorld dan Terbitkan HelloWorld.Publish.
  • Catatan Authentication yang menyatakan bahwa implisit (anonim) adalah satu-satunya jenis autentikasi untuk sumber ini.
  • Catatan penerbitan yang menyatakan bahwa koneksi ini berada di Beta, teks apa yang akan dimuat dari file resx, gambar sumber, dan gambar jenis sumber.
  • Rekaman mengaitkan ukuran ikon dengan PNG tertentu di folder build.
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") }
];

Setelah Anda membuat file dan menyalinnya ke direktori yang benar, ikuti instruksi dalam Menginstal tutorial PowerQuery SDK , buka Power BI. Anda dapat mencari "hello" untuk menemukan konektor Anda di dialog Dapatkan Data .

Langkah ini memunculkan dialog autentikasi. Karena tidak ada opsi autentikasi dan fungsi tidak mengambil parameter, tidak ada langkah lebih lanjut dalam dialog ini.

Tekan Koneksi dan dialog memberi tahu Anda bahwa itu adalah "Konektor pratinjau", karena Beta diatur ke true dalam kueri. Karena tidak ada autentikasi, layar autentikasi menyajikan tab untuk autentikasi Anonim tanpa bidang. Tekan Koneksi lagi untuk menyelesaikannya.

Akhirnya, editor kueri muncul memperlihatkan apa yang Anda harapkan—fungsi yang mengembalikan teks "Halo dunia".

Untuk sampel yang diimplementasikan sepenuhnya, lihat sampel Halo Dunia di repositori sampel Data Koneksi ors.