Jaa

Ensimmäisen liittimen luominen: Hei maailma

  • Artikkeli

Tämä malli tarjoaa yksinkertaisen tietolähdelaajennuksen, joka voidaan suorittaa Visual Studio Codessa ja ladata Power BI Desktopiin.

Hei maailma esimerkki

Seuraavassa esimerkissä näytetään yleiskatsaus:

  • Exporting-funktio (HelloWorld.Contents), joka ottaa asetustekstiparametrin.
  • Sellaisen tietolähteen määrittäminen, joka:
    • Ilmaisee, että se käyttää implisiittistä (anonyymiä) todennusta.
    • Käyttää merkkijonoresursseja, jotka mahdollistavat lokalisoinnin.
    • Käyttöliittymän metatietojen ilmoittaminen laajennuksen näyttämistä varten Power BI Desktopin Nouda tiedot -valintaikkunassa.

Luo PowerQuery SDK:n asentaminen -kohdan ohjeiden mukaisesti uusi liitin nimeltä "HelloWorld", kopioi se seuraavaan M-koodiin ja liitä se liitintyötilasi HelloWorld.pq-tiedostoon ja avaa se Power BI:ssä noudattamalla ohjeita.

Seuraavassa liittimen määrityksessä löydät:

  • section Lauseke.
  • Tietolähdefunktio, jonka metatiedot määrittävät sen tietolähteen määritykseksi käyttäen Kind HelloWorld - ja Publish-määritettä HelloWorld.Publish.
  • Tietue Authentication , joka ilmoittaa, että implisiittinen (anonyymi) on tämän lähteen ainoa todennustyyppi.
  • Julkaisutietue, jossa ilmoitetaan tämän yhteyden olevan beetaversio, resx-tiedostosta ladattava teksti, lähdekuva ja lähdetyypin kuva.
  • Tietue, joka liittää kuvakekoot tiettyihin PNG:iin koontikansiossa.
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") }
];

Kun olet luonut tiedoston ja kopioinut sen oikeaan hakemistoon, avaa Power BI noudattamalla ohjeita artikkelissa PowerQuery SDK -opetusohjelman asentaminen. Voit etsiä liittimen Nouda tiedot -valintaikkunasta hakusanalla "hei" .

Tämä vaihe tuo näkyviin todentamisvalintaikkunan. Koska todentamisasetuksia ei ole ja funktiossa ei ole parametreja, näissä valintaikkuneissa ei ole muita vaiheita.

Paina Näyttöyhteys ja valintaikkuna kertoo, että se on Esikatselu-liitin, koska Beta sen arvoksi on määritetty kyselyssä true. Koska todentamista ei ole, todennusnäytössä näkyy anonyymin todentamisen välilehti ilman kenttiä. Viimeistele Näyttöyhteys painamalla uudelleen.

Lopuksi kyselyeditori näyttää, mitä odotat – funktion, joka palauttaa tekstin "Hei maailma".

Jos haluat nähdä täysin toteutetun mallin, tutustu Hei maailma-malliin Data Näyttöyhteys ors -malli säilössä.