共用方式為

建立您的第一個連接器：Hello World

  • 發行項

此範例提供簡單的數據源延伸模組，可在Visual StudioCode中執行，並在Power BI Desktop 中載入。

Hello World 範例

此範例概觀顯示：

  • 匯出函式 （HelloWorld.Contents），它會採用選項文字參數。
  • 定義資料來源種類：：
    • 宣告其使用隱含（匿名）驗證。
    • 使用允許本地化的字串資源。
    • 宣告UI元數據，讓延伸模組可以在Power BI Desktop [取得資料] 對話框中顯示。

依照安裝PowerQuery SDK中的指示，建立名為 「HelloWorld」 的新連接器、複製下列 M 程式代碼，並將它貼到連接器工作區的 HelloWorld.pq 檔案中，然後遵循其餘指示，在 Power BI 中開啟它。

在下列連接器定義中，您會找到：

  • 語句 section 。
  • 具有元數據的數據源函式，其會將它建立為具有 Kind HelloWorld 和 Publish HelloWorld.Publish的數據源定義。
  • Authentication宣告隱含（匿名）是此來源唯一驗證類型的記錄。
  • 發佈記錄，宣告此連線在 Beta 中、要從 resx 檔案載入的文字、來源影像和來源類型影像。
  • 將圖示大小與組建資料夾中的特定 PNG 產生關聯的記錄。
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") }
];

建置檔案並將其複製到正確的目錄之後，請依照安裝 PowerQuery SDK 教學課程中的指示，開啟 Power BI。 您可以在 [取得資料] 對話框中搜尋 「hello」 來尋找您的連接器。

此步驟會顯示驗證對話方塊。 由於沒有驗證選項，而且函式不會採用任何參數，因此這些對話框中沒有進一步的步驟。

按 連線，對話方塊會告訴您它是「預覽連接器」，因為 Beta 已在查詢中設定為 true。 由於沒有驗證，因此驗證畫面會顯示 [匿名驗證] 索引標籤，且沒有字段。 再次按 連線 以完成。

最後，查詢編輯器會顯示您預期的內容，這是傳回文字 「Hello world」 的函式。

如需完整實作的範例，請參閱數據 連線 ors 範例存放庫中的 Hello World 範例。