Jaa kautta

Tietojen käsittely

Tietolähdefunktiot

Data Connector käärii ja muokkaa tietolähdefunktion käyttäytymistä M-kirjastossa. Esimerkiksi REST-rajapinnan laajennus hyödyntäisi Web.Contents-funktiota HTTP-pyyntöjen tekemiseen. Tällä hetkellä rajoitettu määrä tietolähdetoimintoja on otettu käyttöön laajennettavuuden tukemiseksi.

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ähdetyyppi

Funktiot, jotka on merkitty laajennuksessasi, shared voidaan liittää tiettyyn tietolähteeseen lisäämällä funktioon kirjaimellinen DataSource.Kind attribuutti ja Data Source -määrittelytietueen nimi. Data Source -tietue määrittelee lähteesi tukemat todennustyypit sekä perusbränditiedot (kuten näyttönimi / etiketti). Tietueen nimestä tulee sen yksilöllinen tunniste.

Jokaisella samaan tietolähteeseen liitetyllä funktiolla on oltava samat vaaditut funktioparametrit, kuten nimi, tyyppi ja järjestys. (Data Source Kindin tarkoituksessa parametria ei pidetä tarpeellisena, 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ä tunnuksia. Tunnistetiedot tunnistetaan suoritusaikana tekemällä haku funktion vaadittujen parametrien yhdistelmän perusteella. Lisätietoja tunnistetietojen tunnistamisesta löytyy kohdasta Data Source Paths.

Esimerkki:

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

Ominaisuudet

Seuraavassa taulukossa on lueteltu kentät tietolähdemäärittelytietueellesi.

Field Tyyppi Yksityiskohdat
Todennus tietue Määrittelee yhden tai useamman tietolähteesi tukeman tunnistautumistyypin. Vähintään yksi laji vaaditaan. Jokainen tyyppi näytetään vaihtoehtona Power Query -tunnistetiedotteessa. Lisätietoja löytyy osoitteesta Authentication Types.
Etiketti lähetä tekstiviesti (valinnainen) Ystävällinen näyttönimi tälle laajennukselle tunnistevalintaikikkoissa.
Tuki Salaus looginen (valinnainen) Kun tämä on totta, käyttöliittymä tarjoaa mahdollisuuden yhdistää tietolähteeseen salatun yhteyden kautta. Tätä käytetään tyypillisesti tietolähteissä, joissa on salaamaton varajärjestelmä (yleensä ODBC- tai ADO.NET-pohjaiset lähteet).

Julkaise käyttöliittymään

Samoin kuin Data Source -määrittelytietue, Julkaise-tietue tarjoaa Power Query -käyttöliittymälle tiedot, joita tarvitaan tämän laajennuksen paljastamiseksi Get Data -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

Seuraava taulukko listaa Julkaisutietuesi kentät.

Field Tyyppi Yksityiskohdat
ButtonText lista Lista tekstialemoista. Ensimmäinen kohde määrittelee nimen, joka näkyy tietolähteen kuvakkeen vieressä Power BI Get Data -valintaikkunassa. Toinen kohta (valinnainen) määrittelee työkaluvihjeen, joka näytetään, kun edellinen nimi siirretään hiiren päälle.
Luokka lähetä tekstiviesti Missä laajennuksen tulisi näkyä Get Data -valintaikkunassa. Tällä hetkellä ainoat kategorian arvot, joissa on erikoiskäsittely, ovat Azure ja Database. Kaikki muut arvot päätyvät Toinen-kategoriaan.
Beeta looginen (valinnainen) Kun käyttöliittymä asetetaan true:ksi, käyttöliittymä näyttää Preview/Beta-tunnisteen liittimen nimen vieressä ja varoitusikkunan, että liittimen toteutukseen voi tulla muutoksia.
LearnMoreUrl lähetä tekstiviesti (valinnainen) URL verkkosivustolle, joka sisältää lisätietoja tästä tietolähteestä tai liittimestä.
SupportsDirectQuery looginen (valinnainen) Mahdollistaa suoran kyselyn laajennuksellesi.
LähdeKuva tietue (valinnainen) Tietue, joka sisältää listan binäärikuvista (joka on peräisin laajennustiedostosta Extension.Contents-menetelmällä ). Tietue sisältää kaksi kenttää (Icon16, Icon32), joilla kummallakin on oma listansa. Jokaisen ikonin pitäisi olla eri kokoinen.
LähdeTypeImage tietue (valinnainen) Samankaltainen kuin SourceImagessa, mutta monien valmiiden liittimien käytäntö on näyttää arkkikuvake, jonka oikeassa alakulmassa on lähdekohtainen kuvake. Erilainen kuvakejoukko SourceTypeImagelle on valinnainen—monet laajennukset käyttävät samaa kuvakejoukkoa molemmissa kentissä.
  • Last updated on