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 PublishHelloWorld.Publish
fü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.