Opetusohjelma: Power BI -sisällön upottaminen käyttämällä mallisovellusta Upottaminen organisaatiollesi

Upotetun Power BI -analytiikan avulla voit upottaa Power BI -sisältöä, kuten raportteja, koontinäyttöjä ja ruutuja, sovellukseesi.

Tässä opetusohjelmassa opit:

  • Määrittämään upotetun ympäristösi.
  • Määritä upotus organisaatiollesi (tunnetaan myös mallisovelluksena käyttäjä omistaa tiedot).

Käyttäjien on kirjauduttava sisään Power BI:hin, jotta he voivat käyttää sovellustasi.

Upottaminen organisaatiollesi -ratkaisua käyttävät yleensä suuryritykset ja suuret organisaatiot, ja se on tarkoitettu sisäisille käyttäjille.

Tärkeä

Jos upotat sisältöä kansalliseen/alueelliseen pilvipalveluun, tämän opetusohjelman ensimmäiset vaiheet ovat erilaisia. Katso lisätietoja artikkelista Kansallisten/alueellisten pilvipalveluiden sisällön upottaminen.

Koodimallimääritykset

Tämä opetusohjelma sisältää ohjeet Upottaminen organisaatiollesi -mallisovelluksen määrittämiseen jossakin seuraavista toimintakehyksistä:

  • .NET Framework
  • .NET Ydin
  • React TypeScript

Huomautus

.NET Core- ja .NET Framework-mallien avulla loppukäyttäjä voi tarkastella mitä tahansa Power BI -koontinäyttöä, raporttia tai ruutua, johon hänellä on käyttöoikeus Power BI -palvelussa. React TypeScript -mallin avulla voit upottaa vain yhden raportin, johon loppukäyttäjällä on jo käyttöoikeus Power BI -palvelussa.

Koodinäytteet tukevat seuraavia selaimia:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Edellytykset

Ennen kuin aloitat tämän opetusohjelman, varmista, että sinulla on sekä seuraavat Power BI- että koodiriippuvuudet:


Metodi

Jos haluat luoda upotuksen organisaatiollesi -mallisovelluksen, toimi seuraavasti:

  1. Rekisteröi Microsoft Entra -sovellus.

  2. Luo Power BI -työtila.

  3. Luo ja julkaise Power BI -raportti.

  4. Hae upotusparametriarvot.

  5. Upota sisältö.

Vaihe 1 – Rekisteröi Microsoft Entra -sovellus

Kun rekisteröit sovelluksesi Microsoft Entra -tunnuksella, voit määrittää sovelluksen käyttäjätiedot.

Rekisteröi sovelluksesi Microsoft Entra -tunnuksella noudattamalla ohjeita kohdassa Rekisteröi sovelluksesi.

Vaihe 2 – Luo Power BI -työtila

Microsoft Fabric säilyttää raportit, koontinäytöt ja ruudut työtilassa. Jos haluat upottaa nämä kohteet, sinun on luotava ne ja ladattava ne työtilaan.

Vihje

Jos sinulla on jo työtila, voit ohittaa tämän vaiheen.

Voit luoda työtilan seuraavasti:

  1. Kirjaudu sisään Fabriciin.

  2. Valitse Työtilat.

  3. Valitse + Uusi työtila.

  4. Nimeä työtilasi ja valitse Tallenna.

Vaihe 3 – Luo ja julkaise Power BI -raportti

Seuraava vaihe on raportin luominen ja lataaminen työtilaan. Voit luoda oman raportin käyttämällä Power BI Desktopia ja sitten julkaista sen työtilaasi. Voit myös ladata malliraportin työtilaasi.

Vihje

Jos sinulla on jo työtila raportin kanssa, voit ohittaa tämän vaiheen.

Jos haluat ladata malliraportin ja julkaista sen työtilaan, toimi seuraavasti:

  1. Avaa GitHubin Power BI Desktop -mallit -kansio.

  2. Valitse Koodi ja valitse sitten Lataa zip.

    Näyttökuva, jossa näkyy ZIP-latausvaihtoehto Power BI Desktop -mallien GitHubissa

  3. Poimi ladattu ZIP-tiedosto ja siirry Malliraportit-kansioon.

  4. Valitse upotettava raportti ja julkaise se työtilaasi.

Vaihe 4 – Hae upotusparametriarvot

Jos haluat upottaa sisältösi, tarvitset muutamia parametriarvoja. Parametriarvot riippuvat käytettävän mallisovelluksen kielestä. Alla olevassa taulukossa luetellaan, mitä parametriarvoja kullekin näytteelle vaaditaan.

Parametri .NET Ydin .NET Framework React TypeScript
Asiakkaan tunnus
Asiakasohjelman salasana
Työtilan tunnus
Raporttitunnus

Client ID

Vihje

Koskee seuraavia: .NET Core .NET Framework React TypeScript

Jos haluat saada asiakastunnuksen yksilöivän tunnisteen (tunnetaan myös sovellustunnuksena), toimi seuraavasti:

  1. Kirjaudu Microsoft Azureen.

  2. Etsi Sovelluksen rekisteröinnit ja valitse Sovelluksen rekisteröinnit -linkki.

  3. Valitse Microsoft Entra -sovellus, jota käytät Power BI -sisällön upottamiseen.

  4. Kopioi Yleiskatsaus-osiosta yksilöivä tunniste Sovelluksen (asiakkaan) tunnus.

Asiakasohjelman salaisuus

Vihje

Koskee seuraavia: .NET Core .NET Framework React TypeScript

Saat asiakassalaisuuden seuraavasti:

  1. Kirjaudu Microsoft Azureen.

  2. Etsi Sovelluksen rekisteröinnit ja valitse Sovelluksen rekisteröinnit -linkki.

  3. Valitse Microsoft Entra -sovellus, jota käytät Power BI -sisällön upottamiseen.

  4. Valitse Hallinta-kohdasta Varmenteet ja salaisuudet.

  5. Valitse Asiakassalaisuudet -kohdasta Uusi asiakassalaisuus.

  6. Anna Lisää asiakassalaisuus -ponnahdusikkunassa sovellussalaisuuden kuvaus, valitse milloin sovellussalaisuus vanhentuu ja valitse Lisää.

  7. Kopioi Asiakassalaisuudet-osiosta juuri luodun sovellussalaisuuden Arvo-sarakkeesta merkkijono. Asiakassalaisuuden arvo on asiakastunnuksesi.

Huomautus

Kopioi asiakasohjelman salasana-arvo, kun se tulee ensimmäisen kerran näkyviin. Kun siirryt pois tältä sivulta, asiakassalaisuus piilotetaan etkä pysty noutamaan sen arvoa.

Työtilan tunnus

Vihje

Koskee seuraavia: .NET Core .NET Framework React TypeScript

Jos haluat saada työtilan yksilöivän tunnisteen, toimi seuraavasti:

  1. Kirjaudu Power BI -palveluun.

  2. Avaa upotettava raportti.

  3. Kopioi YKSILÖIVÄ tunnus URL-osoitteesta. Yksilöivä tunnus on luku /groups/ - ja /reports/-tunnusten välistä.

    Näyttökuva, jossa näkyy työtilan yksilöivä tunniste Power BI -palvelun URL-osoitteessa

Raportin tunnus

Vihje

Koskee seuraavia: .NET Core .NET Framework ReactTypeScript

Jos haluat saada raporttitunnuksen yksilöivän tunnisteen, toimi seuraavasti:

  1. Kirjaudu Power BI -palveluun.

  2. Avaa upotettava raportti.

  3. Kopioi YKSILÖIVÄ tunnus URL-osoitteesta. Yksilöivä tunnus on luku /reports/ - ja /ReportSection-arvojen välillä.

    Näyttökuva, jossa näkyy raportin yksilöivä tunniste Power BI -palvelun URL-osoitteessa

Vaihe 5 – Upota sisältö

Power BI Embedded -mallisovelluksen avulla voit luoda Upottaminen organisaatiollesi Power BI -sovelluksen.

Näiden ohjeiden avulla voit muokata Organisaatiolle tarkoitettu upotus -mallisovellusta ja upottaa Power BI -raportin.

  1. Avaa kansio Power BI:n kehittäjämallit .

  2. Valitse Koodi ja valitse sitten Lataa zip.

    Näyttökuva, jossa näkyy ZIP-latausvaihtoehto Power BI -kehittäjämallien GitHubissa

  3. Poimi ladattu ZIP-tiedosto ja siirry PowerBI-Developer-Samples-master-kansioon .

  1. Avaa jokin seuraavista kansioista sen mukaan, mitä kieltä haluat sovelluksesi käyttävän:

    • .NET Ydin
    • .NET Framework
    • React-TS

    Huomautus

    Upottaminen organisaatiollesi -mallisovellukset tukevat vain aiemmin lueteltuja sovelluskehyksiä. Java-, Node JS- ja Python-mallisovellukset tukevat vain Upottaminen asiakkaillesi -ratkaisua.

Microsoft Entra -sovelluksen määrittäminen

  1. Kirjaudu Azure-portaaliin.

  2. Valitse Sovelluksen rekisteröinnit. Jos et näe tätä vaihtoehtoa, etsi se.

  3. Avaa Microsoft Entra -sovellus, jonka loit vaiheessa 1 – Rekisteröi Microsoft Entra -sovellus.

  4. Valitse Hallinta-valikosta Todentaminen.

  1. Avaa Käyttöympäristön kokoonpano -kohdassa verkkoympäristö ja lisää https://localhost:5000/signin-oidcosioon Uudelleenohjauksen URI-osoitteet .

    Huomautus

    Jos sinulla ei ole verkkoympäristöä, valitse Lisää ympäristö ja valitse Määritä ympäristöt -ikkunassa Verkko.

  2. Tallenna tekemäsi muutokset.

Azure-portaali-ikkunan näyttökuva, jossa näkyvät sovelluksen todennusmääritykset ja .NET-ydinsovellusmallin verkko-uudelleenohjauksen URI-osoite.

Upotussovelluksen määrittäminen

  1. Avaa organisaatiolle tarkoitettu upotus.

  2. Avaa Upottaminen organisaatiollesi -mallisovellus jollakin seuraavista menetelmistä:

  3. Avaa appsettings.json ja täytä seuraavat parametriarvot:

Mallisovelluksen suorittaminen

  1. Suorita projekti valitsemalla sopiva vaihtoehto:

    • Jos käytät Visual Studiota, valitse IIS Express (toista).

    • Jos käytät Visual Studio -koodia, valitse Suorita > virheenkorjaus.

  1. Kirjaudu sisään upottavan mallisovelluksen.

    Huomautus

    Ensimmäisen sisäänkirjautumisesi aikana sinua pyydetään sallimaan Microsoft Entra -käyttöoikeudet sovellukseen.

  2. Kun upotusmallisovellus latautuu, valitse upotettava Power BI -sisältö ja valitse sitten Upota.

    Näyttökuva, jossa näkyy Power BI:n upotuksen mallisovellus.

Kehitä sovelluksesi

Kun olet määrittänyt ja suoritat mallisovelluksen Upota asiakkaillesi , voit alkaa kehittää omaa sovellustasi.

Käyttäjien käyttöoikeuksien päivittäminen

Käyttäjillä on oltava raportin sisältävän Power BI -kansion käyttöoikeus. Kun myönnät käyttäjälle oikeuden käyttää kansiota, muutos tulee yleensä voimaan vasta, kun käyttäjä on kirjautunut sisään Power BI -portaaliin. Jotta uudet käyttöoikeudet tulevat voimaan heti, anna Embedded-skenaariossa eksplisiittinen kutsu RefreshUser Permissions REST -ohjelmointirajapintaan käynnistyksen yhteydessä. Tämä ohjelmointirajapinnan kutsu päivittää käyttöoikeudet ja välttää valtuutusvirheet käyttäjille, joilla on äskettäin myönnetyt käyttöoikeudet.

Kysy Power BI -yhteisöltä