Del via

Opprette din første kobling: Hello World

  • Artikkel

Dette eksemplet gir en enkel datakildeutvidelse som kan kjøres i Visual Studio Code og lastes inn i Power BI Desktop.

Hello World-eksempel

Som en oversikt viser dette eksemplet:

  • Eksporteringsfunksjon (HelloWorld.Contents), som tar en alternativtekstparameter.
  • Definere en datakildetype som:
    • Erklærer at den bruker implisitt (anonym) godkjenning.
    • Bruker strengressurser som tillater lokalisering.
    • Deklarer grensesnittmetadata slik at utvidelsen kan vises i dialogboksen Hent data i Power BI Desktop.

Følg instruksjonene i installering av PowerQuery SDK, opprett en ny kobling kalt "HelloWorld", kopier i følgende M-kode og lim den inn i HelloWorld.pq-filen i koblingsarbeidsområdet, og følg deretter resten av instruksjonene for å kunne åpne den i Power BI.

I følgende koblingsdefinisjon finner du:

  • En section setning.
  • En datakildefunksjon med metadata som etablerer den som en datakildedefinisjon med Type HelloWorld og Publiser HelloWorld.Publish.
  • En Authentication post som deklarerer at implisitt (anonym) er den eneste godkjenningstypen for denne kilden.
  • En publiseringspost deklarerer at denne tilkoblingen er i Beta, hvilken tekst som skal lastes inn fra resx-filen, kildebildet og kildetypebildet.
  • En post som knytter ikonstørrelser til bestemte PNG-er i build-mappen.
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 kopiert den til riktig katalog, følger du instruksjonene i installering av PowerQuery SDK-opplæringen , og åpner Power BI. Du kan søke etter «hallo» for å finne koblingen i dialogboksen Hent data .

Dette trinnet viser en dialogboks for godkjenning. Siden det ikke finnes godkjenningsalternativer og funksjonen ikke tar noen parametere, finnes det ingen ytterligere trinn i disse dialogboksene.

Trykk Koble til, og dialogboksen forteller deg at det er en forhåndsvisningskobling siden Beta den er satt til sann i spørringen. Siden det ikke er godkjenning, viser godkjenningsskjermen en fane for anonym godkjenning uten felt. Trykk Koble til på nytt for å fullføre.

Til slutt vises redigeringsprogrammet for spørringen som viser hva du forventer – en funksjon som returnerer teksten «Hello world».

Hvis du vil se det fullstendig implementerte eksemplet, kan du se eksempeleksemplet Hello World i eksempelrepo for data Koble til orer.