Oktatóanyag: Power BI-tartalom beágyazása minta beágyazással a szervezeti alkalmazáshoz

A Beágyazott Power BI-elemzésekkel Power BI-tartalmakat, például jelentéseket, irányítópultokat és csempéket ágyazhat be 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 a szervezet (más néven felhasználó tulajdonában lévő adatok) mintaalkalmazáshoz.

Az alkalmazás használatához a felhasználóknak be kell jelentkeznie a Power BI-ba.

A szervezeti megoldás beágyazását általában nagyvállalatok és nagyvállalatok használják, belső felhasználók számára.

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 szervezeti mintaalkalmazás beágyazásának konfigurálásához az alábbi keretrendszerek egyikében:

• .NET-keretrendszer
• .NET Core
• React TypeScript

Feljegyzés

A .NET Core és a .NET-keretrendszer minták lehetővé teszik a végfelhasználó számára, hogy megtekintse az Power BI szolgáltatás elérhető Power BI-irányítópultokat, jelentéseket vagy csempét. A React TypeScript-minta segítségével csak egy jelentést ágyazhat be, amelyhez a végfelhasználó már rendelkezik hozzáféréssel a Power BI szolgáltatás.

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 a következő Power BI- és kódfüggőségekkel:

• Power BI-függőségek

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

    • Az alábbi licencek egyike:

      • Power BI Pro

      • Prémium felhasználónként (PPU)

    Feljegyzés

    Éles környezetbe való áthelyezéshez az alábbi konfigurációk egyikére lesz szüksége:

    • Minden Pro-licenccel rendelkező felhasználó.
    • Minden PPU-licenccel rendelkező felhasználó.
    • Egy F64 termékváltozatnak megfelelő vagy annál magasabb termékváltozat. Ez a konfiguráció lehetővé teszi, hogy minden felhasználó ingyenes licencekkel rendelkezzen.

• Kódfüggőségek

  .NET Core

  • .NET Core 3.1 SDK (vagy újabb)

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

    • Visual Studio

    • Visual Studio Code

  .NET-keretrendszer

  • .NET-keretrendszer 4.8

  • Visual Studio

  React TypeScript

  • Szövegszerkesztő

  • Parancssori terminál (vagy PowerShell)

---

Metódus

Ha beágyazást szeretne létrehozni a szervezeti mintaalkalmazáshoz, kövesse az alábbi lépéseket:

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

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

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

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

5. Beágyazza a tartalmat.

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

Az alkalmazás Microsoft Entra-azonosítóval való regisztrálásával identitást hozhat létre az alkalmazás számára.

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.

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

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

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

A tartalom beágyazásához be kell szereznie néhány paraméterértéket. A paraméterértékek a használni kívánt mintaalkalmazás nyelvétől függenek. Az alábbi táblázat felsorolja, hogy mely paraméterértékek szükségesek az egyes mintákhoz.

Paraméter	.NET Core	.NET-keretrendszer	React TypeScript
Ügyfélazonosító
Titkos ügyfélkód
Munkaterület azonosítója
Jelentésazonosító

Ügyfél azonosítója

Tipp.

A következőre vonatkozik: .NET Core .NET-keretrendszer React TypeScript

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.

Titkos ügyfélkód

Tipp.

A következőre vonatkozik: .NET Core .NET-keretrendszer React TypeScript

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.

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

Munkaterület azonosítója

Tipp.

A következőre vonatkozik: .NET Core .NET-keretrendszer React TypeScript

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.

   

Jelentésazonosító

Tipp.

A következőre vonatkozik: .NET Core .NET-keretrendszer ReactTypeScript

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.

   

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

A Power BI beágyazott mintaalkalmazása lehetővé teszi, hogy beágyazást hozzon létre a szervezet Power BI-alkalmazásához.

Az alábbi lépéseket követve módosíthatja a szervezeti mintaalkalmazás 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
   • React-TS

   Feljegyzés

   A szervezeti mintaalkalmazások beágyazása csak a korábban felsorolt keretrendszereket támogatja. A Java-, Node JS - és Python-mintaalkalmazások csak az ügyfélmegoldás beágyazását támogatják.

.NET Core

A Microsoft Entra-alkalmazás konfigurálása

1. Jelentkezzen be az Azure Portalra.

2. Válassza az Alkalmazásregisztrációk lehetőséget. Ha nem látja ezt a lehetőséget, keressen rá.

3. Nyissa meg az 1. lépésben létrehozott Microsoft Entra-alkalmazást – Regisztráljon egy Microsoft Entra-alkalmazást.

4. A Kezelés menüben válassza a Hitelesítés lehetőséget.

5. A platformkonfigurációkban nyissa meg a webplatformot, és az Átirányítási URI-k szakaszban adja hozzáhttps://localhost:5000/signin-oidc.

   Feljegyzés

   Ha nem rendelkezik webes platformmal, válassza a Platform hozzáadása lehetőséget, majd a Platformok konfigurálása ablakban válassza a Web lehetőséget.

6. Mentse a módosításokat.

A mintabeágyazási alkalmazás konfigurálása

1. Nyissa meg a beágyazást a szervezeti mappához.

2. Nyissa meg a szervezeti mintaalkalmazás beágyazását az alábbi módszerek egyikével:

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

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

3. Nyissa meg appsettings.json , és töltse ki a következő paraméterértékeket:

   • ClientId – Az ügyfélazonosító GUID azonosítója

   • ClientSecret - Az ügyfél titkos kódjának használata

A mintaalkalmazás futtatása

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

2. Jelentkezzen be a beágyazási mintaalkalmazásba.

   Feljegyzés

   Az első bejelentkezés során a rendszer kérni fogja, hogy engedélyezze a Microsoft Entra engedélyeit az alkalmazáshoz.

3. Amikor a beágyazási mintaalkalmazás betöltődik, válassza ki a beágyazni kívánt Power BI-tartalmat, majd válassza a Beágyazás lehetőséget.

   

.NET-keretrendszer

A Microsoft Entra-alkalmazás konfigurálása

1. Jelentkezzen be az Azure Portalra.

2. Válassza az Alkalmazásregisztrációk lehetőséget. Ha nem látja ezt a lehetőséget, keressen rá.

3. Nyissa meg az 1. lépésben létrehozott Microsoft Entra-alkalmazást – Regisztráljon egy Microsoft Entra-alkalmazást.

4. A Kezelés menüben válassza a Hitelesítés lehetőséget.

5. Platformkonfigurációkban konfigurálja a következő beállításokat:

   1. A webplatform Átirányítási URI-k szakaszában adja hozzá https://localhost:44300/a elemet.

      Feljegyzés

      Ha nem rendelkezik webes platformmal, válassza a Platform hozzáadása lehetőséget, és a Platformok konfigurálása ablakban válassza a Web lehetőséget.

   2. Implicit engedélyezési és hibrid folyamatok esetén engedélyezze az azonosító jogkivonatok beállítását .

6. Mentse a módosításokat.

A mintabeágyazási alkalmazás konfigurálása

1. Nyissa meg a beágyazást a szervezeti mappához.

2. Nyissa meg a UserOwnsData.sln fájlt a Visual Studióval.

3. Nyissa meg a Web.config fájlt , és töltse ki a következő paraméterértékeket:

   • clientId – Az ügyfélazonosító GUID azonosítója

   • clientSecret - Az ügyfél titkos kódjának használata

A mintaalkalmazás futtatása

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

2. Jelentkezzen be a beágyazási mintaalkalmazásba.

   Feljegyzés

   Az első bejelentkezés során a rendszer kérni fogja, hogy engedélyezze a Microsoft Entra engedélyeit az alkalmazáshoz.

3. Amikor a beágyazási mintaalkalmazás betöltődik, válassza ki a beágyazni kívánt Power BI-tartalmat, majd válassza a Beágyazás lehetőséget.

   

React TypeScript

A Microsoft Entra-alkalmazás konfigurálása

1. Jelentkezzen be az Azure Portalra.

2. Válassza az Alkalmazásregisztrációk lehetőséget. Ha nem látja ezt a lehetőséget, keressen rá.

3. Nyissa meg az 1. lépésben létrehozott Microsoft Entra-alkalmazást – Regisztráljon egy Microsoft Entra-alkalmazást.

4. A Kezelés menüben válassza a Hitelesítés lehetőséget.

5. A platformkonfigurációkban a következő módon konfigurálja a webplatformot:

   1. Az Átirányítási URI-kban adja hozzá https://localhost:3000 és válassza a Konfigurálás lehetőséget.

      Feljegyzés

      Ha nem rendelkezik webes platformmal, válassza a Platform hozzáadása lehetőséget, majd a Platformok konfigurálása ablakban válassza a Web lehetőséget.

   2. Implicit engedélyezési és hibrid folyamatokban engedélyezze mindkét lehetőséget:

      • Hozzáférési jogkivonatok
      • Azonosító jogkivonatok

6. Mentse a módosításokat.

A mintabeágyazási alkalmazás konfigurálása

1. Nyissa meg a beágyazást a szervezet>UserOwnsData>src mappájához.

2. Szövegszerkesztővel nyissa meg a Config.ts fájlt, és töltse ki a következő paraméterértékeket:

   • clientId – Az ügyfélazonosító GUID azonosítója

   • workspaceId – A munkaterület azonosítójának használata

   • reportId– A jelentésazonosító használata

3. Mentse a fájlt.

A mintaalkalmazás futtatása

1. Nyisson meg egy terminált, és keresse meg a Szervezet>UserOwnsData beágyazását.

2. Telepítse a szükséges függőségeket a következő parancs megadásával:

   npm install

3. Futtassa az alkalmazást a következő parancs megadásával:

   npm run start

   Feljegyzés

   Az első bejelentkezés során a rendszer kérni fogja, hogy engedélyezze a Microsoft Entra engedélyeit az alkalmazáshoz.

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.

Felhasználói engedélyek frissítése

A felhasználóknak engedélyre van szükségük ahhoz, hogy hozzáférjenek ahhoz a Power BI-mappához, amelyben a jelentés található. Amikor hozzáférést ad egy felhasználónak egy mappához, a módosítás általában csak azután lép érvénybe, hogy a felhasználó bejelentkezik a Power BI Portálra. Ahhoz, hogy az új engedélyek azonnal érvénybe léphessenek, az Embedded-forgatókönyvben hozzon létre egy explicit hívást a RefreshUser Permissions REST API-hoz indításkor. Ez az API-hívás frissíti az engedélyeket, és elkerüli az újonnan megadott engedélyekkel rendelkező felhasználók engedélyezési hibáit.

Kapcsolódó tartalom

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

Többoldalas jelentések beágyazása

Kérdezze meg a Power BI-közösség