Uw eerste connector maken: Hallo wereld

Dit voorbeeld biedt een eenvoudige gegevensbronextensie die kan worden uitgevoerd in Visual Studio Code en kan worden geladen in Power BI Desktop.

voorbeeld van Hallo wereld

In dit voorbeeld ziet u als volgt:

• De functie Exporteren (HelloWorld.Contents), waarvoor een optietekstparameter wordt gebruikt.
• Een gegevensbrontype definiëren dat:
  • Declareert dat deze gebruikmaakt van impliciete (anonieme) verificatie.
  • Maakt gebruik van tekenreeksbronnen die lokalisatie mogelijk maken.
  • Metagegevens van de gebruikersinterface declareren, zodat de extensie kan worden weergegeven in het dialoogvenster Gegevens ophalen in Power BI Desktop.

Volg de instructies in Het installeren van de PowerQuery SDK, maak een nieuwe connector met de naam 'HelloWorld', kopieer de volgende M-code en plak deze in het bestand HelloWorld.pq van uw connectorwerkruimte en volg de rest van de instructies om deze te openen in Power BI.

In de volgende connectordefinitie vindt u:

• Een section verklaring.
• Een gegevensbronfunctie met metagegevens die deze als een gegevensbrondefinitie tot stand brengen met het type HelloWorld en publiceren HelloWorld.Publish.
• Een Authentication record die aangeeft dat impliciet (anoniem) het enige verificatietype voor deze bron is.
• Een publicatierecord die aangeeft dat deze verbinding zich in bèta bevindt, welke tekst moet worden geladen vanuit het resx-bestand, de bronafbeelding en de afbeelding van het brontype.
• Een record die pictogrammengrootten aan specifieke PNG's in de buildmap associeert.

section HelloWorld;
 
[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;
 
HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];
 
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") }
];

Nadat u het bestand hebt gemaakt en naar de juiste map hebt gekopieerd, opent u Power BI door de instructies te volgen in de zelfstudie Over het installeren van de PowerQuery SDK . U kunt zoeken naar 'hallo' om uw connector te vinden in het dialoogvenster Gegevens ophalen.

In deze stap wordt een verificatiedialoogvenster weergegeven. Omdat er geen verificatieopties zijn en de functie geen parameters gebruikt, zijn er geen verdere stappen in deze dialoogvensters.

Druk op Verbinding maken en in het dialoogvenster wordt aangegeven dat het een preview-connector is, omdat Beta deze is ingesteld op waar in de query. Omdat er geen verificatie is, geeft het verificatiescherm een tabblad weer voor anonieme verificatie zonder velden. Druk nogmaals op Verbinding maken om te voltooien.

Ten slotte wordt in de queryeditor weergegeven wat u verwacht: een functie die de tekst 'Hallo wereld' retourneert.

Zie het Hallo wereld voorbeeld in de voorbeeldopslagplaats Data Verbinding maken ors voor het volledig geïmplementeerde voorbeeld.