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

  • Artikkeli

KOSKEE: Sovellus omistaa tiedot Käyttäjä omistaa tiedot

Embedded Analytics ja Power BI Embedded (Azure-tarjous) sallivat sinun 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ä mallisovellus Upottaminen asiakkaillesi (tunnetaan myös mallisovelluksena Sovellus omistaa tiedot).

Käyttäjien ei tarvitse kirjautua Power BI:hin eikä heillä tarvitse olla Power BI -käyttöoikeutta, jotta he voivat käyttää sovellustasi.

Suosittelemme käyttämään Upottaminen asiakkaillesi -menetelmää Power BI -sisältösi upottamiseen siinä tapauksessa, että olet itsenäinen ohjelmistotoimittaja (ISV) tai kehittäjä, joka haluaa luoda sovelluksia kolmansille osapuolille.

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 mallisovelluksen Upottaminen asiakkaillesi määrittämiseen jossakin seuraavista toimintakehyksistä:

  • .NET Framework
  • .NET Ydin
  • Java
  • Node JS
  • Python

Koodinäytteet tukevat seuraavia selaimia:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Edellytykset

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

  • Power BI -riippuvuudet

    • Oma Microsoft Entra -vuokraaja.

    • Sovelluksesi todentamiseen Power BI:ssä tarvitaan jokin seuraavista:

      • Palvelun pääobjekti : Microsoft Entra -palvelun pääobjekti , joka sallii Microsoft Entra -tunnuksen sovelluksesi todentamisen.

      • Power BI Pro -käyttöoikeus – Tämä on pääkäyttäjäsi, ja sovelluksesi käyttää sitä Power BI -todennustamiseen.

      • Käyttäjäkohtainen Power BI Premium (PPU) -käyttöoikeus - Tämä on pääkäyttäjäsi, ja sovelluksesi käyttää sitä Power BI -todennustamiseen.

      Muistiinpano

      Jos haluat siirtyä tuotantoon , tarvitset kapasiteetin.

  • Koodiriippuvuudet

Metodi

Jos haluat luoda Upottaminen asiakkaillesi -mallisovelluksen, toimi seuraavasti:

  1. Valitse todentamismenetelmä.

  2. Rekisteröi Microsoft Entra -sovellus.

  3. Luo Power BI -työtila.

  4. Luo ja julkaise Power BI -raportti.

  5. Hae upotusparametriarvot.

  6. Palvelun päänimen ohjelmointirajapinnan käyttö

  7. Mahdollista työtilan käyttö.

  8. Upota sisältö.

Vaihe 1 – Valitse todentamismenetelmä

Upotettu ratkaisusi vaihtelee valitsemasi todennusmenetelmän mukaan. Siksi on tärkeää ymmärtää todentamismenetelmien väliset erot ja päättää, mikä parhaiten sopii ratkaisullesi.

Alla olevassa taulukossa kuvataan eräät tärkeimmistä eroista palvelun päänimi- ja pääkäyttäjä-todennusmenetelmien välillä.

Huomioitavia seikkoja Palvelun päänimi Pääkäyttäjä
Mekanismi Microsoft Entra -sovelluksesi palvelun pääobjekti sallii Microsoft Entra -tunnuksen todentaa upotetun ratkaisusi sovelluksen Power BI:lle. Microsoft Entra -sovelluksesi käyttää Power BI -käyttäjän tunnistetietoja (käyttäjänimeä ja salasanaa) Power BI -todentamiseen.
Suojaus Palvelun päänimi on Microsoft Entra -tunnuksen suositeltu valtuutusmenetelmä. Jos käytät palvelun päänimeä, voit todentaa sen joko käyttämällä sovellussalaisuutta tai varmennetta.

Tässä opetusohjelmassa kuvataan vain palvelun päänimen käyttöä sovelluksen salauskoodilla. Jos haluat tehdä upotuksen palvelun päänimen ja varmenteen avulla, katso artikkelia Palvelun päänimi yhdessä varmenteen kanssa.		 Tämä todennusmenetelmä ei ole yhtä turvallinen kuin palvelun päänimi. Sinun on oltava valppaana pääkäyttäjän tunnistetietojen (käyttäjänimen ja salasanan) kanssa. Älä esimerkiksi paljasta niitä upotussovelluksessasi ja vaihda salasanaa usein.
Microsoft Entra ID :n delegoidut käyttöoikeudet Ei pakollinen. Pääkäyttäjäsi tai järjestelmänvalvojan on annettava sovelluksellesi suostumus käyttää Power BI REST -ohjelmointirajapinnan käyttöoikeuksia (tunnetaan myös laajennuksilla). Esimerkiksi Report.ReadWrite.All.
Power BI -palvelu käyttö Power BI -palvelu ei voi käyttää palvelun päänimellä. Voit käyttää Power BI -palvelu pääkäyttäjän tunnistetiedoillasi.
Käyttöoikeus Ei edellytä Pro-käyttöoikeutta. Voit käyttää sisältöä missä tahansa työtilassa, jonka jäsen tai järjestelmänvalvoja olet. Edellyttää Power BI Pro- tai käyttäjäkohtaisen Premiumin (PPU) käyttöoikeutta.

Vaihe 2 – Rekisteröi Microsoft Entra -sovellus

Kun rekisteröit sovelluksesi Microsoft Entra -tunnuksella, voit

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

Muistiinpano

Ennen kuin rekisteröit sovelluksesi, sinun on päätettävä, mitä todentamismenetelmää käytät, palvelun päänimeä vai pääkäyttäjää.

Vaihe 3 – Luo Power BI -työtila

Power BI 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 Power BI -palveluun

  2. Valitse Työtilat.

  3. Valitse Luo työtila.

  4. Nimeä työtilasi ja valitse Tallenna.

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

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

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

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

Vaihe 5 – Hae upotusparametriarvot

Jos haluat upottaa sisältösi, tarvitset eräitä parametriarvoja. Alla oleva taulukko näyttää tarvittavat arvot ja ilmaisee, ovatko ne sovellettavissa palvelun päänimen todentamismenetelmään, pääkäyttäjän todentamismenetelmään vai molempiin.

Ennen kuin upotat sisältösi, varmista, että sinulla on kaikki alla luetellut arvot. Osa arvoista on erilaisia riippuen siitä, mitä todentamismenetelmää käytät.

Parametri Palvelun päänimi Pääkäyttäjä
Asiakkaan tunnus Applies to. Applies to.
Työtilan tunnus Applies to. Applies to.
Raporttitunnus Applies to. Applies to.
Asiakasohjelman salasana Applies to. Does not apply to.
Tenant ID Applies to. pakollinen vain Node JS:lle
Power BI -käyttäjänimi Does not apply to. Applies to.
Power BI -salasana Does not apply to. Applies to.

Client ID

Vihje

Koskee seuraavia:Applies to.Palvelun pääkäyttäjä Applies to.

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.

Työtilan tunnus

Vihje

Koskee seuraavia:Applies to.Palvelun pääkäyttäjä Applies to.

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

    A screenshot showing workspace ID GUID in the Power B I service U R L

Vaihtoehtoisesti voit hakea työtilan tunnuksen Hallinta portaalin asetuksista valitsemalla työtilan nimen vierestä Tiedot.

A screenshot showing how to find the workspace I D from the admin settings.

Raportin tunnus

Vihje

Koskee seuraavia:Applies to.Palvelun pääkäyttäjä Applies to.

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

    A screenshot showing report ID GUID in the Power B I service U R L

Asiakasohjelman salaisuus

Vihje

Koskee seuraavia:Applies to.Palvelun pääkäyttäjä Does not apply to.

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.

Muistiinpano

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.

Vuokraajatunnus

Vihje

Koskee seuraavia:Applies to.Palvelun pääkäyttäjä Does not apply to.

Jos haluat saada vuokraajan tunnuksen yksilöivän tunnisteen, 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 hakemiston (vuokraajan) tunnus.

Power BI -käyttäjänimi ja -salasana

Vihje

Koskee seuraavia:Does not apply to.Palvelun pääkäyttäjä Applies to.

Hanki sen Power BI :n käyttäjänimi ja salasana, jota olet käyttämässä pääkäyttäjänä. Tämä on sama käyttäjä, jota käytit luodaksesi työtilan ja ladataksesi raportin Power BI -palvelu.

Vaihe 6 – Palvelun päänimen ohjelmointirajapinnan käyttö

Vihje

Koskee seuraavia:Applies to.Palvelun pääkäyttäjä Does not apply to.

Tällä vaiheella on merkitystä vain, jos käytät palvelun päänimen todennusmenetelmää. Jos käytät pääkäyttäjää, ohita tämä vaihe ja jatka kohdasta Vaihe 7 - Mahdollista työtilan käyttö.

Jotta Microsoft Entra -sovellus voi käyttää Power BI -sisältöä ja ohjelmointirajapintoja, Power BI -järjestelmänvalvojan on otettava käyttöön palvelun päänimen käyttöoikeus Power BI -hallintaportaalissa. Jos et ole vuokraajasi järjestelmänvalvoja, pyydä vuokraajan järjestelmänvalvojaa ottamaan käyttöön vuokraaja-asetukset puolestasi.

  1. Valitse Power BI -palvelu portaalista Asetukset> Asetukset> Hallinta portaali.

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

  2. Valitse Vuokraaja-asetukset ja vieritä sitten alaspäin Kehittäjän asetukset - osaan.

  3. Laajenna ja ota käyttöön asetus Salli palvelun päänimien käyttää Power BI -ohjelmointirajapintoja.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

Muistiinpano

Kun käytät palvelun päänimeä, on suositeltavaa rajoittaa sen käyttöoikeudet vuokraajan asetuksiin käyttöoikeusryhmän avulla. Lisätietoja tästä ominaisuudesta on palvelun päänimi -artikkelin seuraavissa osioissa:

Vaihe 7 – Mahdollista työtilan käyttö

Jos haluat Microsoft Entra -sovelluksesi voi käyttää Power BI -palvelu objekteja, kuten raportteja, koontinäyttöjä ja semanttisia malleja, lisää palvelun päänimi tai pääkäyttäjä työtilaasi jäseneksi tai järjestelmänvalvojaksi.

  1. Kirjaudu Power BI -palveluun.

  2. Siirry sen työtilan kolle, jonka käyttöoikeuden haluat ottaa käyttöön, ja valitse Lisää-valikosta Työtilan käyttöoikeus.

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  3. Kopioi Käyttöoikeus-ruudussa, riippuen siitä mitä todentamismenetelmää käytät, palvelun päänimi tai pääkäyttäjäAnna sähköpostiosoite -tekstiruutuun.

    Muistiinpano

    Jos käytät palvelun päänimeä, sen nimi on nimi, jonka annoit Microsoft Entra -sovelluksellesi.

  4. Valitse Lisää.

Vaihe 8 – Upota sisältö

Power BI:n upotettu mallisovellus mahdollistaa sinulle Upottaminen asiakkaillesi -sovelluksen luomisen Power BI:lle.

Näiden ohjeiden avulla voit muokata Upottaminen asiakkaillesi -mallisovellusta ja upottaa Power BI -raportin.

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

  2. Valitse Koodi ja valitse sitten Lataa zip.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

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

  1. Riippuen siitä, mitä kieltä haluat sovelluksesi käyttävän, avaa yksi seuraavista kansioista:

    • .NET Ydin
    • .NET Framework
    • Java
    • Node JS
    • Python

    Muistiinpano

    Upottaminen asiakkaillesi -mallisovellukset tukevat vain yllä lueteltuja sovelluskehyksiä. React-mallisovellus tukee vain Upottaminen organisaatiollesi -ratkaisua.

  2. Avaa Upottaminen asiakkaillesi -kansio.

  1. Avaa Upottaminen asiakkaillesi -mallisovellus jollakin seuraavista menetelmistä:

  2. Avaa appsettings.json.

  3. Täytä seuraavat parametriarvot todennusmenetelmästä riippuen:

    Parametri Palvelun päänimi Pääkäyttäjä
    AuthenticationMode ServicePrincipal MasterUser
    ClientId Microsoft Entra -sovelluksesi asiakastunnus Microsoft Entra -sovelluksesi asiakastunnus
    TenantId Microsoft Entra -vuokraajatunnuksesi –
    PbiUsername – Pääkäyttäjän käyttäjänimesi, katso kohta Power BI -käyttäjänimi ja -salasana
    PbiPassword – Pääkäyttäjän salasanasi, katso kohta Power BI -käyttäjänimi ja -salasana
    ClientSecret Microsoft Entra ID - asiakassalaisuus –
    WorkspaceId Upotetun raporttisi työtilan tunnus, katso Työtilan tunnus Upotetun raporttisi työtilan tunnus, katso Työtilan tunnus
    ReportId Upotuksen raportin tunnus, katso Raportin tunnus Upotuksen raportin tunnus, katso Raportin tunnus

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

Sovelluksen kehittäminen

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

Kokeile Power BI Embedded -analytiikan leikkikenttää aloittaaksesi kehittämisen ja pysyäksesi ajan tasalla kaikista uusista Power BI Embedded -ominaisuuksista ja päivityksistä.

Kun olet valmis, tarkista siirry tuotantoon - vaatimukset. Tarvitset myös kapasiteetin, ja sinun tulee tarkistaa artikkelista Kapasiteetin suunnittelu , mikä varastointiyksikkö sopii parhaiten tarpeisieesi.

Tärkeä

Jos olet käyttänyt maksuttomia upotuskokeilutunnuksia kehityksessä, sinun on ostettava kapasiteettia tuotantoa varten. Ennen kuin ostat kapasiteetin, maksuttoman kokeiluversion banneri näkyy upotetun raportin yläosassa.

Liittyvä sisältö

Onko sinulla lisää kysymyksiä? Kysy Power BI -yhteisö.