Hantera dataåtkomst

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.

• Web.Contents
• OData.Feed
• Odbc.DataSource
• AdoDotNet.DataSource
• OleDb.DataSource

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.

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.