Sdílet prostřednictvím

Zpracování přístupu k datům

  • Článek

Funkce zdroje dat

Datový Připojení or zabalí a přizpůsobí chování funkce zdroje dat v knihovně M. Například rozšíření pro rozhraní REST API by využilo funkci Web.Contents k provádění požadavků HTTP. V současné době byla povolena omezená sada funkcí zdroje dat pro podporu rozšiřitelnosti.

Pří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;

Data Source Kind

Funkce označené jako shared v rozšíření můžou být přidružené ke konkrétnímu zdroji dat zahrnutím DataSource.Kind atributu literálu do funkce s názvem záznamu definice zdroje dat. Záznam zdroje dat definuje typy ověřování podporované vaším zdrojem dat a základní informace o značce (například zobrazovaný název nebo popisek). Název záznamu se stane jeho jedinečným identifikátorem.

Každá funkce přidružená ke stejnému zdroji dat musí mít stejné požadované parametry funkce, včetně názvu, typu a pořadí. (Pro účely druhu zdroje dat se parametr nepovažuje za povinný, pokud je označen optional nebo obsahuje jeho metadata DataSource.Path = false.)

Funkce pro určitý druh zdroje dat můžou používat pouze přihlašovací údaje přidružené k danému typu. Přihlašovací údaje se identifikují za běhu provedením vyhledávání na základě kombinace požadovaných parametrů funkce. Další informace o identifikaci přihlašovacích údajů najdete v tématu Cesty ke zdroji dat.

Příklad:

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

Vlastnosti

Následující tabulka uvádí pole pro záznam definice zdroje dat.

Pole Typ Detaily
Ověřování Záznam Určuje jeden nebo více typů ověřování podporovaných vaším zdrojem dat. Vyžaduje se aspoň jeden druh. Každý druh se zobrazí jako možnost v příkazovém řádku přihlašovacích údajů Power Query. Další informace naleznete v tématu Typy ověřování.
Popisek text (volitelné) Popisný zobrazovaný název pro toto rozšíření v dialogových oknech přihlašovacích údajů
SupportsEncryption Logické (volitelné) Pokud je pravda, uživatelské rozhraní zobrazí možnost připojení ke zdroji dat pomocí šifrovaného připojení. Obvykle se používá pro zdroje dat s nešifrovaným záložním mechanismem (obecně ODBC nebo ADO.NET zdroje).

Publikování do uživatelského rozhraní

Podobně jako u záznamu definice zdroje dat poskytuje záznam Publish (Publikovat) uživatelské rozhraní Power Query informace, které potřebuje k zveřejnění tohoto rozšíření v dialogovém okně Získat data .

Pří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

V následující tabulce jsou uvedena pole záznamu Publikovat.

Pole Typ Detaily
Text tlačítka list Seznam textových položek První položka definuje název zobrazený vedle ikony zdroje dat v dialogovém okně Získat data Power BI. Druhá položka (volitelné) definuje popis nástroje, který se zobrazí při najetí na předchozí název.
Kategorie text Kde by se mělo rozšíření zobrazit v dialogovém okně Získat data . V současné době jsou jediné hodnoty kategorií se speciálními handingy Azure a Database. Všechny ostatní hodnoty budou ukončeny v kategorii Ostatní.
Beta Logické (volitelné) Pokud je nastavená hodnota true, uživatelské rozhraní zobrazí vedle názvu konektoru identifikátor Preview/Beta a dialogové okno upozornění, že implementace konektoru podléhá zásadním změnám.
LearnMoreUrl text (volitelné) Adresa URL webu obsahující další informace o tomto zdroji dat nebo konektoru
SupportsDirectQuery Logické (volitelné) Povolí direct query pro vaše rozšíření.
SourceImage Záznam (volitelné) Záznam obsahující seznam binárních obrázků (zdrojový ze souboru přípony pomocí metody Extension.Contents ). Záznam obsahuje dvě pole (Icon16, Icon32), z nichž každý má vlastní seznam. Každá ikona by měla mít jinou velikost.
SourceTypeImage Záznam (volitelné) Podobně jako SourceImage, s výjimkou konvence pro mnoho z box konektorů je zobrazit ikonu listu s ikonou specifickou pro zdroj v pravém dolním rohu. Použití jiné sady ikon pro SourceTypeImage je volitelné – mnoho rozšíření jednoduše opakovaně používá stejnou sadu ikon pro obě pole.