Spracovanie prístupu k dátam

Funkcie zdroja dát

Data Connector obaluje a prispôsobuje správanie funkcie zdroja dát v knižnici M. Napríklad rozšírenie pre REST API by využívalo funkciu Web.Contents na odosielanie HTTP požiadaviek. V súčasnosti je povolená obmedzená sada funkcií zdroja dát na podporu rozšíriteľnosti.

Príklad:

[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;

Druh dátového zdroja

Funkcie označené ako shared vo vašom rozšírení môžu byť priradené ku konkrétnemu zdroju dát pridaním DataSource.Kind literálneho atribútu na funkciu s názvom záznamu definície zdroja dát. Záznam Data Source definuje autentifikačné typy podporované vaším zdrojom dát a základné informácie o značke (ako napríklad zobrazovaný názov / štítok). Názov záznamu sa stáva jeho jedinečným identifikátorom.

Každá funkcia priradená k rovnakému zdroju dát musí mať rovnaké požadované parametre funkcie, vrátane názvu, typu a poradia. (Pre účely typu zdroja dát sa parameter nepovažuje za povinný, ak je optional označený alebo ak jeho metadáta obsahujú DataSource.Path = false.)

Funkcie pre konkrétny typ dátového zdroja môžu používať iba prihlasovacie údaje spojené s týmto druhom. Prihlasovacie údaje sa identifikujú za behu vykonaním vyhľadávania na základe kombinácie požadovaných parametrov funkcie. Pre viac informácií o tom, ako sa identifikujú prihlasovacie údaje, pozri Cesty zdrojov dát.

Príklad:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

Vlastnosti

Nasledujúca tabuľka uvádza polia pre váš záznam definície zdroja dát.

Field Typ Detaily
Authentication záznam Špecifikuje jeden alebo viac typov autentifikácie podporovaných vaším zdrojom dát. Aspoň jeden druh je potrebný. Každý druh bude zobrazený ako možnosť v Power Query výzve na prihlasovacie údaje. Pre viac informácií pozri Autentifikačné druhy.
Označenie odoslať SMS správu (voliteľné) Priateľský zobrazovací názov pre toto rozšírenie v dialógoch s prihlasovacími údajmi.
SupportsEncryption logický (voliteľné) Ak je to pravda, používateľské rozhranie zobrazí možnosť pripojiť sa k dátovému zdroju pomocou šifrovaného pripojenia. Toto sa typicky používa pre dátové zdroje s nešifrovaným záložným mechanizmom (zvyčajne ODBC alebo ADO.NET zdroje).

Publikovať na UI

Podobne ako záznam definície zdroja dát, záznam Publish poskytuje rozhraniu Power Query informácie potrebné na sprístupnenie tohto rozšírenia v dialógovom okne Získať dáta .

Príklad:

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

Vlastnosti

Nasledujúca tabuľka uvádza polia pre váš záznam Publikovať.

Field Typ Detaily
ButtonText zoznam Zoznam textových položiek. Prvá položka definuje názov zobrazený vedľa ikony zdroja dát v dialógovom okne Power BI Get Data . Druhá položka (voliteľná) definuje tooltip, ktorý sa zobrazí po prejdení myšou na predchádzajúce meno.
Kategória odoslať SMS správu Kde by sa rozšírenie malo zobraziť v dialógovom okne Získať dáta . V súčasnosti sú jediné kategóriové hodnoty so špeciálnou kombináciou Azure a Database. Všetky ostatné hodnoty skončia v kategórii Iné.
Beta logický (voliteľné) Keď je nastavenie na true, UI zobrazí identifikátor Preview/Beta vedľa názvu konektora a varovné okno, že implementácia konektora podlieha nefunkčným zmenám.
LearnMoreUrl odoslať SMS správu (voliteľné) URL na webovú stránku obsahujúcu viac informácií o tomto zdroji dát alebo konektore.
SupportsDirectQuery logický (voliteľné) Umožňuje priamy dotaz pre vaše rozšírenie.
Zdrojový obrázok záznam (voliteľné) Záznam obsahujúci zoznam binárnych obrázkov (získaných z príponového súboru pomocou metódy Extension.Content ). Záznam obsahuje dve polia (Icon16, Icon32), každé so svojím vlastným zoznamom. Každá ikona by mala mať inú veľkosť.
SourceTypeImage záznam (voliteľné) Podobne ako SourceImage, s tým rozdielom, že konvencia mnohých konektorov je zobraziť ikonu listu s ikonou špecifickej pre zdroj v pravom dolnom rohu. Mať inú sadu ikon pre SourceTypeImage je voliteľné – mnohé rozšírenia jednoducho znovu používajú tú istú sadu ikon pre obe polia.
  • Last updated on