Az adathozzáférés kezelése

Adatforrásfüggvények

Az Adat Csatlakozás or az M-kódtárban lévő adatforrásfüggvények viselkedését burkolja és testre szabja. Egy REST API-bővítmény például a Web.Contents függvényt használná HTTP-kérések céljából. Jelenleg az adatforrásfüggvények korlátozott halmaza lett engedélyezve a bővíthetőség támogatásához.

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

Példa

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

Adatforrás fajtája

A bővítményben megjelölt shared függvények egy adott adatforráshoz társíthatók úgy, hogy egy konstans attribútumot is belefoglalnak DataSource.Kind a függvénybe egy adatforrásdefiníciós rekord nevével. Az Adatforrás rekord határozza meg az adatforrás által támogatott hitelesítési típusokat, valamint az alapvető arculati információkat (például a megjelenítendő nevet/ címkét). A rekord neve egyedi azonosítóvá válik.

Az adatforráshoz társított összes függvénynek ugyanazokat a szükséges függvényparamétereket kell tartalmaznia, beleértve a nevet, a típust és a sorrendet. (Az adatforrás típusa szempontjából a paraméter nem tekinthető kötelezőnek, ha megjelölve optional van, vagy ha a metaadatai tartalmazzák DataSource.Path = false.)

Egy adott adatforrástípus függvényei csak az adott típushoz társított hitelesítő adatokat használhatják. A hitelesítő adatok futásidőben azonosíthatók a függvény szükséges paramétereinek kombinációján alapuló keresés végrehajtásával. A hitelesítő adatok azonosításáról további információt az adatforrás elérési útjai című témakörben talál.

Példa

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

Tulajdonságok

Az alábbi táblázat az adatforrásdefiníciós rekord mezőit sorolja fel.

Közzététel felhasználói felületen

Az Adatforrás definíciós rekordjához hasonlóan a Közzététel rekord biztosítja a Power Query felhasználói felületének azokat az információkat, amelyekre szüksége van a bővítmény közzétételéhez az Adatok lekérése párbeszédpanelen.

Példa

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

Tulajdonságok

Az alábbi táblázat a Publish rekord mezőit sorolja fel.