Oktatóanyag: Power BI-tartalom beágyazása minta beágyazással az ügyfelek alkalmazásához

A KÖVETKEZŐKRE VONATKOZIK: Az alkalmazás az adatok tulajdonosa, a felhasználóé az adat

A Beágyazott elemzés és a Power BI Embedded (az Azure-ajánlat) lehetővé teszi Power BI-tartalmak, például jelentések, irányítópultok és csempék beágyazását az alkalmazásba.

Az oktatóanyag segítségével megtanulhatja a következőket:

• A beágyazott környezet beállítása.
• Konfiguráljon egy beágyazást az ügyfelek (más néven az alkalmazás tulajdonában lévő adatok) mintaalkalmazás számára.

Az alkalmazás használatához a felhasználóknak nem kell bejelentkeznie a Power BI-ba, vagy Power BI-licenccel kell rendelkezniük.

Javasoljuk, hogy a Power BI-tartalmak beágyazásához használja az ügyfelek beágyazási módszerét, ha Ön független szoftvergyártó vagy fejlesztő, aki harmadik felek számára szeretne alkalmazásokat létrehozni.

Fontos

Ha tartalmat ágyaz be egy országos/regionális felhőbe, az oktatóanyag első néhány lépése eltér. Részletekért lásd : Tartalom beágyazása nemzeti/regionális felhőkbe .

Kódminta specifikációi

Ez az oktatóanyag útmutatást tartalmaz a beágyazás ügyfélalkalmazáshoz való konfigurálásához az alábbi keretrendszerek egyikében:

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

A kódminták a következő böngészőket támogatják:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Előfeltételek

Az oktatóanyag megkezdése előtt ellenőrizze, hogy rendelkezik-e az alábbiakban felsorolt Power BI- és kódfüggőségekkel:

• Power BI-függőségek

  • Saját Microsoft Entra-bérlője.

  • Az alkalmazás Power BI-beli hitelesítéséhez az alábbiak egyikére lesz szüksége:

    • Szolgáltatásnév – a Microsoft Entra szolgáltatásnév objektuma , amely lehetővé teszi a Microsoft Entra ID számára az alkalmazás hitelesítését.

    • Power BI Pro-licenc – Ez lesz a fő felhasználója , és az alkalmazás a Power BI-ban való hitelesítéshez fogja használni.

    • Felhasználónkénti Power BI Premium (PPU) licenc – Ez lesz a fő felhasználója, és az alkalmazás ezt fogja használni a Power BI-ban való hitelesítéshez.

    Megjegyzés:

    Az éles környezetbe való áthelyezéshez kapacitásra van szükség.

• Kódfüggőségek

.NET Core

• .NET Core 3.1 SDK (vagy újabb)

• Integrált fejlesztési környezet (IDE). Az alábbiak egyikét javasoljuk:

  • Visual Studio

  • Visual Studio Code

.NET Framework

• .NET-keretrendszer 4.8

• Visual Studio

Java

• JDK (vagy JRE)

• Eclipse IDE – Ellenőrizze, hogy rendelkezik-e az Eclipse for Java Enterprise kiadás Developers (enterprise edition) verzióval

• Apache Tomcat bináris disztribúciók

Node JS

• Node.js

• Integrált fejlesztési környezet (IDE). Az alábbiak egyikét javasoljuk:

  • Visual Studio

  • Visual Studio Code

Python

• Python 3 (vagy újabb)

  Megjegyzés:

  • Ha először telepíti a Pythont , válassza a Python hozzáadása a PATH-hoz lehetőséget, és adja hozzá a telepítést a PATH változóhoz.
  • Ha már telepítve van a Python , ellenőrizze, hogy a változó tartalmazza-e a PATH telepítési útvonalat. További információ: Excursus : Környezeti változók beállítása Python-dokumentáció (ez a hivatkozás a Python 3-ra hivatkozik).

• Integrált fejlesztési környezet (IDE). Az alábbiak egyikét javasoljuk:

  • Visual Studio

  • Visual Studio Code

Metódus

Ha beágyazást szeretne létrehozni az ügyfelek számára mintaalkalmazásként, kövesse az alábbi lépéseket:

1. Válassza ki a hitelesítési módszert.

2. Microsoft Entra-alkalmazás regisztrálása.

3. Power BI-munkaterület létrehozása.

4. Power BI-jelentés létrehozása és közzététele.

5. Kérje le a beágyazási paraméter értékeit.

6. Szolgáltatásnév API-hozzáférése

7. Munkaterület-hozzáférés engedélyezése.

8. Beágyazza a tartalmat.

1. lépés – A hitelesítési módszer kiválasztása

A beágyazott megoldás a választott hitelesítési módszertől függően változhat. Ezért fontos megérteni a hitelesítési módszerek közötti különbségeket, és eldönteni, hogy melyik felel meg a legjobban a megoldásnak.

Az alábbi táblázat a szolgáltatásnév és a főfelhasználói hitelesítési módszerek közötti néhány fő különbséget ismerteti.

Szempont	Service principal	Fő felhasználó
Mechanizmus	A Microsoft Entra-alkalmazás szolgáltatásnév objektuma lehetővé teszi, hogy a Microsoft Entra ID hitelesítse a beágyazott megoldásalkalmazást a Power BI-ban.	A Microsoft Entra-alkalmazás egy Power BI-felhasználó hitelesítő adatait (felhasználónevét és jelszavát) használja a Power BI-hitelesítéshez.
Biztonság	A szolgáltatásnév a Microsoft Entra-azonosító által javasolt engedélyezési módszer. Szolgáltatásnév használata esetén az alkalmazás titkos kódjának vagy tanúsítványának használatával végezhet hitelesítést. Ez az oktatóanyag csak az alkalmazás titkos kódjával rendelkező szolgáltatásnév használatát ismerteti. Szolgáltatásnév és tanúsítvány használatával történő beágyazásához tekintse meg a szolgáltatásnevet egy tanúsítványcikktel.	Ez a hitelesítési módszer nem olyan biztonságos, mint a szolgáltatásnév. Ébernek kell lennie a fő felhasználói hitelesítő adatokkal (felhasználónévvel és jelszóval). Például ne tegye elérhetővé őket a beágyazási alkalmazásban, és gyakran módosítsa a jelszót.
Microsoft Entra ID delegált engedélyek	Nem kötelező.	A fő felhasználónak vagy a rendszergazdának hozzájárulást kell adnia ahhoz, hogy az alkalmazás hozzáférjen a Power BI REST API-engedélyekhez (más néven hatókörökhöz). Például: Report.ReadWrite.All.
Power BI szolgáltatás hozzáférés	Szolgáltatásnévvel nem férhet hozzá Power BI szolgáltatás.	A Power BI szolgáltatás a fő felhasználói hitelesítő adataival érheti el.
Licenc	Nem igényel Pro-licencet. Bármely olyan munkaterületről használhat tartalmat, amelynek Tagja vagy rendszergazdája.	Felhasználónkénti Power BI Pro - vagy Premium-licencre (PPU) van szükség.

2. lépés – Microsoft Entra-alkalmazás regisztrálása

Az alkalmazás Microsoft Entra-azonosítóval való regisztrálása lehetővé teszi az alábbiakat:

• Identitás létrehozása az alkalmazáshoz
• Az alkalmazás hozzáférésének engedélyezése a Power BI REST API-khoz
• Főfelhasználó használata esetén – Adja meg az alkalmazás Power BI REST-engedélyeit

Az alkalmazás Microsoft Entra-azonosítóval való regisztrálásához kövesse az alkalmazás regisztrálása című témakör utasításait.

Megjegyzés:

Az alkalmazás regisztrálása előtt el kell döntenie, hogy melyik hitelesítési módszert, a szolgáltatásnevet vagy a főfelhasználót használja.

3. lépés – Power BI-munkaterület létrehozása

A Power BI egy munkaterületen tárolja a jelentéseket, irányítópultokat és csempéket. Az elemek beágyazásához létre kell hoznia őket, és fel kell töltenie őket egy munkaterületre.

Tipp.

Ha már van munkaterülete, kihagyhatja ezt a lépést.

Munkaterület létrehozásához tegye a következőket:

1. Jelentkezzen be a Power BI-ba.

2. Válassza a Munkaterületek lehetőséget.

3. Válassza a Munkaterület létrehozása lehetőséget.

4. Nevezze el a munkaterületet, és válassza a Mentés lehetőséget.

4. lépés – Power BI-jelentés létrehozása és közzététele

A következő lépés egy jelentés létrehozása és feltöltése a munkaterületre. Saját jelentést hozhat létre a Power BI Desktop használatával, majd közzétehetia munkaterületen. Vagy feltölthet egy mintajelentést a munkaterületre.

Tipp.

Ha már rendelkezik jelentéssel rendelkező munkaterülettel, kihagyhatja ezt a lépést.

Mintajelentés letöltéséhez és a munkaterületen való közzétételéhez kövesse az alábbi lépéseket:

1. Nyissa meg a GitHub Power BI Desktop mintamappát .

2. Válassza a Kód lehetőséget, majd válassza a Zip letöltése lehetőséget.

   

3. Bontsa ki a letöltött ZIP-fájlt, és keresse meg a Mintajelentések mappát.

4. Válasszon ki egy beágyazandó jelentést, és tegye közzé a munkaterületen.

5. lépés – A beágyazási paraméter értékeinek lekérése

A tartalom beágyazásához be kell szereznie bizonyos paraméterértékeket. Az alábbi táblázat a szükséges értékeket jeleníti meg, és jelzi, hogy alkalmazhatók-e a szolgáltatásnév-hitelesítési módszerre, a főfelhasználói hitelesítési módszerre vagy mindkettőre.

A tartalom beágyazása előtt győződjön meg arról, hogy az összes alábbi érték szerepel a listán. Az értékek egy része a használt hitelesítési módszertől függően eltérő lesz.

Paraméter	Service principal	Fő felhasználó
Ügyfélazonosító
Munkaterület azonosítója
Jelentésazonosító
Titkos ügyfélkód
Bérlőazonosító		csak a Node JS-hez szükséges
Power BI-felhasználónév
Power BI-jelszó

Client ID

Tipp.

A következőre vonatkozik: Szolgáltatásnév főfelhasználója

Az ügyfélazonosító GUID-azonosítójának (más néven alkalmazásazonosítónak) lekéréséhez kövesse az alábbi lépéseket:

1. Jelentkezzen be a Microsoft Azure-ba.

2. Keresse meg a Alkalmazásregisztrációk, és válassza a Alkalmazásregisztrációk hivatkozást.

3. Válassza ki a Power BI-tartalmak beágyazásához használt Microsoft Entra-alkalmazást.

4. Az Áttekintés szakaszban másolja ki az alkalmazás (ügyfél) azonosítójának GUID azonosítóját.

Munkaterület azonosítója

Tipp.

A következőre vonatkozik: Szolgáltatásnév főfelhasználója

A munkaterület azonosítójának GUID-azonosítójának lekéréséhez kövesse az alábbi lépéseket:

1. Jelentkezzen be a Power BI szolgáltatás.

2. Nyissa meg a beágyazni kívánt jelentést.

3. Másolja ki a GUID-t az URL-címből. A GUID a /groups/ és a /reports/közötti szám.

   

A munkaterület-azonosítót a Rendszergazda portál beállításai között is megtalálhatja a Munkaterület neve melletti Részletek gombra kattintva.

Jelentésazonosító

Tipp.

A következőre vonatkozik: Szolgáltatásnév főfelhasználója

A jelentésazonosító GUID-azonosítójának lekéréséhez kövesse az alábbi lépéseket:

1. Jelentkezzen be a Power BI szolgáltatás.

2. Nyissa meg a beágyazni kívánt jelentést.

3. Másolja ki a GUID-t az URL-címből. A GUID a /reports/ és a /ReportSection közötti szám.

   

Client secret

Tipp.

A következőre vonatkozik: Szolgáltatásnév főfelhasználója

Az ügyfél titkos kódjának lekéréséhez kövesse az alábbi lépéseket:

1. Jelentkezzen be a Microsoft Azure-ba.

2. Keresse meg a Alkalmazásregisztrációk, és válassza a Alkalmazásregisztrációk hivatkozást.

3. Válassza ki a Power BI-tartalmak beágyazásához használt Microsoft Entra-alkalmazást.

4. A Kezelés területen válassza a Tanúsítványok és titkos kódok lehetőséget.

5. Az Ügyfélkódok csoportban válassza az Új ügyfélkulcs lehetőséget.

6. Az Ügyfélkód hozzáadása előugró ablakban adja meg az alkalmazás titkos kódjának leírását, jelölje ki az alkalmazás titkos kódjának lejárati dátumát, és válassza a Hozzáadás lehetőséget.

7. Az Ügyfél titkos kulcsok szakaszból másolja ki az újonnan létrehozott alkalmazáskulcs Érték oszlopában lévő sztringet. Az ügyfél titkos kódjának értéke az ügyfél azonosítója.

Megjegyzés:

Győződjön meg arról, hogy az ügyfél titkos kódjának értékét az első megjelenésekor másolja. A lapról való navigálás után az ügyfél titkos kódja el lesz rejtve, és nem fogja tudni lekérni az értékét.

Tenant ID

Tipp.

A következőre vonatkozik: Szolgáltatásnév főfelhasználója

A bérlőazonosító GUID-azonosítójának lekéréséhez kövesse az alábbi lépéseket:

1. Jelentkezzen be a Microsoft Azure-ba.

2. Keresse meg a Alkalmazásregisztrációk, és válassza a Alkalmazásregisztrációk hivatkozást.

3. Válassza ki a Power BI-tartalmak beágyazásához használt Microsoft Entra-alkalmazást.

4. Az Áttekintés szakaszban másolja ki a címtár (bérlő) azonosítójának GUID azonosítóját.

Power BI felhasználónév és jelszó

Tipp.

A következőre vonatkozik: Szolgáltatásnév főfelhasználója

Szerezze be a fő felhasználóként használt Power BI-felhasználó nevét és jelszavát. Ez ugyanaz a felhasználó, aki egy munkaterület létrehozásához és egy jelentés feltöltéséhez használt Power BI szolgáltatás.

6. lépés – Szolgáltatásnév API-hozzáférése

Tipp.

A következőre vonatkozik: Szolgáltatásnév főfelhasználója

Ez a lépés csak akkor releváns, ha a szolgáltatásnév hitelesítési módszerét használja. Ha főfelhasználót használ, hagyja ki ezt a lépést, és folytassa a 7. lépéssel – Munkaterület-hozzáférés engedélyezése.

Ahhoz, hogy egy Microsoft Entra-alkalmazás hozzáférhessen a Power BI-tartalmakhoz és API-khoz, a Power BI rendszergazdájának engedélyeznie kell a szolgáltatásnév elérését a Power BI felügyeleti portálján. Ha nem Ön a bérlő rendszergazdája, kérje meg a bérlő rendszergazdáját, hogy engedélyezze Önnek a bérlői beállításokat .

1. A Power BI szolgáltatás válassza a Gépház> Gépház> Rendszergazda portált.

   

2. Válassza a Bérlői beállítások lehetőséget , majd görgessen le a Fejlesztői beállítások szakaszhoz.

3. Bontsa ki a Power BI API-k használatának engedélyezése szolgáltatásnevek számára lehetőséget, és engedélyezze ezt a beállítást.

   

Megjegyzés:

Szolgáltatásnév használata esetén ajánlott biztonsági csoport használatával korlátozni a bérlői beállításokhoz való hozzáférését. A funkcióval kapcsolatos további információkért tekintse meg a szolgáltatásnévről szóló cikk alábbi szakaszait:

• Microsoft Entra biztonsági csoport létrehozása
• A Power BI szolgáltatás rendszergazdai beállításainak engedélyezése

7. lépés – Munkaterület-hozzáférés engedélyezése

Ha engedélyezni szeretné, hogy a Microsoft Entra-alkalmazás hozzáférjen az olyan objektumokhoz, mint a jelentések, irányítópultok és szemantikai modellek a Power BI szolgáltatás, adja hozzá a szolgáltatásnevet vagy a főfelhasználót tagként vagy rendszergazdaként a munkaterülethez.

1. Jelentkezzen be a Power BI szolgáltatás.

2. Görgessen a munkaterülethez, amelyhez engedélyezni szeretné a hozzáférést, és a Továbbiak menüben válassza a Munkaterület-hozzáférés lehetőséget.

   

3. Az Access panelen a használt hitelesítési módszertől függően másolja a szolgáltatásnevet vagy a főfelhasználót az Enter e-mail-cím szövegmezőbe.

   Megjegyzés:

   Ha szolgáltatásnevet használ, annak a neve a Microsoft Entra-alkalmazásnak adott név.

4. Válassza a Hozzáadás lehetőséget.

8. lépés – Tartalom beágyazása

A Beágyazott Power BI-mintaalkalmazás lehetővé teszi, hogy beágyazást hozzon létre ügyfelei számára a Power BI-alkalmazáshoz.

Az alábbi lépéseket követve módosíthatja az ügyfelek mintaalkalmazásának beágyazását a Power BI-jelentés beágyazásához.

1. Nyissa meg a Power BI fejlesztői mintamappát .

2. Válassza a Kód lehetőséget, majd válassza a Zip letöltése lehetőséget.

   

3. Bontsa ki a letöltött ZIP-t, és lépjen a PowerBI-Developer-Samples-master mappára.

4. Az alkalmazás által használni kívánt nyelvtől függően nyissa meg az alábbi mappák egyikét:

   • .NET Core
   • .NET-keretrendszer
   • Java
   • Node JS
   • Python

   Megjegyzés:

   Az ügyfelek számára készült beágyazási mintaalkalmazások csak a fent felsorolt keretrendszereket támogatják. A React mintaalkalmazás csak a szervezeti megoldás beágyazását támogatja.

5. Nyissa meg a Beágyazás az ügyfeleknek mappát.

.NET Core

6. Nyissa meg az ügyfelek számára készült beágyazási mintaalkalmazást az alábbi módszerek egyikével:

   • Ha Visual Studiót használ, nyissa meg az AppOwnsData.sln fájlt.

   • Ha Visual Studio Code-ot használ, nyissa meg az AppOwnsData mappát.

7. Nyissa meg az appsettings.json fájlt.

8. A hitelesítési módszertől függően adja meg a következő paraméterértékeket:

   Paraméter	Service principal	Fő felhasználó
   AuthenticationMode	ServicePrincipal	MasterUser
   ClientId	A Microsoft Entra alkalmazás ügyfél-azonosítója	A Microsoft Entra alkalmazás ügyfél-azonosítója
   TenantId	A Microsoft Entra-bérlő azonosítója	N.A.
   PbiUsername	N.A.	A fő felhasználói felhasználónév, lásd: Power BI felhasználónév és jelszó
   PbiPassword	N/A	A fő felhasználói jelszó, lásd: Power BI felhasználónév és jelszó
   ClientSecret	A Microsoft Entra-azonosító ügyfélkódja	N/A
   WorkspaceId	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító
   ReportId	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító

9. Futtassa a projektet a megfelelő beállítás kiválasztásával:

   • Ha Visual Studiót használ, válassza az IIS Express (lejátszás) lehetőséget.

   • Ha Visual Studio Code-ot használ, válassza a Hibakeresés indítása parancsot>.

.NET Framework

6. Nyissa meg az AppOwnsData.sln fájlt a Visual Studióval.

7. Nyissa meg a Web.config fájlt.

8. A hitelesítési módszertől függően adja meg a következő paraméterértékeket:

   Paraméter	Service principal	Fő felhasználó
   authenticationType	ServicePrincipal	MasterUser
   applicationId	A Microsoft Entra alkalmazás ügyfél-azonosítója	A Microsoft Entra alkalmazás ügyfél-azonosítója
   workspaceId	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító
   reportId	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító
   pbiUsername	N/A	A fő felhasználói felhasználónév, lásd: Power BI felhasználónév és jelszó
   pbiPassword	N/A	A fő felhasználói jelszó, lásd: Power BI felhasználónév és jelszó
   applicationSecret	A Microsoft Entra-azonosító ügyfélkódja	N/A
   tenant	A Microsoft Entra-bérlő azonosítója	N/A

9. Futtassa a projektet az IIS Express (lejátszás) kiválasztásával.

Java

6. Nyissa meg az Eclipse-t , és kövesse az alábbi utasításokat.

   Megjegyzés:

   Az ügyfelek számára készült Java-beágyazási mintaalkalmazás utasításait az Eclipse IDE for Java Enterprise kiadás Developers (enterprise edition) című témakörben találja. Ha másik alkalmazást használ, saját maga kell beállítania.

7. Adja hozzá a Tomcat-kiszolgálót az Eclipse-hez:

   a. Válassza a Nézetkiszolgálók> ablak>megjelenítése lehetőséget.

   b. A Kiszolgálók lapon válassza a Nincs elérhető kiszolgáló lehetőséget. Erre a hivatkozásra kattintva új kiszolgálót hozhat létre.

   c. Az Új kiszolgáló definiálása ablakban bontsa ki az Apacheot, és válassza ki a számítógépen futó Tomcat-kiszolgálót. Például: Tomcat v9.0 Server.

   d. Válassza a Következő lehetőséget.

   e. A Tomcat Server ablakban válassza a Tallózás lehetőséget, és keresse meg a Tomcat-kiszolgálót tartalmazó mappát.

   f. A Tomcat Server ablakban válassza a Telepített JREs lehetőséget.

   g. A Telepített JREs ablakban válassza ki az elérhető jre-t, és válassza az Alkalmaz és a Bezárás lehetőséget.

   h. A Tomcat Server ablakban válassza a Befejezés lehetőséget. A Tomcat-kiszolgáló megjelenik a Kiszolgálók lapon.

8. Nyissa meg a projektet az Eclipse-ben:

   Fontos

   Ha az elérési út neve túl hosszú, az Eclipse problémába ütközhet. A probléma elkerülése érdekében ellenőrizze, hogy a mintaalkalmazás mappája nincs-e túl mélyen beágyazva a gép mappastruktúrájába.

   a. Válassza a Fájl lehetőséget, majd válassza a Projektek megnyitása a fájlrendszerből lehetőséget.

   b. A Projektek importálása fájlrendszerből vagy archív ablakban válassza a Címtár lehetőséget, és nyissa meg az AppOwnsData mappát.

   c. Válassza a Befejezés lehetőséget.

9. Adja hozzá a Tomcat-kiszolgálót a projekthez:

   a. A Csomagkezelő panelen kattintson a jobb gombbal az AppOwnsData elemre, és válassza a Tulajdonságok lehetőséget.

   b. Az AppOwnsData tulajdonságai ablakban válassza a Célzott futtatókörnyezetek, majd az Apache Tomcat lehetőséget. Ez a kijelölés tartalmazza a használt Apache Tomcat verzióját, például az Apache Tomcat 9.0-s verzióját.

   c. Válassza az Alkalmaz és a Bezárás lehetőséget.

10. Adja meg a szükséges paramétereket

    a. A Csomagkezelőben bontsa ki az AppOwnsData projektet.

    b. Bontsa ki a Java-erőforrásokat.

    c. Bontsa ki az src elemet.

    d. Bontsa ki a com.embedsample.appoensdata.config fájlt.

    e. Nyissa meg a Config.java fájlt.

    f. A hitelesítési módszertől függően adja meg a következő paraméterértékeket:

    Paraméter	Service principal	Fő felhasználó
    authenticationType	ServicePrincipal	MasterUser
    workspaceId	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító
    reportId	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító
    clientId	A Microsoft Entra alkalmazás ügyfél-azonosítója	A Microsoft Entra alkalmazás ügyfél-azonosítója
    pbiUsername	N/A	A fő felhasználói felhasználónév, lásd: Power BI felhasználónév és jelszó
    pbiPassword	N/A	A fő felhasználói jelszó, lásd: Power BI felhasználónév és jelszó
    tenantId	A Microsoft Entra-bérlő azonosítója	N/A
    appSecret	A Microsoft Entra-azonosító ügyfélkódja	N/A

11. A projekt futtatása

    a. A Csomagkezelőben kattintson a jobb gombbal az AppOwnesData elemre.

    b. Válassza a Futtatás futtatás a>kiszolgálón lehetőséget.

    c. A Futtatás kiszolgálón ablakban válassza a Meglévő kiszolgáló kiválasztása, majd a Tomcat-kiszolgáló kiválasztása lehetőséget.

    d. Válassza a Befejezés lehetőséget.

Node JS

6. Nyissa meg az App Owns Data mappát az előnyben részesített IDE használatával. Az alábbiak egyikét javasoljuk:

   • Visual Studio

   • Visual Studio Code

7. Nyisson meg egy terminált, és telepítse a szükséges függőségeket a következő végrehajtásával: npm install.

8. Bontsa ki a Config mappát, és nyissa meg a config.json fájlt.

9. A hitelesítési módszertől függően adja meg a következő paraméterértékeket:

   Paraméter	Service principal	Fő felhasználó
   authenticationMode	ServicePrincipal	MasterUser
   clientId	A Microsoft Entra alkalmazás ügyfél-azonosítója	A Microsoft Entra alkalmazás ügyfél-azonosítója
   workspaceId	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító
   reportId	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító
   pbiUsername	N/A	A fő felhasználói felhasználónév, lásd: Power BI felhasználónév és jelszó
   pbiPassword	N/A	A fő felhasználói jelszó, lásd: Power BI felhasználónév és jelszó
   clientSecret	A Microsoft Entra-azonosító ügyfélkódja	N/A
   tenantId	A Microsoft Entra-bérlő azonosítója	A Microsoft Entra-bérlő azonosítója

10. Futtassa a projektet a következő lépéssel:

    a. Az IDE terminálban hajtsa végre a következőt npm start: .

    b. Nyisson meg egy új lapot a böngészőben, és lépjen a következőre http://localhost:5300:

Python

6. Nyissa meg a PowerShellt vagy a parancssort.

7. Ellenőrizze, hogy a Python-beágyazás>az ügyfelek mappájában van-e, és hogy a file requirements.txt fájl szerepel-e a mappában, és futtassa a fájltpip3 install -r requirements.txt.

8. Nyissa meg az App Owns Data mappát az előnyben részesített IDE használatával. Az alábbiak egyikét javasoljuk:

   • Visual Studio

   • Visual Studio Code

9. Nyissa meg a config.py.

10. A hitelesítési módszertől függően adja meg a következő paraméterértékeket:

    Paraméter	Service principal	Fő felhasználó
    AUTHENTICATION_MODE	ServicePrincipal	MasterUser
    WORKSPACE_ID	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító	A munkaterület azonosítója a beágyazott jelentéssel, lásd : Munkaterület-azonosító
    REPORT_ID	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító	A beágyazni kívánt jelentés azonosítója, lásd: Jelentésazonosító
    TENANT_ID	A Microsoft Entra-bérlő azonosítója	N/A
    CLIENT_ID	A Microsoft Entra alkalmazás ügyfél-azonosítója	A Microsoft Entra alkalmazás ügyfél-azonosítója
    CLIENT_SECRET	A Microsoft Entra-azonosító ügyfélkódja	N.A.
    POWER_BI_USER	N.A.	A fő felhasználói felhasználónév, lásd: Power BI felhasználónév és jelszó
    POWER_BI_PASS	N/A	A fő felhasználói jelszó, lásd: Power BI felhasználónév és jelszó

11. Mentse a fájlt.

12. Futtassa a projektet a következő lépéssel:

    a. A PowerShellben vagy a parancssorban lépjen az ügyfeleknek>szánt Python-beágyazási>AppOwnesData mappára, és hajtsa végre a parancsot.flask run

    b. Nyisson meg egy új lapot a böngészőben, és lépjen a következőre http://localhost:5000:

Az alkalmazás fejlesztése

Miután konfigurálta és futtatta a beágyazást az ügyfelek számára mintaalkalmazásként, megkezdheti saját alkalmazásának fejlesztését.

A Fejlesztés megkezdéséhez és az új Power BI Embedded-funkciók és -frissítések használatának megkezdéséhez próbálja ki a Power BI embedded elemzési játszóterét .

Ha elkészült, tekintse át az éles környezetre való áttérést. Kapacitásra is szüksége lesz, és tekintse át a kapacitástervezési cikket, hogy megállapíthassa, melyik termékváltozat felel meg a legjobban az igényeinek.

Fontos

Ha ingyenes beágyazási próbaverziós jogkivonatokat használt a fejlesztéshez, termelési kapacitást kell vásárolnia. A kapacitás megvásárlásáig az ingyenes próbaverzió szalagcíme továbbra is megjelenik a beágyazott jelentés tetején.

Kapcsolódó tartalom

• Move to production
• Beágyazás a szervezet számára
• Többoldalas jelentések beágyazása

Van még esetleg kérdése? Kérdezze meg a Power BI-közösség.