Uw eerste connector maken: Hallo wereld

Hallo wereld voorbeeld

Dit voorbeeld biedt een eenvoudige gegevensbronextensie die kan worden uitgevoerd in Visual Studio en in een Power BI Desktop. In dit voorbeeld ziet u het volgende:

  • De exportfunctie ( HelloWorld.Contents ), die een optietekstparameter gebruikt.
  • Het definiëren van een soort gegevensbron dat:
    • Geeft aan dat impliciete (anonieme) verificatie wordt gebruikt.
    • Maakt gebruik van tekenreeksbronnen die lokalisatie mogelijk maken.
    • Het declareren van ui-metagegevens zodat de extensie kan worden weergegeven in het dialoogvenster Power BI Desktop gegevens op te halen.

Volg de instructies in De PowerQuery SDKinstalleren, maak een nieuw project met de naam 'HelloWorld' en kopieer de volgende M-code en volg de rest van de instructies om het te kunnen openen in PowerBI.

In de volgende connectordefinitie vindt u:

  • Een section -instructie.
  • Een gegevensbronfunctie met metagegevens die deze als gegevensbrondefinitie tot stand brengt met De soort HelloWorld en HelloWorld.Publish Publiceren.
  • Een Authentication record waarin wordt aangegeven dat impliciet (anoniem) het enige verificatietype voor deze bron is.
  • Een publicatierecord waarin wordt aangegeven dat deze verbinding in bèta is, welke tekst moet worden geladen uit het RESX-bestand, de bronafbeelding en de afbeelding van het brontype.
  • Een record die pictogramgrootten aan specifieke PNG's in de buildmap koppelen.
 
[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 PowerBI volgens de instructies in De PowerQuery SDK-zelfstudie installeren. U kunt zoeken naar Hallo om uw connector te vinden in het dialoogvenster Gegevens verzamelen.

Met 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 Verbinding maken het dialoogvenster geeft aan dat het een preview-connector is, omdat is ingesteld op Beta true in de query. Omdat er geen verificatie is, wordt in het verificatiescherm een tabblad voor anonieme verificatie zonder velden weergegeven. Druk Verbinding maken opnieuw om te voltooien.

Ten slotte wordt in de query-editor weergegeven wat u verwacht van een functie die de tekst — 'Hallo wereld' retourneert.

Zie voor het volledig geïmplementeerde voorbeeld de Hallo wereld voorbeeld in de voorbeeld-repo voor gegevensconnectoren.