Sdílet prostřednictvím

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

Funkce zdroje dat

Datový konektor 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.

Example:

[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 zdroje dat

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.

Example:

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

Vlastnosti

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

Obor Typ Podrobnosti
Autentizace 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í.
Označení poslat SMS (volitelné) Přívětivý zobrazovaný název pro toto rozšíření v přihlašovacích dialozích
PodporaŠifrování 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 .

Example:

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 vašeho záznamu pro publikování.

Obor Typ Podrobnosti
Text tlačítka seznam 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 poslat SMS 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ím zpracováním Azure a Database. Všechny ostatní hodnoty budou zařazeny do kategorie 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 poslat SMS (volitelné) Adresa URL webu obsahující další informace o tomto zdroji dat nebo konektoru
PodporujePřímýDotaz 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, avšak konvence pro mnoho standardních konektorů je zobrazovat 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.
  • Last updated on