Jaa


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

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 seuraavat Power BI- ja 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.

Seuraavassa 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 -palvelun käyttöoikeus Et voi käyttää Power BI -palvelua palvelun päänimellä. Voit käyttää Power BI -palvelua 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

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

    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 5 – Hae upotusparametriarvot

Jos haluat upottaa sisältösi, tarvitset eräitä parametriarvoja. Seuraavassa taulukossa näkyvät tarvittavat arvot ja ilmaistaan, 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. Jotkin arvoista saattavat vaihdella käyttämäsi todennusmenetelmän mukaan.

Parametri Palvelun päänimi Pääkäyttäjä
Asiakkaan tunnus Koskee. Koskee.
Työtilan tunnus Koskee. Koskee.
Raporttitunnus Koskee. Koskee.
Asiakasohjelman salasana Koskee. Ei koske.
Tenant ID Koskee. pakollinen vain Node JS:lle
Power BI -käyttäjänimi Ei koske. Koskee.
Power BI -salasana Ei koske. Koskee.

Client ID

Vihje

Koskee: Koskee.Palvelun pääkäyttäjä Koskee.

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: Koskee.Palvelun pääkäyttäjä Koskee.

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

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

Näyttökuva, jossa näytetään, miten voit etsiä työtilan tunnuksen järjestelmänvalvojan asetuksista.

Raportin tunnus

Vihje

Koskee: Koskee.Palvelun pääkäyttäjä Koskee.

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

Asiakasohjelman salaisuus

Vihje

Koskee: Koskee.Palvelun pääkäyttäjä Ei koske.

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: Koskee.Palvelun pääkäyttäjä Ei koske.

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: Ei koske.Palvelun pääkäyttäjä Koskee.

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

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

Vihje

Koskee: Koskee.Palvelun pääkäyttäjä Ei koske.

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 -palvelussa Asetukset Asetukset>>Hallintaportaali.

    Näyttökuva, jossa näkyy järjestelmänvalvojan asetusten valikkovaihtoehto Power BI -palvelun asetusvalikossa.

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

  3. Laajenna Palvelun päänimet -toiminto voi käyttää Fabric-ohjelmointirajapintoja ja ottaa tämän asetuksen käyttöön.

    Näyttökuva kehittäjäasetusten käyttöönotosta Power BI -palvelun vuokraaja-asetusten valikkovaihtoehdossa.

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 -palvelussa 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 sisään Fabriciin.

  2. Siirry sen työtilan kolle, jonka käyttöoikeuden haluat ottaa käyttöön, ja valitse Käytön hallinta.

    Näyttökuva, jossa näkyy Työtilan käyttöoikeus -painike Power BI -työtilan Lisää-valikossa.

  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.

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

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