Sdílet prostřednictvím

Vytvoření prvního konektoru: Hello World

  • Článek

Tato ukázka poskytuje jednoduché rozšíření zdroje dat, které lze spustit v editoru Visual Studio Code a načíst do Power BI Desktopu.

Ukázka Hello World

Jako přehled ukazuje tato ukázka:

  • 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.

Postupujte podle pokynů v instalaci sady PowerQuery SDK, vytvořte nový konektor s názvem "HelloWorld", zkopírujte následující kód M a vložte ho do souboru HelloWorld.pq pracovního prostoru konektoru a pak postupujte podle zbývajících pokynů, abyste ho mohli otevřít v Power BI.

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 Power BI 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ů.