Jaa

Tietojen käyttöoikeuksien käsittely

  • Artikkeli

Tietolähdefunktiot

Tietojen Näyttöyhteys tai rivittää ja mukauttaa tietolähdefunktion toimintaa M-kirjastossa. Esimerkiksi REST-ohjelmointirajapinnan laajennus käyttää Web.Contents-funktiota HTTP-pyyntöjen tekemiseen. Tällä hetkellä laajennettavuuden tukemiseksi on otettu käyttöön rajoitettu joukko tietolähdefunktioita.

Esimerkki:

[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;

Tietolähteen laji

Laajennuksessa merkityt shared funktiot voidaan liittää tiettyyn tietolähteeseen sisällyttämällä funktioon literaalimäärite DataSource.Kind ja Tietolähteen määritystietueen nimi. Tietolähde-tietue määrittää tietolähteen tukemat todennustyypit ja perusmerkintätiedot (kuten näyttönimen tai selitteen). Tietueen nimestä tulee sen yksilöivä tunniste.

Jokaisella samaan tietolähteeseen liittyvällä funktiolla on oltava samat vaaditut funktioparametrit, kuten nimi, tyyppi ja järjestys. (Tietolähteen lajia varten parametria ei pidetä pakollisena, jos se on merkitty optional tai jos sen metatiedot sisältävät DataSource.Path = false.)

Tietyn tietolähdelajin funktiot voivat käyttää vain kyseiseen lajiin liittyviä tunnistetietoja. Tunnistetiedot tunnistetaan suorituksen aikana tekemällä haku funktion vaadittujen parametrien yhdistelmän perusteella. Lisätietoja tunnistetietojen tunnistamisesta on kohdassa Tietolähdepolut.

Esimerkki:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

Ominaisuudet

Seuraavassa taulukossa luetellaan tietolähteen määritystietueen kentät.

Field Tyyppi Tiedot
Todentaminen Tietueen Määrittää yhden tai useamman todentamistyypin, jota tietolähteesi tukee. Vähintään yksi laji vaaditaan. Kaikki lajit näytetään vaihtoehtoina Power Queryn tunnistetietokehotteessa. Lisätietoja on kohdassa Todennuslajit.
Otsikko teksti (valinnainen) Tämän laajennuksen kutsumanimi tunnistetietojen valintaikkuneissa.
SupportsEncryption Looginen (valinnainen) Kun arvo on tosi, käyttöliittymä näyttää asetuksen yhteyden muodostamiseksi tietolähteeseen salatulla yhteydellä. Tätä käytetään yleensä tietolähteissä, joissa ei ole salattua varamekanismia (yleensä ODBC tai ADO.NET perustuvat lähteet).

Julkaise käyttöliittymään

Tietolähteen määritystietueen tavoin Julkaise-tietue tarjoaa Power Query -käyttöliittymälle tiedot, joita se tarvitsee tämän laajennuksen paljastamiseen Nouda tiedot -valintaikkunassa.

Esimerkki:

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") }
];

Ominaisuudet

Seuraavassa taulukossa on luettelo Julkaise-tietueen kentistä.

Field Tyyppi Tiedot
ButtonText list Luettelo tekstikohteista. Ensimmäinen kohde määrittää nimen, joka näytetään tietolähteen kuvakkeen vieressä Power BI :n Nouda tiedot -valintaikkunassa. Toinen kohde (valinnainen) määrittää työkaluvihjeen, joka näytetään, kun edellinen nimi on hiiren osoitin päällä.
Luokka teksti Missä laajennuksen tulisi näkyä Nouda tiedot -valintaikkunassa. Tällä hetkellä ainoat erityiskäsitteen sisältävät luokka-arvot ovat Azure ja Database. Kaikki muut arvot päätyvät Muut-luokkaan.
Beta Looginen (valinnainen) Kun arvo on tosi, käyttöliittymä näyttää liittimen nimen vieressä esikatselu-/beetatunnisteen ja varoituksen siitä, että liittimen toteutukseen saattaa tulla rikkovia muutoksia.
LearnMoreUrl teksti (valinnainen) Url-osoite verkkosivustoon, joka sisältää lisätietoja tästä tietolähteestä tai liittimestä.
SupportsDirectQuery Looginen (valinnainen) Ottaa käyttöön suoran kyselyn laajennukseen.
SourceImage Tietueen (valinnainen) Tietue, joka sisältää luettelon binaari kuvista (lähde tunnistetiedostosta käyttämällä Extension.Contents-menetelmää ). Tietue sisältää kaksi kenttää (Icon16, Icon32), joilla kummallakin on oma luettelonsa. Kunkin kuvakkeen on oltava erikokoinen.
SourceTypeImage Tietueen (valinnainen) SourceImage-ominaisuuden tapaan, lukuun ottamatta käytäntöä, jonka mukaan monien kehikon liitinten tapauksessa näytetään taulukkokuvake, jonka oikeassa alakulmassa on lähdekohtainen kuvake. Eri kuvakejoukko SourceTypeImage-asetukselle on valinnainen – monissa laajennuksista käytetään vain samoja kuvakkeita uudelleen molemmille kentille.