Dela via

Hantera dataåtkomst

  • Artikel

Datakällans funktioner

En data Anslut eller omsluter och anpassar beteendet för en datakällsfunktion i M-biblioteket. Ett tillägg för ett REST-API skulle till exempel använda funktionen Web.Contents för att göra HTTP-begäranden. För närvarande har en begränsad uppsättning funktioner för datakällor aktiverats för att stödja utökningsbarhet.

Exempel:

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

Typ av datakälla

Funktioner som är markerade som shared i tillägget kan associeras med en specifik datakälla genom att inkludera ett DataSource.Kind literalattribut på funktionen med namnet på en datakällas definitionspost. Posten Datakälla definierar de autentiseringstyper som stöds av datakällan och grundläggande varumärkesinformation (till exempel visningsnamn/etikett). Namnet på posten blir dess unika identifierare.

Varje funktion som är associerad med samma datakälla måste ha samma obligatoriska funktionsparametrar, inklusive namn, typ och ordning. (För datakällans typ anses inte en parameter vara obligatorisk om den är markerad optional eller om dess metadata innehåller DataSource.Path = false.)

Funktioner för en specifik typ av datakälla kan bara använda autentiseringsuppgifter som är associerade med den typen. Autentiseringsuppgifter identifieras vid körning genom att utföra en sökning baserat på kombinationen av funktionens obligatoriska parametrar. Mer information om hur autentiseringsuppgifter identifieras finns i Sökvägar för datakälla.

Exempel:

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

Egenskaper

I följande tabell visas fälten för din datakällas definitionspost.

Fält Typ Details
Autentisering Post Anger en eller flera typer av autentisering som stöds av datakällan. Minst en typ krävs. Varje typ visas som ett alternativ i Power Query-autentiseringsprompten. Mer information finns i Autentiseringstyper.
Etikett text (valfritt) Eget visningsnamn för det här tillägget i dialogrutor för autentiseringsuppgifter.
SupportsEncryption Logiska (valfritt) När det är sant visar användargränssnittet alternativet att ansluta till datakällan med hjälp av en krypterad anslutning. Detta används vanligtvis för datakällor med en icke-krypterad återställningsmekanism (vanligtvis ODBC eller ADO.NET baserade källor).

Publicera i användargränssnittet

På samma sätt som datakällans definitionspost ger publiceringsposten Power Query-användargränssnittet den information som behövs för att exponera det här tillägget i dialogrutan Hämta data .

Exempel:

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

Egenskaper

I följande tabell visas fälten för publiceringsposten.

Fält Typ Details
Knapptext lista Lista över textobjekt. Det första objektet definierar namnet som visas bredvid datakällans ikon i dialogrutan Hämta data i Power BI. Det andra objektet (valfritt) definierar verktygstipset som ska visas när föregående namn är muspekaren över.
Kategori text Var tillägget ska visas i dialogrutan Hämta data . För närvarande är Azure de enda kategorivärdena med särskild handing och Database. Alla andra värden hamnar under kategorin Övrigt.
Beta Logiska (valfritt) När värdet är true visar användargränssnittet en förhandsgransknings-/betaidentifierare bredvid anslutningsappens namn och en varningsdialogruta om att implementeringen av anslutningsappen kan komma att ändras.
LearnMoreUrl text (valfritt) Url till webbplats som innehåller mer information om den här datakällan eller anslutningsappen.
SupportsDirectQuery Logiska (valfritt) Aktiverar Direct Query för ditt tillägg.
SourceImage Post (valfritt) En post som innehåller en lista över binära bilder (hämtas från filnamnstillägget med metoden Extension.Contents ). Posten innehåller två fält (Icon16, Icon32), var och en med en egen lista. Varje ikon bör ha en annan storlek.
SourceTypeImage Post (valfritt) Liknar SourceImage, förutom konventionen för många out of the box-kopplingar är att visa en arkikon med den källspecifika ikonen i det nedre högra hörnet. Det är valfritt att ha en annan uppsättning ikoner för SourceTypeImage– många tillägg återanvänder helt enkelt samma uppsättning ikoner för båda fälten.