Vytvoření prvního konektoru: Hello World

Ukázka Hello World

Tato ukázka poskytuje jednoduché rozšíření zdroje dat, které se dá spustit v sadě Visual Studio a načíst do Power BI Desktopu. Jako přehled ukazuje tato ukázka následující:

• Export funkce (HelloWorld.Contents), která přebírá textový parametr možnosti.
• Definování typu zdroje dat, který:
  • Deklaruje, že používá implicitní (anonymní) ověřování.
  • Používá řetězcové prostředky, které umožňují lokalizaci.
  • Deklarování metadat uživatelského rozhraní, aby se rozšíření zobrazilo v dialogovém okně Získat data v Power BI Desktopu.

Podle pokynů v instalaci sady PowerQuery SDK vytvořte nový projekt s názvem "HelloWorld" a zkopírujte ho v následujícím kódu M a pak postupujte podle zbývajících pokynů, abyste ho mohli otevřít v PowerBI.

V následující definici konektoru najdete:

• Příkaz.section
• Funkce zdroje dat s metadaty, která ji navazují jako definici zdroje dat s typem HelloWorld a publikováním HelloWorld.Publish.
• Záznam Authentication , který deklaruje, že implicitní (anonymní) je jediným typem ověřování pro tento zdroj.
• Záznam publikování deklarující, že toto připojení je v beta verzi, jaký text se má načíst ze souboru resx, zdrojové image a image typu zdroje.
• Záznam asociující velikosti ikon s konkrétními skupinami PNG ve složce sestavení

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") }
];

Jakmile soubor sestavíte a zkopírujete ho do správného adresáře, otevřete PowerBI podle pokynů v části Instalace sady PowerQuery SDK . Konektor můžete vyhledat v dialogovém okně Získat data tak, že vyhledáte "hello".

Tento krok zobrazí dialogové okno ověřování. Vzhledem k tomu, že neexistují žádné možnosti ověřování a funkce nepřijímá žádné parametry, nejsou v těchto dialogových oknech žádné další kroky.

Stiskněte Připojení a v dialogovém okně se dozvíte, že se jedná o konektor náhledu, protože Beta je v dotazu nastavený na true. Vzhledem k tomu, že neexistuje žádné ověřování, zobrazí se na obrazovce ověřování karta anonymního ověřování bez polí. Dalším stisknutím Připojení dokončete akci.

Nakonec editor dotazů zobrazí, co očekáváte – funkce, která vrátí text "Hello world".

Plně implementovanou ukázku najdete v ukázce Hello World v úložišti ukázkových Připojení orů.