Power BI -ruutu -ohjausobjekti Power Appsissa

Ohjausobjekti, joka näyttää Power BI -ruudun sovelluksessa.

Eikö sinulla ole Power BI:tä? Rekisteröityminen

Kuvaus

Hyödynnä olemassa olevaa tietojen analysointia ja raportointia näyttämällä Power BI tile -ruutuja sovelluksissasi. Määritä ruutu, jonka haluat näyttää, määrittämällä sen Workspace-, Dashboard- ja Tile-ominaisuudet valintapaneelin Tiedot-välilehdessä.

Huomautus

• Power BI -ruutu -ohjausobjekti ei ole käytettävissä GCC High- ja DoD-ympäristöissä.
• Power BI ruutu -ohjausobjekti ei ole käytettävissä Kiinassa.
• Lisätietoja käyttöoikeusvaatimuksista Power BI -ruudun upotuksen yhteydessä on kohdassa Käyttöoikeudet.

Jakaminen ja suojaus

Kun jaat sovelluksen, jossa on Power BI -sisältöä, sinun on jaettava sovelluksen itsensä lisäksi myös koontinäyttö, josta ruutu saadaan. Muutoin Power BI -sisältö ei tule näkyviin niillekään käyttäjille, jotka avaavat sovelluksen. Sovellukset, joissa on Power BI -sisältöä, noudattavat kyseisen sisällön käyttöoikeuksia.

Suorituskyky

Yli kolmen Power BI -ruudun lataamista sovellukseen yhtä aikaa ei suositella. Voit hallita ruutujen lataamista ja poistamista muistista määrittämällä LoadPowerBIContent-ominaisuuden.

Upotuksen vaihtoehdot

Upottaminen on erilaista Power BI API -versioiden välillä. Uuden Power BI:n ohjelmointirajapinnan todentamismallin vuoksi ruutua ei ehkä voi käyttää mobiililaitteissa tai muissa upotetuissa skenaarioissa (Teamsissa tai SharePointissa).

Voit hallita API-version käyttöä AllowNewAPI-ominaisuuden avulla. Lisätietoja on kohdassa Tärkeimmät ominaisuudet.

AllowNewAPI-ominaisuuden arvo	Toiminta
Oikein	Voit upottaa koontinäytön, raportin tai ruudun ottamalla upotuksen URL-osoitteen Power BI:stä ja tekemällä siitä TileUrl-arvon.
Väärin	Voit upottaa koontinäytön ruudun joko ottamalla upotuksen URL-osoitteen :stä ja tekemällä siitä TileUrl-arvon, tai käyttämällä annettua graafista käyttöliittymää.

Huomautus

Power BI:n URL-osoitteen upottamista (esimerkiksi IFrameen) ei tueta Power Apps Mobilessa, koska Power BI:n URL-pyynnön todennusta ei käsitellä mobiilin toistimen toimesta.

Suodatus

Suodatus eroaa Power BI -ohjelmointirajapinnan versioiden välillä. Katso alla olevat osat sen mukaan, miten ohjausobjekti määritetään.

Kun käytät uutta ohjelmointirajapintaa Power BI -palvelun kutsumiseen

Kun AllowNewAPI-ominaisuuden arvoksi on määritetty Tosi, käytät uutta ohjelmointirajapintaa Power BI -palvelun kutsumiseksi. Lisätietoja: Raportin suodattaminen käyttämällä URL-osoitteessa kyselymerkkijonon parametreja.

Kun käytät alkuperäistä ohjelmointirajapintaa Power BI -palvelun kutsumiseen

Kun AllowNewAPI-ominaisuuden arvoksi on määritetty Epätosi, käytät alkuperäistä ohjelmointirajapintaa Power BI -palvelun kutsumiseksi. Tässä tapauksessa välittämällä sovelluksesta yhden parametrin voit suodattaa Power BI -ruudussa näkyvät tulokset. Kuitenkin vain merkkijonoarvoja ja yhtä suuri kuin -operaattoria tuetaan, eikä suodatin välttämättä toimi, jos taulukon tai sarakkeen nimessä on välilyöntejä.

Jos haluat välittää yksittäisen suodatinarvon, muokkaa TileURL-ominaisuuden arvoa, jonka syntaksi on seuraava:

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

Lisää tähän arvoon seuraava syntaksi:

&$filter=<TableName>/<ColumnName> eq '<Value>'

Esimerkiksi luetteloruudun arvon käyttäminen:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

Parametri suodattaa raportin tietojoukon arvon, josta ruutu on peräisin. Suodatusominaisuudella on kuitenkin seuraavat rajoitukset:

• Vain yhtä suodatinta voi käyttää.
• Vain eq-operaattoria tuetaan.
• Kenttätyypin on oltava merkkijono.
• Suodatus on käytettävissä vain kiinnitetyissä visualisointiruuduissa. Sitä ei tueta kiinnitetyissä raporteissa.
• R- ja Python-komentosarjojen visuaalisia tehosteita ei voi suodattaa.

Power BI -raportin laskettujen kenttien avulla voit muuntaa muita arvotyyppejä merkkijonoiksi tai yhdistää useita kenttiä yhdeksi.

Tärkeimmät ominaisuudet

AllowNewAPI – Valinta, käytetäänkö uutta ohjelmointirajapintaa Power BI -palvelun kutsumiseen. Kun arvoksi määritetään Tosi, uutta Power BI -ohjelmointirajapintaa voidaan käyttää. (Sitä ei tueta mobiiliskenaarioissa eikä joissain upotetuissa skenaarioissa, mutta tietty lisäsuodatus on mahdollista). Epätosi käyttää alkuperäistä ohjelmointirajapintaa. Oletusarvo on epätosi.

Dashboard – Power BI -koontinäyttö, josta ruutu on peräisin.

LoadPowerBIContent – Kun asetuksena on Tosi, Power BI -sisältö ladataan ja näytetään. Kun arvo on Epätosi, Power BI -sisältö poistetaan, mikä vapauttaa muistia ja optimoi suorituskyvyn.

PowerBIInteractions – Kun arvoksi on määritetty Tosi, Power BI -sisältöä voidaan käsitellä, mutta Power Appsin OnSelect-tapahtuma ei käynnisty. Kun arvoksi on määritetty Epätosi, ruutua ei voi käsitellä, mutta Power Appsin OnSelect-tapahtuma käynnistyy, kun ruutu valitaan.

Tile – Näytettävän Power BI -ruudun nimi.

Workspace – Power BI -työtila, josta ruutu on peräisin.

Lisäominaisuudet

BorderColor – Ohjausobjektin reunan väri.

BorderStyle – Onko ohjausobjektin reuna Yhtenäinen, Katkoviiva, Pisteviiva vai Ei mitään.

BorderThickness – Ohjausobjektin reunan paksuus.

DisplayMode – Salliiko ohjausobjekti käyttäjän syötettä (Muokkaa), vain tietojen tarkastelun (Näytä) vai onko se poissa käytöstä (Poistettu käytöstä).

Height – Ohjausobjektin ylä- ja alareunan välinen etäisyys.

OnSelect – Toiminnot, jotka tulee suorittaa, kun käyttäjä valitsee ohjausobjektin. Tileun liittyvä Power BI -raportti avautuu oletusarvoisesti.

TileUrl – URL-osoite, jota käyttämällä ruutu pyydetään Power BI -palvelusta. Lisätietoja kyselymerkkijonosuodatuksen lisäämisestä URL-osoitteeseen on yllä olevassa Suodatus-osassa.

Visible – Onko ohjausobjekti näkyvissä vai piilossa.

Width – Ohjausobjektin vasemman ja oikean reunan välinen etäisyys.

X– Ohjausobjektin vasemman reunan ja pääsäilön (tai näytön, jos pääsäilöä ei ole) vasemman reunan välinen etäisyys.

Y – Ohjausobjektin yläreunan ja pääsäilön (tai näytön, jos pääsäilöä ei ole) yläreunan välinen etäisyys.

Esimerkiksi

1. Avaa Lisää-välilehdessä Kaaviot-valikko ja lisää sitten Power BI -ruutu -ohjausobjekti.

   Etkö tiedä, miten ohjausobjekti lisätään ja määritetään?

2. Valitse Tiedot-välilehden asetuspaneelissa Työtila-asetukseksi Oma työtila.

3. Valitse jokin koontinäyttö koontinäyttöjen luettelossa ja valitse sitten ruutu ruutujen luettelossa.

   Ohjausobjekti hahmontaa Power BI -ruudun.

Helppokäyttötoimintojen ohjeet

Power BI tile on vain säilö Power BI -sisällölle. Opi luomaan helppokäyttöistä sisältöä näiden Power BI -helppokäyttötoimintojen vinkkien avulla.

Jos Power BI-sisällössä ei ole otsikkoa, voit lisätä otsikon Selite-ohjausobjektin avulla näytönlukuohjelmien tukea varten. Title voidaan sijoittaa välittömästi ennen Power BI -ruutua.

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).