Oktatóanyag: Power BI tartalom beágyazása a szervezeti alkalmazás mintájának beágyazásávalTutorial: Embed Power BI content using a sample embed for your organization application

A Power BI Embedded Analytics 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.Power BI embedded analytics allows you to embed Power BI content such as reports, dashboards and tiles, into your application.

Ebből az oktatóanyagból az alábbiakat sajátíthatja el:In this tutorial, you'll learn how to:

  • A beágyazott környezet beállítása.Set up your embedded environment.
  • Konfiguráljon egy beágyazást a szervezetéhez (más néven a felhasználó tulajdonában lévő adattulajdonost) minta alkalmazás.Configure an embed for your organization (also known as user owns data) sample application.

Az alkalmazás használatához a felhasználóknak be kell jelentkezniük Power BIba.To use your application, your users will need to sign in to Power BI.

A Beágyazás a cég számára megoldást általában vállalatok és nagy szervezetek használják, és belső felhasználók számára készült.The embed for your organization solution is usually used by enterprises and big organizations, and is intended for internal users.

Mintakód-specifikációkCode sample specifications

Ez az oktatóanyag a következő keretrendszerek egyikében ismerteti a szervezeti minta alkalmazás beágyazásának konfigurálására vonatkozó utasításokat:This tutorial includes instructions for configuring an embed for your organization sample application in one of the following frameworks:

  • .NET-keretrendszer.NET Framework
  • .NET Core.NET Core
  • Írógéppel való reagálásReact TypeScript

Megjegyzés

A .net Core és a .NET-keretrendszer minták lehetővé teszik a végfelhasználó számára, hogy megtekintse a Power BI szolgáltatáshoz hozzáféréssel rendelkező Power bi irányítópultokat, jelentéseket vagy csempéket.The .NET Core and the .NET Framework samples will allow the end user to view any Power BI dashboard, report or tile they have access to in Power BI service. A reakciós írógéppel minta lehetővé teszi, hogy csak egy jelentést ágyazjon be, amelyhez a végfelhasználó már hozzáfér a Power bi szolgáltatáshoz.The React TypeScript sample lets you embed only one report that your end user already has access to on Power BI service.

A kódminták a következő böngészőket támogatják:The code samples support the following browsers:

  • Microsoft EdgeMicrosoft Edge
  • Google ChromeGoogle Chrome
  • Mozilla FirefoxMozilla Firefox

ElőfeltételekPrerequisites

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:Before you start this tutorial, verify that you have both the Power BI and code dependencies listed below:


MetódusMethod

A szervezeti minta alkalmazás beágyazásának létrehozásához kövesse az alábbi lépéseket:To create an embed for your organization sample app, follow these steps:

  1. Azure AD-alkalmazás regisztrálása.Register an Azure AD application.

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

  3. Power BI-jelentés létrehozása és közzététele.Create and publish a Power BI report.

  4. A beágyazási paraméterértékek megállapítása.Get the embedding parameter values.

  5. A tartalom beágyazása.Embed your content.

1. lépés – Azure AD-alkalmazás regisztrálásaStep 1 - Register an Azure AD application

Az alkalmazás Azure AD-vel való regisztrálása lehetővé teszi, hogy identitást hozzon létre az alkalmazáshoz.Registering your application with Azure AD allows you to establish an identity for your app.

Az alkalmazás Azure AD-beli regisztrálásához kövesse az Alkalmazás regisztrálása című cikk utasításait.To register your application with Azure AD, follow the instructions in Register your application.

2. lépés – Power BI munkaterület létrehozásaStep 2 - Create a Power BI workspace

A Power BI egy munkaterületen tartja a jelentéseket, irányítópultokat és csempéket.Power BI keeps your reports, dashboards, and tiles in a workspace. Ezeknek az elemeknek a beágyazásához létre kell hoznia, majd fel kell töltenie azokat egy munkaterületre.To embed these items, you'll need to create them and upload them into a workspace.

Tipp

Ha már rendelkezik munkaterülettel, ezt a lépést kihagyhatja.If you already have a workspace, you can skip this step.

Munkaterület létrehozásához hajtsa végre a következőket:To create a workspace, do the following:

  1. Jelentkezzen be a Power BI szolgáltatásba.Sign in to Power BI.

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

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

  4. Adjon nevet a munkaterületnek, és válassza a Mentés lehetőséget.Name your workspace and select Save.

3. lépés – Power BI-jelentés létrehozása és közzétételeStep 3 - Create and publish a Power BI report

A következő lépés egy jelentés létrehozása és feltöltése a munkaterületre.Your next step is to create a report and upload it to your workspace. Létrehozhat saját jelentést a Power BI Desktoppal, majd közzéteheti azt a munkaterületen.You can create your own report using Power BI Desktop, and then publish it to your workspace. Mintajelentést is feltölthet a munkaterületre.Or, you can upload a sample report to your workspace.

Tipp

Ha már van jelentéssel rendelkező munkaterülete, ezt a lépést kihagyhatja.If you already have a workspace with a report, you can skip this step.

Mintajelentést az alábbi lépésekben tölthet le és tehet közzé a munkaterületen:To download a sample report and publish it to your workspace, follow these steps:

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

  2. Válassza a Code majd a Download zip lehetőséget.Select Code and then select Download zip.

    A GitHub Power B I Desktop-minták ZIP letöltése lehetőségét ábrázoló képernyőkép

  3. Bontsa ki a letöltött ZIP-fájlt, és lépjen a Samples Reports mappára.Extract the downloaded ZIP and navigate to the Samples Reports folder.

  4. Válasszon ki egy beágyazandó jelentést, és tegye közzé a munkaterületen.Select a report to embed, and publish it to your workspace.

4. lépés – a beágyazási paraméterek értékeinek beolvasásaStep 4 - Get the embedding parameter values

A tartalom beágyazásához be kell szereznie néhány paraméter értékét.To embed your content, you'll need to obtain a few parameter values. A paramétereket a használni kívánt minta nyelvétől függően kell megadni.The parameter values you'll need depend on the language of the sample application you want to use. Az alábbi táblázat felsorolja, hogy mely paraméterek értékeit kell megadni az egyes mintákhoz.The table below lists which parameter values are required for each sample.

ParaméterParameter .NET Core.NET Core .NET-keretrendszer.NET Framework Írógéppel való reagálásReact TypeScript
Ügyfél-azonosítóClient ID A következőre vonatkozik. A következőre vonatkozik. A következőre vonatkozik.
Titkos ügyfélkulcsClient secret A következőre vonatkozik. A következőre vonatkozik. Nem vonatkozik a következőre.
Munkaterület azonosítójaWorkspace ID Nem vonatkozik a következőre. Nem vonatkozik a következőre. A következőre vonatkozik.
JelentésazonosítóReport ID Nem vonatkozik a következőre. Nem vonatkozik a következőre. A következőre vonatkozik.

Ügyfél-azonosítóClient ID

Tipp

A következőkre vonatkozik:  A következőre vonatkozik:. . A NET Core a következőre  vonatkozik:. . A NET  -keretrendszer a következőre vonatkozik:. Írógéppel való reagálásApplies to: Applies to..NET Core Applies to..NET Framework Applies to.React TypeScript

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:To get the client ID GUID (also know as application ID), follow these steps:

  1. Jelentkezzen be a Microsoft Azure-ba.Log into Microsoft Azure.

  2. Keressen rá az Alkalmazásregisztrációk szóra, majd válassza az Alkalmazásregisztrációk hivatkozást.Search for App registrations and select the App registrations link.

  3. Válassza ki a Power BI-tartalom beágyazásához használt Azure AD-alkalmazást.Select the Azure AD app your using for embedding your Power BI content.

  4. Az Áttekintés szakaszból másolja ki az Alkalmazás- (ügyfél-) azonosító GUID-értéket.From the Overview section, copy the Application (client) ID GUID.

Titkos ügyfélkulcsClient secret

Tipp

A következőkre vonatkozik:  A következőre vonatkozik:. . A NET Core a következőre  vonatkozik:. . A NET  -keretrendszer nem alkalmazható a következőre:. Írógéppel való reagálásApplies to: Applies to..NET Core Applies to..NET Framework Does not apply to.React TypeScript

A titkos ügyfélkulcsot az alábbi lépésekben állapíthatja meg:To get the client secret, follow these steps:

  1. Jelentkezzen be a Microsoft Azure-ba.Log into Microsoft Azure.

  2. Keressen rá az Alkalmazásregisztrációk szóra, majd válassza az Alkalmazásregisztrációk hivatkozást.Search for App registrations and select the App registrations link.

  3. Válassza ki a Power BI-tartalom beágyazásához használt Azure AD-alkalmazást.Select the Azure AD app your using for embedding your Power BI content.

  4. A Kezelés területen válassza a Tanúsítványok és titkos kódok lehetőséget.Under Manage, select Certificates & secrets.

  5. A Titkos ügyfélkulcsok területen válassza az Új titkos ügyfélkulcs lehetőséget.Under Client secrets, select New client secret.

  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.In the Add a client secret pop-up window, provide a description for your application secret, select when the application secret expires, and select Add.

  7. A Titkos ügyfélkulcs szakaszból másolja ki az újonnan létrehozott titkos alkalmazáskulcs Érték oszlopában lévő sztringet.From the Client secrets section, copy the string in the Value column of the newly created application secret. A titkos ügyfélkulcs értéke az ügyfél-azonosító.The client secret value is your client ID.

Munkaterület azonosítójaWorkspace ID

Tipp

A következőkre vonatkozik:  A nem vonatkozik a következőre:. . A NET Core  nem vonatkozik a következőre:. . A NET  -keretrendszer a következőre vonatkozik:. Írógéppel való reagálásApplies to: Does not apply to..NET Core Does not apply to..NET Framework Applies to.React TypeScript

A munkaterület azonosítóját az alábbi lépésekben állapíthatja meg:To get the workspace ID GUID, follow these steps:

  1. Jelentkezzen be a Power BI szolgáltatásba.Sign in to Power BI service.

  2. Nyissa meg a beágyazni kívánt jelentést.Open the report you want to embed.

  3. Másolja ki a GUID értékét az URL-címből.Copy the GUID from the URL. A GUID a /groups/ és a /reports/ szakasz közötti szám.The GUID is the number between /groups/ and /reports/.

    Munkaterületnek a Power B I szolgáltatás U R L-címében megjelenő azonosítóját ábrázoló képernyőkép

JelentésazonosítóReport ID

Tipp

A következőkre vonatkozik:  A nem vonatkozik a következőre:. . A NET Core  nem vonatkozik a következőre:. . A NET  -keretrendszer a következőre vonatkozik:. ReactTypeScriptApplies to: Does not apply to..NET Core Does not apply to..NET Framework Applies to.ReactTypeScript

A jelentéskészítő GUID azonosítójának lekéréséhez kövesse az alábbi lépéseket:To get the report ID GUID, follow these steps:

  1. Jelentkezzen be a Power BI szolgáltatásba.Sign in to Power BI service.

  2. Nyissa meg a beágyazni kívánt jelentést.Open the report you want to embed.

  3. Másolja ki a GUID értékét az URL-címből.Copy the GUID from the URL. A GUID a /reports/ és a /ReportSection szakasz közötti szám.The GUID is the number between /reports/ and /ReportSection.

    Jelentésnek a Power B I szolgáltatás U R L-címében megjelenő azonosítóját ábrázoló képernyőkép

5. lépés – A tartalom beágyazásaStep 5 - Embed your content

A Power BI Embedded minta alkalmazással beágyazást hozhat létre a szervezet Power bi alkalmazásához.The Power BI embedded sample application allows you to create an embed for your organization Power BI app.

Az alábbi lépéseket követve módosíthatja a szervezeti minta alkalmazás beágyazását a Power bi-jelentés beágyazásához.Follow these steps to modify the embed for your organization sample application, to embed your Power BI report.

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

  2. Válassza a Code majd a Download zip lehetőséget.Select Code and then select Download zip.

    A GitHub fejlesztői Power B I-minták ZIP letöltése lehetőségét ábrázoló képernyőkép

  3. Bontsa ki a letöltött ZIP-fájlt, és lépjen a PowerBI-Developer-Samples-master mappára.Extract the downloaded ZIP and navigate to the PowerBI-Developer-Samples-master folder.

  1. Az alkalmazáshoz használni kívánt nyelvtől függően nyissa meg az alábbi mappák egyikét:Depending on the language you want your application to use, open one of these folders:

    • .NET Core.NET Core
    • .NET-keretrendszer.NET Framework
    • Reagálás – TSReact-TS

    Megjegyzés

    A szervezetbe való beágyazás csak a fent felsorolt keretrendszereket támogatja.The embed for your organization sample applications only support the frameworks listed above. A Java, a Node js és a Python minta alkalmazások csak az ügyfelek megoldásához használható beágyazást támogatják.The Java, Node JS and Python sample applications, only support the embed for your customers solution.

Az Azure AD-alkalmazás konfigurálásaConfigure your Azure AD app

  1. Jelentkezzen be az Azure Portalra.Sign into the Azure portal.

  2. Válassza az Alkalmazásregisztrációk lehetőséget.Select App registrations. Ha nem látja ezt a lehetőséget, keressen rá.If you can't see this option, search for it.

  3. Nyissa meg az 1. lépésben létrehozott Azure AD -alkalmazást – Azure ad-alkalmazás regisztrálása.Open the Azure AD application you created in Step 1 - Register an Azure AD application.

  4. A kezelés menüben válassza a hitelesítés lehetőséget.From the Manage menu, select Authentication.

  1. A platform konfigurációjában nyissa meg a webplatformot, és az átirányítási URI -k szakaszban adja hozzá a következőt : https://localhost:5000/signin-oidc .In Platform configurations, open your Web platform and in the Redirect URIs section, add https://localhost:5000/signin-oidc.

    Megjegyzés

    Ha nem rendelkezik webplatformmal , válassza a platform hozzáadása lehetőséget, majd a platformok konfigurálása ablakban válassza a web lehetőséget.If you don't have a Web platform, select Add a platform and in the Configure platforms window, select Web.

  2. Mentse a módosításokat.Save your changes.

Képernyőkép az Azure AD-alapú hitelesítési konfigurációkról, beleértve a web redirect U R I-t a .NET Core app Sample-hez.

A minta-beágyazási alkalmazás konfigurálásaConfigure the sample embedding app

  1. Nyissa meg a céges mappa beágyazását .Open the Embed for your organization folder.

  2. A következő módszerek egyikével nyissa meg a céges példa beágyazása alkalmazást :Open the embed for your organization sample app using one of these methods:

  3. Nyissa megappsettings.jsbe és töltse ki a következő paramétereket:Open appsettings.json and fill in the following parameter values:

A mintaalkalmazás futtatásaRun the sample app

  1. Futtassa a projektet a megfelelő lehetőség kiválasztásával:Run the project by selecting the appropriate option:

    • Ha a Visual Studiót használja, válassza az IIS Express (lejátszás) lehetőséget.If you're using Visual Studio, select IIS Express (play).

    • Ha a Visual Studio Code-ot használja, válassza a Futtatás > Hibakeresés indítása lehetőséget.If you're using Visual Studio Code, select Run > Start Debugging.

  1. Jelentkezzen be a beágyazási minta alkalmazásba.Sign into the embedding sample application.

    Megjegyzés

    Az első bejelentkezéskor a rendszer felszólítja, hogy engedélyezze az alkalmazás Azure AD-engedélyeit.During your first sign in, you'll be prompted to allow Azure AD permissions for the app.

  2. Amikor a beágyazási minta alkalmazás betöltődik, válassza ki a beágyazni kívánt tartalmat Power BI, majd válassza a beágyazás lehetőséget.When the embedding sample application loads, select the Power BI content you want to embed and then select Embed.

    A Power BI beágyazási minta alkalmazást ábrázoló képernyőkép.

Az alkalmazás fejlesztéseDeveloping your application

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.After configuring and running the embed for your customers sample application, you can start developing your own application.

Ha készen áll, tekintse át az éles üzemre való átállás követelményeit.When you're ready, review the move to production requirements. Szüksége lesz egy kapacitásrais, és tekintse át a kapacitás megtervezése című cikket, amelyből megtudhatja, melyik SKU-nak ajánlott a legmegfelelőbb.You'll also need a capacity, and should review the capacity planning article to establish which SKU best suites your needs.

Következő lépésekNext steps