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

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

Beágyazott elemzés és a Power BI Embedded (az Azure-ajánlat) segítségével Power BI-tartalmat, például jelentéseket, irányítópultokat és csempéket ágyazhat be alkalmazásába.

Ebből az oktatóanyagból az alábbiakat sajátíthatja el:

• A beágyazott környezet beállítása.
• Beágyazás ügyfelek számára (más néven Alkalmazás tulajdonában lévő adatok) beállítású mintaalkalmazás konfigurálása.

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

A Power BI-tartalom beágyazására akkor ajánlott a beágyazás az ügyfelek számára módszert használni, ha független szoftverszállítóként (ISV-ként) vagy fejlesztőként külső felek számára szeretne alkalmazásokat létrehozni.

Fontos

Ha tartalmat ágyaz be egy országos felhőbe, az oktatóanyag első néhány lépése eltér. A részletekért lásd: Tartalom beágyazása országos felhőkhöz .

Mintakód-specifikációk

Ez az oktatóanyag útmutatást tartalmaz egy beágyazás konfigurálásához az ügyfelek számára mintaalkalmazáshoz az alábbi keretrendszerek egyikében:

• .NET-keretrendszer
• .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 a Power BI és az alábbiakban felsrolt kódfüggőségek meglétét:

• Power BI-függőségek

  • Saját Azure Active Directory-bérlő.

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

    • Szolgáltatásnév – Egy Azure Active Directory (Azure AD) szolgáltatásnév-objektum, amellyel az Azure AD hitelesíteni tudja az alkalmazást.

    • Power BI Pro-licenc – Ez lesz az elsődleges felhasználó, és az alkalmazás ezt fogja használni a Power BI-beli hitelesítéshez.

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

    Megjegyzés

    Az éles üzemre való átálláshoz szükség lesz egy kapacitásra.

• Kódfüggőségek

.NET Core

• .NET Core 3.1 SDK (vagy újabb verzió)

• Integrált fejlesztőkörnyezet (IDE). Javasolt az alábbiak egyikének használata:

  • Visual Studio

  • Visual Studio Code

.NET-keretrendszer

• .NET-keretrendszer 4.8

• Visual Studio

Java

• JDK (vagy JRE)

• Eclipse IDE – ellenőrizze, hogy az Eclipse for Java EE Developers (enterprise edition) kiadással rendelkezik

• Apache Tomcat Binary Distributions

Node JS

• Node.js

• Integrált fejlesztőkörnyezet (IDE). Javasolt az alábbiak egyikének használata:

  • Visual Studio

  • Visual Studio Code

Python

• Python 3 (vagy újabb verzió)

  Megjegyzés

  • Ha először telepíti a Pythont, jelölje meg A Python elérési útjának felvétele a PATH változóba lehetőséget, hogy a telepítés bekerüljön a PATH környezeti változó értékei közé.
  • Ha a Python már telepítve van, ellenőrizze, hogy a PATH változó tartalmazza annak elérési útját. További információkat találhat az Excursus: Setting environment variables Python-dokumentációban (ez a hivatkozás a Python 3-ra vonatkozik).

• Integrált fejlesztőkörnyezet (IDE). Javasolt az alábbiak egyikének használata:

  • Visual Studio

  • Visual Studio Code

Metódus

Beágyazás az ügyfelek számára típusú mintaalkalmazás létrehozásához hajtsa végre ezeket a lépéseket:

1. Hitelesítési módszer kiválasztása.

2. Azure AD-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. A beágyazási paraméterértékek megállapítása.

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

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

8. A tartalom beágyazása.

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

A beágyazásos megoldás a választott hitelesítési módszertől függően változik. Emiatt fontos tisztában lenni a hitelesítési módszerek közötti különbségekkel, és eldönteni, hogy melyik felel meg legjobban az adott megoldáshoz.

Az alábbi táblázat a szolgáltatásnéven és az elsődleges felhasználón alapuló hitelesítési módszer néhány fő eltérését mutatja be.

Megfontolandó	Szolgáltatásnév	Elsődleges felhasználó
Mechanizmus	Az Azure AD-alkalmazás szolgáltatásnév-objektuma teszi lehetővé az Azure AD számára a beágyazott megoldásbeli alkalmazás hitelesítését a Power BI-ban.	Az Azure AD-alkalmazás egy Power BI-felhasználó hitelesítő adatai (felhasználónév és jelszó) használatával végez hitelesítést a Power BI-ban.
Biztonság	Az Azure AD-hez ajánlott hitelesítési módszer a szolgáltatásnév. Ha szolgáltatásnevet használ, az alkalmazás titkos kódjának vagy tanúsítványának használatával hitelesítheti magát. Ez az oktatóanyag csak a szolgáltatásnévalkalmazáskóddal való használatát ismerteti. A szolgáltatásnév és tanúsítvány használatának engedélyezéséről a szolgáltatás tanúsítvánnyal történő használatát ismertető cikkből tájékozódhat.	Ez a hitelesítési módszer nem olyan biztonságos, mint egy szolgáltatásnév. Ébernek kell lennie a fő felhasználói hitelesítő adatokkal (felhasználónév és jelszó). Például ne tegye közzé őket a beágyazási alkalmazásban, és gyakran módosítsa a jelszót.
Delegált Azure AD-engedélyek	Nem szükségesek.	Az elsődleges felhasználónak vagy egy rendszergazdának jóvá kell hagynia, hogy az alkalmazás hozzáférjen a Power BI REST API engedélyeihez (más néven hatóköreihez). Ilyen például a Report.ReadWrite.All.
A Power BI szolgáltatás elérése	A Power BI szolgáltatás nem érhető el szolgáltatásnévvel.	A Power BI szolgáltatás az elsődleges felhasználó hitelesítő adataival érhető el.
Licenc	Nincs szükség Pro-licencre. Bármely munkaterületről használhat tartalmat, amelynek tagja vagy rendszergazdája.	Power BI Pro vagy Prémium felhasználónkénti (PPU) licencre van szükség.

2\. lépés – Azure AD-alkalmazás regisztrálása

Az alkalmazás regisztrálása az Azure AD-ben a következőket teszi lehetővé:

• Identitás létrehozása az alkalmazáshoz
• Az alkalmazás hozzáférhet a Power BI REST API-khoz
• Ha elsődleges felhasználót használ, megadhatja az alkalmazás Power BI REST-engedélyeit

Az alkalmazás Azure AD-beli regisztrálásához kövesse az Alkalmazás regisztrálása című cikk utasításait.

Megjegyzés

Az alkalmazás regisztrálásához először el kell döntenie, hogy a szolgáltatásnevet vagy az elsődleges felhasználót szeretné hitelesítési módszerként használni.

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

A Power BI egy munkaterületen tartja a jelentéseket, irányítópultokat és csempéket. Ezeknek az elemeknek a beágyazásához létre kell hoznia, majd fel kell töltenie azokat egy munkaterületre.

Tipp

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

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

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

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

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

4. Adjon nevet a munkaterületnek, é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. Létrehozhat saját jelentést a Power BI Desktoppal, majd közzéteheti azt a munkaterületen. Mintajelentést is feltölthet a munkaterületre.

Tipp

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

Mintajelentést az alábbi lépésekben tölthet le és tehet közzé a munkaterületen:

1. Nyissa meg a Power BI Desktop samples GitHub-könyvtárt.

2. Válassza a Code majd a Download zip lehetőséget.

   

3. Bontsa ki a letöltött ZIP-fájlt, és lépjen a Samples Reports mappára.

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éterek megállapítása

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

Tartalom beágyazása előtt ellenőrizze, hogy az összes itt felsorolt értéket ismeri. Egyes értékek a választott hitelesítési módszertől függően eltérhetnek.

Paraméter	Szolgáltatásnév	Elsődleges felhasználó
Ügyfél-azonosító
Munkaterület azonosítója
Jelentésazonosító
Titkos ügyfélkulcs
Bérlőazonosító		csak a Node JS-hez szükséges
Power BI-felhasználónév
Power BI-jelszó

Ügyfél-azonosító

Tipp

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

A globálisan egyedi (GUID) ügyfél-azonosítót (más néven alkalmazás-azonosítót) az alábbi lépésekben állapíthatja meg:

1. Jelentkezzen be a Microsoft Azure-ba.

2. Keressen rá az Alkalmazásregisztrációk szóra, majd válassza az Alkalmazásregisztrációk hivatkozást.

3. Válassza ki a Power BI-tartalom beágyazásához használt Azure AD alkalmazást.

4. Az Áttekintés szakaszból másolja ki az Alkalmazás- (ügyfél-) azonosító GUID-értéket.

Munkaterület azonosítója

Tipp

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

A munkaterület azonosítóját az alábbi lépésekben állapíthatja meg:

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

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

3. Másolja ki a GUID értékét az URL-címből. A GUID a /groups/ és a /reports/ szakasz 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, ha a munkaterület neve mellett a Részletek lehetőséget választja.

Jelentésazonosító

Tipp

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

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

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

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

   

Titkos ügyfélkulcs

Tipp

A következőre vonatkozik: A szolgáltatásnév Fő felhasználó

A titkos ügyfélkulcsot az alábbi lépésekben állapíthatja meg:

1. Jelentkezzen be a Microsoft Azure-ba.

2. Keressen rá az Alkalmazásregisztrációk szóra, majd válassza az Alkalmazásregisztrációk hivatkozást.

3. Válassza ki a Power BI-tartalom beágyazásához használt Azure AD alkalmazást.

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

5. A Titkos ügyfélkulcsok területen válassza az Új titkos ügyfélkulcs lehetőséget.

6. A Titkos ügyfélkulcs hozzáadása felugró ablakban adjon meg leírást a titkos alkalmazáskulcshoz, adja meg a titkos alkalmazáskulcs lejáratát, majd válassza a Hozzáadás lehetőséget.

7. A Titkos ügyfélkulcs szakaszból másolja ki az újonnan létrehozott titkos alkalmazáskulcs Érték oszlopában lévő sztringet. A titkos ügyfélkulcs értéke az ügyfél-azonosító.

Megjegyzés

Győződjön meg arról, hogy a titkos ügyfélkód é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.

Bérlőazonosító

Tipp

A következőre vonatkozik: A szolgáltatásnév Fő felhasználó

A bérlő azonosítóját az alábbi lépésekben állapíthatja meg:

1. Jelentkezzen be a Microsoft Azure-ba.

2. Keressen rá az Alkalmazásregisztrációk szóra, majd válassza az Alkalmazásregisztrációk hivatkozást.

3. Válassza ki a Power BI-tartalom beágyazásához használt Azure AD alkalmazást.

4. Az Áttekintés szakaszból másolja ki az Címtár- (bérlő-) azonosító GUID-értéket.

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

Tipp

A következőre vonatkozik: A szolgáltatásnév Fő felhasználó

Állapítsa meg az elsődleges felhasználónak szánt Power BI-felhasználó felhasználónevét és jelszavát. Ez ugyanaz a felhasználó, amelyet a munkaterület létrehozásához és egy jelentés feltöltéséhez használt a Power BI szolgáltatásban.

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

Tipp

A következőre vonatkozik: A szolgáltatásnév Fő felhasználó

Ez a lépés csak a szolgáltatásnév hitelesítési módszer használatára vonatkozik. Ha elsődleges felhasználót használ, hagyja ki ezt a lépést, és ugorjon a 7. lépés – Munkaterület-hozzáférés engedélyezése szakaszra.

Ahhoz, hogy egy Azure AD-alkalmazás hozzáférjen a Power BI-tartalmakhoz és az API-khoz, egy Power BI-rendszergazdának engedélyeznie kell a szolgáltatásnév hozzáférését az Power BI felügyeleti portálján. Ha Ön nem a bérlő rendszergazdája, kérje meg a bérlői rendszergazdát, hogy engedélyezze a Bérlői beállításokat az Ön számára.

1. A Power BI szolgáltatásban válassza a Beállítások>Beállítások>Felügyeleti portál lehetőséget.

   

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

3. Bontsa ki A Power BI API-k használatának engedélyezése szolgáltatásneveknek elemet, és engedélyezze ezt a beállítást.

   

Megjegyzés

Szolgáltatásnév használatakor a bérlői beállításokhoz való hozzáférést ajánlott egy biztonsági csoport használatával korlátozni. Erről a funkcióról a szolgáltatásnevet ismertető cikk alábbi szakaszai nyújtanak bővebb információt:

• Azure AD-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é Azure AD alkalmazás-hozzáférési objektumokat, például jelentéseket, irányítópultokat és adatkészleteket a Power BI szolgáltatás, adja hozzá a szolgáltatásnevet vagy a főfelhasználóttagként vagy rendszergazdaként a munkaterülethez.

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

2. Görgessen lefelé addig a munkaterületig, amelyhez hozzáférést kíván adni, majd válassza a További lehetőségek menü Munkaterület-hozzáférés pontját.

   

3. A Hozzáférés panelről a használt hitelesítési módszertől függően másolja át a szolgáltatásnevet vagy az elsődleges felhasználót az E-mail-cím megadása szövegmezőbe.

   Megjegyzés

   Ha szolgáltatásnevet használ, akkor ez az a név, amelyet az Azure AD-alkalmazásnak adott.

4. Válassza a Hozzáadás elemet.

8\. lépés – A tartalom beágyazása

A beágyazásos Power BI-mintaalkalmazással beágyazás az ügyfelek számára típusú Power BI-alkalmazást hozhat létre.

Az alábbi lépések végrehajtásával módosíthatja a beágyazás az ügyfelek számára mintaalkalmazást a Power BI-jelentés beágyazásához.

1. Nyissa meg a Power BI developer samples könyvtárat.

2. Válassza a Code majd a Download zip lehetőséget.

   

3. Bontsa ki a letöltött ZIP-fájlt, é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 beágyazást támogatja a szervezeti megoldáshoz.

5. Nyissa meg a Beágyazás az ügyfelek számára mappát.

.NET Core

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

   • Ha a Visual Studiót használja, 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. Töltse ki az alábbi paraméterértékeket a hitelesítési módszernek megfelelően:

   Paraméter	Szolgáltatásnév	Elsődleges felhasználó
   AuthenticationMode	Szolgáltatásnév	MasterUser
   ClientId	Az Azure AD-alkalmazás ügyfél-azonosítója	Az Azure AD-alkalmazás ügyfél-azonosítója
   TenantId	Az Azure AD-bérlőazonosító	N.A.
   PbiUsername	N.A.	Az elsődleges felhasználó felhasználóneve, lásd: Power BI-felhasználónév és -jelszó
   PbiPassword	N.A.	Az elsődleges felhasználó jelszava, lásd: Power BI-felhasználónév és -jelszó
   ClientSecret	Az Azure AD-beli titkos ügyfélkulcs	N.A.
   WorkspaceId	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító
   ReportId	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító

9. Futtassa a projektet a megfelelő lehetőség kiválasztásával:

   • Ha a Visual Studiót használja, 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 lehetőséget>.

.NET-keretrendszer

6. Ha a Visual Studiót használja, nyissa meg az AppOwnsData.sln fájlt.

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

8. Töltse ki az alábbi paraméterértékeket a hitelesítési módszernek megfelelően:

   Paraméter	Szolgáltatásnév	Elsődleges felhasználó
   authenticationType	Szolgáltatásnév	MasterUser
   applicationId	Az Azure AD-alkalmazás ügyfél-azonosítója	Az Azure AD-alkalmazás ügyfél-azonosítója
   workspaceId	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító
   reportId	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító
   pbiUsername	N.A.	Az elsődleges felhasználó felhasználóneve, lásd: Power BI-felhasználónév és -jelszó
   pbiPassword	N.A.	Az elsődleges felhasználó jelszava, lásd: Power BI-felhasználónév és -jelszó
   applicationSecret	Az Azure AD-beli titkos ügyfélkulcs	N.A.
   tenant	Az Azure AD-bérlőazonosító	N.A.

9. Futtassa a projektet az IIS Express (lejátszás) lehetőség választásával.

Java

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

   Megjegyzés

   A Javás beágyazás az ügyfelek számára mintaalkalmazáshoz kapott utasítások az Eclipse IDE for Java EE Developers (enterprise edition) kiadásra vonatkoznak. Ha más alkalmazást használ, azt Önnek kell beállítania.

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

   a. Válassza az Ablak>Nézet megjelenítése>Kiszolgálók lehetőséget.

   b. A kiszolgálók lapon válassza a Nincs elérhető kiszolgáló. Új kiszolgáló létrehozásához kattintson erre a hivatkozásra hivatkozást.

   c. Az Új kiszolgáló definiálása ablakban bontsa ki az Apache elemet, majd jelölje ki a számítógépén futtatott Tomcat-kiszolgálót. Ez lehet például Tomcat v9.0 Server.

   d. Kattintson a Tovább gombra.

   e. A Tomcat-kiszolgáló ablakban válassza a Tallózás lehetőséget, és lépjen a Tomcat-kiszolgálót tartalmazó könyvtárra.

   f. A Tomcat-kiszolgáló ablakban válassza a Telepített JRE-k elemet.

   : A Telepített JRE-k ablakban jelölje ki a rendelkezésre álló jre elemet, majd válassza az Alkalmazás és bezárás lehetőséget.

   h. A Tomcat-kiszolgáló 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

   Az Eclipse problémába ütközhet, ha az elérési út túl hosszú. A probléma elkerülése érdekében ügyeljen arra, hogy az alkalmazás könyvtára ne legyen túl mélyen beágyazva a gép könyvtárstruktúrájába.

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

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

   c. Válassza a Befejezés gombot.

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 menüpontot.

   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 az Ön által 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. Töltse ki a szükséges paramétereket

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

    b. Bontsa ki a Java-erőforrások elemet.

    c. Bontsa ki az src elemet.

    d. Bontsa ki a com.embedsample.appoensdata.config elemet.

    e. Nyissa meg a Config.java elemet.

    f. Töltse ki az alábbi paraméterértékeket a hitelesítési módszernek megfelelően:

    Paraméter	Szolgáltatásnév	Elsődleges felhasználó
    authenticationType	Szolgáltatásnév	MasterUser
    workspaceId	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító
    reportId	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító
    clientId	Az Azure AD-alkalmazás ügyfél-azonosítója	Az Azure AD-alkalmazás ügyfél-azonosítója
    pbiUsername	N.A.	Az elsődleges felhasználó felhasználóneve, lásd: Power BI-felhasználónév és -jelszó
    pbiPassword	N.A.	Az elsődleges felhasználó jelszava, lásd: Power BI-felhasználónév és -jelszó
    tenantId	Az Azure AD-bérlőazonosító	N.A.
    appSecret	Az Azure AD-beli titkos ügyfélkulcs	N.A.

11. A projekt futtatása

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

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

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

    d. Válassza a Befejezés gombot.

Node JS

6. Nyissa meg az App Owns Data mappát a választott integrált fejlesztőkörnyezet használatával. Javasolt az alábbiak egyikének használata:

   • 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ő paranccsal: npm install.

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

9. Töltse ki az alábbi paraméterértékeket a hitelesítési módszernek megfelelően:

   Paraméter	Szolgáltatásnév	Elsődleges felhasználó
   authenticationMode	Szolgáltatásnév	MasterUser
   clientId	Az Azure AD-alkalmazás ügyfél-azonosítója	Az Azure AD-alkalmazás ügyfél-azonosítója
   workspaceId	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító
   reportId	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító
   pbiUsername	N.A.	Az elsődleges felhasználó felhasználóneve, lásd: Power BI-felhasználónév és -jelszó
   pbiPassword	N.A.	Az elsődleges felhasználó jelszava, lásd: Power BI-felhasználónév és -jelszó
   clientSecret	Az Azure AD-beli titkos ügyfélkulcs	N.A.
   tenantId	Az Azure AD-bérlőazonosító	Az Azure AD-bérlőazonosító

10. Futtassa a projektet az alábbi lépésekben:

    a. Az integrált fejlesztőkörnyezet termináljában hajtsa végre az npm start parancsot.

    b. Nyisson meg új lapot a böngészőben, és lépjen a http://localhost:5300 címre.

Python

6. Nyissa meg a PowerShellt vagy a Parancssort.

7. Ellenőrizze, hogy a Python>Embed for your customers mappában van, és a mappban megtalálható a requirements.txt fájl, majd adja ki a pip3 install -r requirements.txt parancsot.

8. Nyissa meg az App Owns Data mappát a választott integrált fejlesztőkörnyezet használatával. Javasolt az alábbiak egyikének használata:

   • Visual Studio

   • Visual Studio Code

9. Nyissa meg a config.py fájlt.

10. Töltse ki az alábbi paraméterértékeket a hitelesítési módszernek megfelelően:

    Paraméter	Szolgáltatásnév	Elsődleges felhasználó
    AUTHENTICATION_MODE	Szolgáltatásnév	MasterUser
    WORKSPACE_ID	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító	A beágyazott jelentést tartalmazó munkaterület azonosítója, lásd: munkaterület-azonosító
    REPORT_ID	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító	A beágyazandó jelentés azonosítója, lásd: jelentésazonosító
    TENANT_ID	Az Azure AD-bérlőazonosító	N.A.
    CLIENT_ID	Az Azure AD-alkalmazás ügyfél-azonosítója	Az Azure AD-alkalmazás ügyfél-azonosítója
    CLIENT_SECRET	Az Azure AD-beli titkos ügyfélkulcs	N.A.
    POWER_BI_USER	N.A.	Az elsődleges felhasználó felhasználóneve, lásd: Power BI-felhasználónév és -jelszó
    POWER_BI_PASS	N.A.	Az elsődleges felhasználó jelszava, lásd: Power BI-felhasználónév és -jelszó

11. Mentse a fájlt.

12. Futtassa a projektet az alábbi lépésekben:

    a. A PowerShellben vagy a Command Promptban lépjen a Python>Embed for your customers>AppOwnesData mappára, majd adja ki a flask run parancsot.

    b. Nyisson meg új lapot a böngészőben, és lépjen a http://localhost:5000 címre.

Az alkalmazás fejlesztése

A beágyazás az ügyfelek számára mintaalkalmazás konfigurálása és futtatása után megkezdheti egy saját alkalmazás fejlesztését.

Próbálja ki a Power BI beágyazott elemzési játszóterét, hogy megkezdje a fejlesztést, és lépést tartson az új Power BI Embedded funkciókkal és frissítésekkel.

Ha készen áll, tekintse át az éles üzemre való átállás követelményeit. Egy kapacitásra is szüksége lesz, és az igényeinek leginkább megfelelő termékváltozat kiválasztásához érdemes elolvasnia a kapacitástervezésről szóló cikket.

Fontos

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

Következő lépések

• Átállás éles üzemre
• Beágyazás a cég számára
• Lapszámozott jelentések beágyazása

További kérdései vannak? Kérdezze meg a Power BI közösségét.