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:

• Power BI -riippuvuudet

  • Oma Microsoft Entra -vuokraaja.

    • Jokin seuraavista käyttöoikeuksista:

      • Power BI Pro

      • Käyttäjäkohtainen Premium (PPU)

    Huomautus

    Jos haluat siirtyä tuotantoon , tarvitset jonkin seuraavista määrityksistä:

    • Kaikki käyttäjät, joilla on Pro-käyttöoikeudet.
    • Kaikki käyttäjät, joilla on PPU-käyttöoikeudet.
    • SKU, joka vastaa tai on suurempi kuin F64-SKU. Tämän määrityksen avulla kaikilla käyttäjillä on maksuttomia käyttöoikeuksia.

• Koodiriippuvuudet

  .NET Core

  • .NET Core 3.1 SDK (tai uudempi)

  • Integroitu kehitysympäristö (IDE). Suosittelemme, että käytät yhtä seuraavista ide-tavoista:

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Tekstieditori

  • Komentorivin pääte (tai PowerShell)

---

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 (Direct Lake ei käytössä) ja julkaista sen työtilaasi, toimi seuraavasti:

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

2. Valitse Koodi ja valitse sitten Lataa zip.

   

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

   

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

   

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.

   

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

4. 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.

.NET Core

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.

5. Avaa Käyttöympäristön kokoonpano -kohdassa verkkoympäristö ja https://localhost:5000/signin-oidc .

   Huomautus

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

6. Tallenna tekemäsi muutokset.

Upotussovelluksen määrittäminen

1. Avaa organisaatiolle tarkoitettu upotus.

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

   • Jos käytät Visual Studiota, avaa UserOwnsData.sln tiedosto.

   • Jos käytät Visual Studio Codea, avaa UserOwnsData-kansio .

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

   • ClientId - Käytä asiakastunnuksen GUID-tunnusta

   • ClientSecret - Asiakassalaisuuden käyttäminen

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.

2. Kirjaudu sisään upottavan mallisovelluksen.

   Huomautus

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

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

   

.NET Framework

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.

5. Määritä Ympäristön kokoonpanot -toiminnossa seuraavat asetukset:

   1. Lisää verkkoympäristönhttps://localhost:44300/ -osioon .

      Huomautus

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

   2. Ota käyttöön Implisiittisten myöntämisen ja hybridityönkulkujen tunnukset -vaihtoehto.

6. Tallenna tekemäsi muutokset.

Upotussovelluksen määrittäminen

1. Avaa organisaatiolle tarkoitettu upotus.

2. Avaa UserOwnsData.sln tiedosto Visual Studion avulla.

3. Avaa Web.config ja täytä seuraavat parametriarvot:

   • clientId - Käytä asiakastunnuksen GUID-tunnusta

   • clientSecret - Asiakassalaisuuden käyttäminen

Mallisovelluksen suorittaminen

1. Suorita projekti valitsemalla IIS Express (toista).

2. Kirjaudu sisään upottavan mallisovelluksen.

   Huomautus

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

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

   

React TypeScript

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.

5. Määritä Ympäristömääritykset-kohdassa Verkkoympäristö seuraavasti:

   1. https://localhost:3000 -kohdassa Määritä.

      Huomautus

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

   2. Implisiittisen myöntämisen ja hybridityönkulun kohdalla molemmat vaihtoehdot ovat käytössä:

      • Käyttöoikeustietueet
      • Tunnustunnukset

6. Tallenna tekemäsi muutokset.

Upotussovelluksen määrittäminen

1. Avaa organisaatiollesi>tarkoitettu upotus UserOwnsData>src -kansio.

2. Avaa Config.ts-tiedosto tekstieditorin avulla ja täytä seuraavat parametriarvot:

   • clientId - Käytä asiakastunnuksen GUID-tunnusta

   • workspaceId- Työtilan tunnuksen käyttäminen

   • reportId- Raporttitunnuksen käyttäminen

3. Tallenna tiedosto.

Mallisovelluksen suorittaminen

1. Avaa pääte ja siirry kohtaan Upottaminen organisaatiollesi>UserOwnsData.

2. Asenna tarvittavat riippuvuudet antamalla seuraava komento:

   npm install

3. Suorita sovellus antamalla seuraava komento:

   npm run start

   Huomautus

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

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.

Liittyvä sisältö

• Opetusohjelma: Power BI -sisällön upottaminen käyttämällä malli upotusta asiakkaiden sovellukselle
• Sivutettujen raporttien upottaminen

Kysy Power BI -yhteisöltä