Del via

Oprettelse af din første connector: Hello World

  • Artikel

Dette eksempel indeholder en enkel datakildeudvidelse, der kan køres i Visual Studio Code og indlæses i Power BI Desktop.

Hello World-eksempel

Som en oversigt viser dette eksempel:

  • Eksportfunktion (HelloWorld.Contents), som bruger en parameter for indstillingstekst.
  • Definition af en datakildetype, der:
    • Deklarerer, at den bruger implicit (anonym) godkendelse.
    • Bruger strengressourcer, der tillader lokalisering.
    • Erklæring af metadata for brugergrænsefladen, så udvidelsen kan vises i dialogboksen Hent data i Power BI Desktop.

Følg vejledningen i Installation af PowerQuery SDK, opret en ny connector med navnet "HelloWorld", kopiér følgende M-kode, og indsæt den i filen HelloWorld.pq i dit connectorarbejdsområde, og følg derefter resten af instruktionerne for at kunne åbne den i Power BI.

I følgende connectordefinition finder du:

  • En section sætning.
  • En datakildefunktion med metadata, der etablerer den som en datakildedefinition med Typen HelloWorld og Publicer HelloWorld.Publish.
  • En Authentication post, der erklærer, at implicit (anonym) er den eneste godkendelsestype for denne kilde.
  • En publiceringspost, der erklærer, at denne forbindelse er i beta, hvilken tekst der skal indlæses fra resx-filen, kildebilledet og kildetypebilledet.
  • En post, der knytter ikonstørrelser til bestemte PNGs i buildmappen.
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") }
];

Når du har bygget filen og kopieret den til den korrekte mappe, skal du åbne Power BI ved at følge vejledningen i Installation af PowerQuery SDK-selvstudiet . Du kan søge efter "hej" for at finde din connector i dialogboksen Hent data .

I dette trin vises en godkendelsesdialogboks. Da der ikke er nogen godkendelsesindstillinger, og funktionen ikke bruger nogen parametre, er der ingen yderligere trin i disse dialogbokse.

Tryk på Forbind, og dialogboksen fortæller dig, at det er en "eksempelconnector", da Beta er angivet til true i forespørgslen. Da der ikke er nogen godkendelse, viser godkendelsesskærmen en fane for anonym godkendelse uden felter. Tryk på Forbind igen for at afslutte.

Endelig vises forespørgselseditoren, der viser, hvad du forventer – en funktion, der returnerer teksten "Hello world".

Du kan se det fuldt implementerede eksempel i Eksempel på Hello World i lageret med eksempel på data Forbind orer.