Skapa din första anslutningsapp: Hello World

Det här exemplet innehåller ett enkelt datakällans tillägg som kan köras i Visual Studio Code och läsas in i Power BI Desktop.

Hello World-exempel

Som en översikt visar det här exemplet:

• Exporterar funktionen (HelloWorld.Contents), som tar en alternativtextparameter.
• Definiera en typ av datakälla som:
  • Deklarerar att den använder implicit (anonym) autentisering.
  • Använder strängresurser som tillåter lokalisering.
  • Deklarera metadata för användargränssnittet så att tillägget kan visas i dialogrutan Hämta data i Power BI Desktop.

Följ anvisningarna i Installera PowerQuery SDK, skapa en ny anslutningsapp med namnet "HelloWorld", kopiera följande M-kod och klistra in den i HelloWorld.pq-filen för anslutningsarbetsytan och följ sedan resten av instruktionerna för att kunna öppna den i Power BI.

I följande anslutningsdefinition hittar du:

• En section instruktion.
• En datakällans funktion med metadata som etablerar den som en datakälladefinition med sorten HelloWorld och publicera HelloWorld.Publish.
• En Authentication post som förklarar att implicit (anonym) är den enda autentiseringstypen för den här källan.
• En publiceringspost som förklarar att anslutningen finns i Beta, vilken text som ska läsas in från resx-filen, källbilden och källtypsbilden.
• En post som associerar ikonstorlekar med specifika PNG:er i byggmappen.

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 skapat filen och kopierat den till rätt katalog öppnar du Power BI genom att följa anvisningarna i Installera PowerQuery SDK-självstudien . Du kan söka efter "hello" för att hitta anslutningsappen i dialogrutan Hämta data .

Det här steget innehåller en dialogruta för autentisering. Eftersom det inte finns några autentiseringsalternativ och funktionen inte tar några parametrar finns det inga ytterligare steg i dessa dialogrutor.

Tryck på Anslut och dialogrutan anger att det är en "förhandsversionsanslutning", eftersom Beta är inställd på sant i frågan. Eftersom det inte finns någon autentisering visar autentiseringsskärmen en flik för anonym autentisering utan fält. Tryck på Anslut igen för att slutföra.

Slutligen visas frågeredigeraren som visar vad du förväntar dig – en funktion som returnerar texten "Hello world".

Det fullständigt implementerade exemplet finns i Hello World-exemplet på lagringsplatsen Data Anslut ors.