Zdieľať cez

Vytvorenie prvého konektora: Hello World

  • Článok

Táto ukážka poskytuje jednoduché rozšírenie zdroja údajov, ktoré je možné spustiť v programe Visual Studio Code a načítať v aplikácii Power BI Desktop.

Ukážka Hello World

Prehľad tejto ukážky znázorňuje:

  • Funkcia exportu (HelloWorld.Contents), ktorá prijíma textový parameter možnosti.
  • Definovanie typu zdroja údajov, ktorý:
    • Deklaruje, že používa implicitné (anonymné) overovanie.
    • Používa zdroje reťazcov, ktoré umožňujú lokalizáciu.
    • Deklarovanie metaúdajov používateľského rozhrania, aby sa rozšírenie môže zobraziť v dialógovom okne Získať údaje v aplikácii Power BI Desktop.

Podľa pokynov v téme Inštalácia súpravy PowerQuery SDK vytvorte nový konektor s názvom HelloWorld, skopírujte nasledujúci kód jazyka M a prilepte ho do súboru HelloWorld.pq pracovného priestoru konektora a potom postupujte podľa ďalších pokynov, aby ste ho mohli otvoriť v službe Power BI.

V nasledujúcej definícii konektora, ktorú nájdete:

  • Príkaz section .
  • Funkcia zdroja údajov s metaúdajmi, ktoré ju zavádzajú ako definíciu zdroja údajov pomocou druhov HelloWorld a publikovania HelloWorld.Publish.
  • Záznam Authentication , ktorý vyhlasuje, že implicitné (anonymné) je jediným typom overovania pre tento zdroj.
  • Záznam publikovania, ktorý vyhlasuje, že toto pripojenie je vo verzii Beta, aký text sa má načítať zo súboru resx, zdrojového obrázka a obrázka zdrojového typu.
  • Záznam, ktorý priraďuje veľkosti ikon s konkrétnymi hodnotami PNGs v priečinku zostavy.
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") }
];

Po vytvorení súboru a jeho skopírovaní do správneho adresára postupujte podľa pokynov v téme Inštalácia kurzu Súprava SDK služby PowerQuery a otvorte Power BI. Konektor môžete vyhľadať v dialógovom okne Získať údaje a vyhľadať výraz "hello".

V tomto kroku sa zobrazí dialógové okno na overenie. Keďže nie sú k dispozícii žiadne možnosti overovania a funkcia nepreberá žiadne parametre, v týchto dialógových oknách nie sú žiadne ďalšie kroky.

Stlačením tlačidla Pripojenie a dialógovým oknom sa dozviete, že ide o konektor ukážky, keďže Beta v dotaze je nastavený na hodnotu true. Keďže k dispozícii nie je žiadne overenie, obrazovka overovania zobrazí kartu pre anonymné overovanie bez polí. Ešte raz stlačte Pripojenie na dokončenie.

Nakoniec editor dotazov zobrazí, čo ste očakávali – čo je funkcia, ktorá vráti text "Hello world".

Ak chcete plne implementovať ukážku, pozrite si ukážku hello world vo vzorovom odkladacom priestore Údajových Pripojenie or.