Delen via

Beheren van Gegevenstoegang

Functies voor gegevensbronnen

Een gegevensconnector verpakt en past het gedrag van een gegevensbronfunctie in de M-bibliotheek aan. Een extensie voor een REST API maakt bijvoorbeeld gebruik van de functie Web.Contents om HTTP-aanvragen te maken. Op dit moment is een beperkte set gegevensbronfuncties ingeschakeld ter ondersteuning van uitbreidbaarheid.

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;

Soort gegevensbron

Functies die zijn gemarkeerd als shared in uw extensie, kunnen worden gekoppeld aan een specifieke gegevensbron door een DataSource.Kind letterlijk kenmerk op de functie op te nemen met de naam van een definitierecord voor de gegevensbron. De gegevensbronrecord definieert de verificatietypen die worden ondersteund door uw gegevensbron en basisinformatie over de huisstijl (zoals de weergavenaam/het label). De naam van het record wordt de unieke identifier.

Elke functie die aan dezelfde gegevensbron is gekoppeld, moet dezelfde vereiste functieparameters hebben, waaronder de naam, het type en de volgorde. (Voor doeleinden van gegevensbron soort wordt een parameter niet als vereist beschouwd als deze is gemarkeerd optional of als de metagegevens ervan DataSource.Path = false.)

Functies voor een specifiek gegevensbrontype kunnen alleen referenties gebruiken die aan dat type zijn gekoppeld. Referenties worden tijdens runtime geïdentificeerd door een zoekactie uit te voeren op basis van de combinatie van de vereiste parameters van de functie. Zie Gegevensbronpaden voor meer informatie over de identificatie van referenties.

Example:

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

Eigenschappen

De volgende tabel bevat de velden voor de definitierecord van de gegevensbron.

Veld Typologie Bijzonderheden
Authenticatie verslag / opname Hiermee geeft u een of meer typen verificatie op die worden ondersteund door uw gegevensbron. Er is ten minste één soort vereist. Elk type wordt weergegeven als een optie in de Power Query-referentieprompt. Zie Verificatietypen voor meer informatie.
Etiket Tekst (optioneel) Vriendelijke weergavenaam voor deze extensie in aanmeldingsvensters.
OndersteuntVersleuteling logisch (optioneel) Wanneer waar, biedt de gebruikersinterface de optie om verbinding te maken met de gegevensbron met behulp van een versleutelde verbinding. Dit wordt meestal gebruikt voor gegevensbronnen met een niet-versleuteld terugvalmechanisme (over het algemeen gebaseerd op ODBC of ADO.NET bronnen).

Publiceren naar gebruikersinterface

Net als bij de definitierecord van de gegevensbron biedt de publicatierecord de Power Query-gebruikersinterface de informatie die nodig is om deze extensie beschikbaar te maken in het dialoogvenster Gegevens ophalen .

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

Eigenschappen

De volgende tabel bevat de velden voor uw publicatierecord.

Veld Typologie Bijzonderheden
Knooptekst list Lijst met tekstelementen. Het eerste item definieert de naam die wordt weergegeven naast het pictogram van de gegevensbron in het dialoogvenster Gegevens ophalen in Power BI. Het tweede item (optioneel) definieert de tooltip die wordt weergegeven wanneer je met de muis over de voorgaande naam beweegt.
Categorie Tekst Waar de extensie moet worden weergegeven in het dialoogvenster Gegevens ophalen . Momenteel zijn de enige categoriewaarden met speciale verwerking Azure en Database. Alle andere waarden komen terecht in de categorie Overige.
Bèta logisch (optioneel) Als deze optie is ingesteld op true, wordt in de gebruikersinterface een preview-/bèta-id weergegeven naast de naam van uw connector en een waarschuwingsdialoogvenster waarin wordt aangegeven dat de implementatie van de connector onderhevig is aan wijzigingen die fouten veroorzaken.
LearnMoreUrl Tekst (optioneel) Url naar website met meer informatie over deze gegevensbron of connector.
Ondersteunt DirectQuery logisch (optioneel) Hiermee schakelt u Direct Query in voor uw extensie.
SourceImage verslag / opname (optioneel) Een record met een lijst met binaire afbeeldingen (afkomstig uit het extensiebestand met behulp van de methode Extension.Contents). De record bevat twee velden (Icon16, Icon32), elk met een eigen lijst. Elk pictogram moet een andere grootte hebben.
BronTypeAfbeelding verslag / opname (optioneel) Vergelijkbaar met SourceImage, behalve dat voor veel standaardconnectoren de conventie is om een bladpictogram weer te geven met het bronspecifieke pictogram in de rechterbenedenhoek. Het gebruik van een andere set pictogrammen voor SourceTypeImage is optioneel. Veel extensies gebruiken gewoon dezelfde set pictogrammen voor beide velden.
  • Last updated on