Megosztás a következőn keresztül:


Az első összekötő létrehozása: „Helló világ!” alkalmazás

Ez a minta egy egyszerű adatforrás-bővítményt biztosít, amely futtatható a Visual Studio Code-ban, és betölthető a Power BI Desktopba.

„Helló világ!” alkalmazás minta

A minta áttekintésként a következőt mutatja be:

  • Az exportálási függvény (HelloWorld.Contents), amely egy beállítási szöveges paramétert vesz igénybe.
  • Adatforrástípus meghatározása, amely:
    • Deklarálja, hogy implicit (névtelen) hitelesítést használ.
    • Olyan sztringerőforrásokat használ, amelyek lehetővé teszik a honosítást.
    • Felhasználói felület metaadatainak deklarálása, hogy a bővítmény megjelenjen a Power BI Desktop Adatok lekérése párbeszédpanelen.

A PowerQuery SDK telepítésével kapcsolatos utasításokat követve hozzon létre egy "HelloWorld" nevű új összekötőt, másolja a következő M-kódba, és illessze be az összekötő-munkaterület HelloWorld.pq fájljába, majd kövesse a többi utasítást, hogy meg tudja nyitni a Power BI-ban.

Az alábbi összekötődefinícióban találja a következőket:

  • Egy section nyilatkozat.
  • Adatforrásfüggvény metaadatokkal, amely adatforrás-definícióként hozza létre a Kind HelloWorld és a Publish HelloWorld.Publishfüggvényt.
  • Ennek Authentication a forrásnak az egyetlen hitelesítési típusa az implicit (névtelen) hitelesítést deklaráló rekord.
  • Egy közzétételi rekord, amely deklarálja, hogy ez a kapcsolat bétaverzióban található, milyen szöveget kell betölteni a resx fájlból, a forrásképből és a forrástípus lemezképéből.
  • Egy rekord, amely ikonméreteket társít a buildelési mappában lévő adott PNG-kkel.
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") }
];

Miután elkészítette a fájlt, és átmásolta a megfelelő könyvtárba, a PowerQuery SDK-oktatóanyag utasításait követve nyissa meg a Power BI-t. A "hello" kifejezésre kattintva megkeresheti az összekötőt az Adatok lekérése párbeszédpanelen.

Ez a lépés egy hitelesítési párbeszédpanelt hoz létre. Mivel nincsenek hitelesítési lehetőségek, és a függvény nem használ paramétereket, a párbeszédpaneleken nincsenek további lépések.

Nyomja le a Csatlakozás, és a párbeszédpanel azt jelzi, hogy ez egy "előzetes verziójú összekötő", mivel Beta a lekérdezés igaz értékre van állítva. Mivel nincs hitelesítés, a hitelesítési képernyő a névtelen hitelesítés lapját jeleníti meg mezők nélkül. A befejezéshez nyomja le ismét a Csatlakozás.

Végül megjelenik a lekérdezésszerkesztő, amely megjeleníti a várt értéket – egy függvényt, amely a "Hello world" szöveget adja vissza.

A teljes körűen implementált mintához tekintse meg a „Helló világ!” alkalmazás Mintát az Adat Csatlakozás orok mintaadattárában.