Självstudie: Bädda in Power BI-innehåll med hjälp av en exempelinbäddning för ditt organisationsprogram

Med Power BI Embedded-analys kan du bädda in Power BI-innehåll, till exempel rapporter, instrumentpaneler och paneler, i ditt program.

I den här självstudien får du lära dig att:

• Konfigurera din inbäddade miljö.
• Konfigurera en inbäddning för din organisation (även kallat användar äger data) exempelprogram.

Om du vill använda ditt program måste användarna logga in på Power BI.

Inbäddningen för din organisationslösning används vanligtvis av företag och stora organisationer och är avsedd för interna användare.

Viktigt!

Om du bäddar in innehåll för ett nationellt/regionalt moln är de första stegen i den här självstudien olika. Mer information finns i Bädda in innehåll för nationella/regionala moln .

Specifikationer för kodexempel

Den här självstudien innehåller instruktioner för att konfigurera en inbäddning för din organisations exempelprogram i något av följande ramverk:

• .NET Framework
• .NET Core
• React TypeScript

Kommentar

Med .NET Core- och .NET Framework-exemplen kan slutanvändaren visa alla Power BI-instrumentpaneler, rapporter eller paneler som de har åtkomst till i Power BI-tjänst. Med React TypeScript-exemplet kan du bara bädda in en rapport som slutanvändaren redan har åtkomst till i Power BI-tjänst.

Kodexemplen stöder följande webbläsare:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Förutsättningar

Innan du påbörjar den här självstudien kontrollerar du att du har både följande Power BI och kodberoenden:

• Power BI-beroenden

  • Din egen Microsoft Entra-klientorganisation.

    • En av följande licenser:

      • Power BI Pro

      • Premium per användare (PPU)

    Kommentar

    Om du vill flytta till produktion behöver du någon av följande konfigurationer:

    • Alla användare med Pro-licenser.
    • Alla användare med PPU-licenser.
    • En SKU som motsvarar eller är högre än en F64-SKU. Med den här konfigurationen kan alla användare ha kostnadsfria licenser.

• Kodberoenden

  .NET Core

  • .NET Core 3.1 SDK (eller senare)

  • En integrerad utvecklingsmiljö (IDE). Vi rekommenderar att du använder någon av följande ID:er:

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • En textredigerare

  • Kommandoradsterminal (eller PowerShell)

---

Metod

Följ dessa steg för att skapa en inbäddning för din organisations exempelapp:

1. Registrera ett Microsoft Entra-program.

2. Skapa en Power BI-arbetsyta.

3. Skapa och publicera en Power BI-rapport.

4. Hämta parametervärdena för inbäddning.

5. Bädda in ditt innehåll.

Steg 1 – Registrera ett Microsoft Entra-program

Genom att registrera ditt program med Microsoft Entra-ID kan du upprätta en identitet för din app.

Om du vill registrera ditt program med Microsoft Entra-ID följer du anvisningarna i Registrera ditt program.

Steg 2 – Skapa en Power BI-arbetsyta

Power BI behåller dina rapporter, instrumentpaneler och paneler på en arbetsyta. Om du vill bädda in dessa objekt måste du skapa dem och ladda upp dem till en arbetsyta.

Dricks

Om du redan har en arbetsyta kan du hoppa över det här steget.

Gör följande för att skapa en arbetsyta:

1. Logga in på Power BI.

2. Välj arbetsytor.

3. Välj Skapa en arbetsyta.

4. Ge arbetsytan ett namn och välj Spara.

Steg 3 – Skapa och publicera en Power BI-rapport

Nästa steg är att skapa en rapport och ladda upp den till din arbetsyta. Du kan skapa en egen rapport med Power BI Desktop och sedan publicera den på din arbetsyta. Eller så kan du ladda upp en exempelrapport till din arbetsyta.

Dricks

Om du redan har en arbetsyta med en rapport kan du hoppa över det här steget.

Följ dessa steg för att ladda ned en exempelrapport och publicera den till din arbetsyta:

1. Öppna mappen GitHub Power BI Desktop-exempel .

2. Välj Kod och välj sedan Ladda ned zip.

   

3. Extrahera den nedladdade ZIP:en och gå till mappen Exempelrapporter .

4. Välj en rapport som ska bäddas in och publicera den på din arbetsyta.

Steg 4 – Hämta parametervärdena för inbäddning

Om du vill bädda in ditt innehåll måste du hämta några parametervärden. Parametervärdena beror på språket för det exempelprogram som du vill använda. Tabellen nedan visar vilka parametervärden som krävs för varje exempel.

Parameter	.NET Core	.NET Framework	React TypeScript
Klient-ID
Client secret
Arbetsyte-ID
Rapport-ID

Client ID

Dricks

Gäller för: .NET Core .NET Framework React TypeScript

Följ dessa steg för att hämta klient-ID:ts GUID (även kallat program-ID):

1. Logga in på Microsoft Azure.

2. Sök efter Appregistreringar och välj länken Appregistreringar.

3. Välj den Microsoft Entra-app som du använder för att bädda in ditt Power BI-innehåll.

4. I avsnittet Översikt kopierar du program-ID:t (klient-ID :t).

Klienthemlighet

Dricks

Gäller för: .NET Core .NET Framework React TypeScript

Följ dessa steg för att hämta klienthemligheten:

1. Logga in på Microsoft Azure.

2. Sök efter Appregistreringar och välj länken Appregistreringar.

3. Välj den Microsoft Entra-app som du använder för att bädda in ditt Power BI-innehåll.

4. Under Hantera väljer du Certifikat och hemligheter.

5. Under Klienthemligheter väljer du Ny klienthemlighet.

6. I popup-fönstret Lägg till en klienthemlighet anger du en beskrivning av programhemligheten, väljer när programhemligheten upphör att gälla och väljer Lägg till.

7. I avsnittet Klienthemligheter kopierar du strängen i kolumnen Värde i den nyligen skapade programhemligheten. Värdet för klienthemligheten är ditt klient-ID.

Kommentar

Se till att du kopierar värdet för klienthemligheten när det först visas. När du har navigerat bort från den här sidan döljs klienthemligheten och du kan inte hämta dess värde.

Arbetsplats-ID

Dricks

Gäller för: .NET Core .NET Framework React TypeScript

Följ dessa steg för att hämta arbetsyte-ID:ts GUID:

1. Logga in på Power BI-tjänst.

2. Öppna den rapport som du vill bädda in.

3. Kopiera GUID från URL:en. GUID är talet mellan /groups/ och /reports/.

   

Rapport-ID

Dricks

Gäller för: .NET Core .NET Framework ReactTypeScript

Följ dessa steg för att hämta rapport-ID:ts GUID:

1. Logga in på Power BI-tjänst.

2. Öppna den rapport som du vill bädda in.

3. Kopiera GUID från URL:en. GUID är talet mellan /reports/ och /ReportSection.

   

Steg 5 – Bädda in ditt innehåll

Med Power BI Embedded-exempelprogrammet kan du skapa en inbäddning för din organisation Power BI-app.

Följ de här stegen för att ändra inbäddningen för din organisations exempelprogram för att bädda in din Power BI-rapport.

1. Öppna mappen Power BI-utvecklarexempel.

2. Välj Kod och välj sedan Ladda ned zip.

   

3. Extrahera den nedladdade ZIP-filen och gå till mappen PowerBI-Developer-Samples-master .

4. Öppna någon av följande mappar beroende på vilket språk du vill att programmet ska använda:

   • .NET Core
   • .NET Framework
   • React-TS

   Kommentar

   Inbäddningen för din organisations exempelprogram stöder endast de tidigare angivna ramverken. Java-, Node JS- och Python-exempelprogrammen stöder endast inbäddning för dina kunders lösning.

.NET Core

Konfigurera din Microsoft Entra-app

1. Logga in på Azure-portalen.

2. Välj Appregistreringar. Om du inte kan se det här alternativet söker du efter det.

3. Öppna Microsoft Entra-programmet som du skapade i Steg 1 – Registrera ett Microsoft Entra-program.

4. På menyn Hantera väljer du Autentisering.

5. I Plattformskonfigurationer öppnar du din webbplattform och i avsnittet Omdirigerings-URI:er lägger du till https://localhost:5000/signin-oidc.

   Kommentar

   Om du inte har någon webbplattform väljer du Lägg till en plattform och i fönstret Konfigurera plattformar väljer du Webb.

6. Spara dina ändringar.

Konfigurera exempelinbäddningsappen

1. Öppna mappen Bädda in för din organisation.

2. Öppna inbäddningen för din organisations exempelapp med någon av följande metoder:

   • Om du använder Visual Studio öppnar du filen UserOwnsData.sln .

   • Om du använder Visual Studio Code öppnar du mappen UserOwnsData .

3. Öppna appsettings.json och fyll i följande parametervärden:

   • ClientId– Använda klient-ID GUID

   • ClientSecret – Använd klienthemligheten

Kör exempelappen

1. Kör projektet genom att välja lämpligt alternativ:

   • Om du använder Visual Studio väljer du IIS Express (spela upp).

   • Om du använder Visual Studio Code väljer du Kör > starta felsökning.

2. Logga in i inbäddningsexempelprogrammet.

   Kommentar

   Under din första inloggning uppmanas du att tillåta Microsoft Entra-behörigheter för appen.

3. När inbäddningsexempelprogrammet läses in väljer du det Power BI-innehåll som du vill bädda in och väljer sedan Bädda in.

   

.NET Framework

Konfigurera din Microsoft Entra-app

1. Logga in på Azure-portalen.

2. Välj Appregistreringar. Om du inte kan se det här alternativet söker du efter det.

3. Öppna Microsoft Entra-programmet som du skapade i Steg 1 – Registrera ett Microsoft Entra-program.

4. På menyn Hantera väljer du Autentisering.

5. I Plattformskonfigurationer konfigurerar du följande alternativ:

   1. Lägg till i avsnittet Omdirigerings-URI:er i webbplattformen.https://localhost:44300/

      Kommentar

      Om du inte har någon webbplattform väljer du Lägg till en plattform och i fönstret Konfigurera plattformar väljer du Webb.

   2. I Implicit beviljande och hybridflöden aktiverar du alternativet ID-token .

6. Spara dina ändringar.

Konfigurera exempelinbäddningsappen

1. Öppna mappen Bädda in för din organisation.

2. Öppna filen UserOwnsData.sln med Visual Studio.

3. Öppna Web.config och fyll i följande parametervärden:

   • clientId– Använda klient-ID GUID

   • clientSecret – Använd klienthemligheten

Kör exempelappen

1. Kör projektet genom att välja IIS Express (spela upp).

2. Logga in i inbäddningsexempelprogrammet.

   Kommentar

   Under din första inloggning uppmanas du att tillåta Microsoft Entra-behörigheter för appen.

3. När inbäddningsexempelprogrammet läses in väljer du det Power BI-innehåll som du vill bädda in och väljer sedan Bädda in.

   

React TypeScript

Konfigurera din Microsoft Entra-app

1. Logga in på Azure-portalen.

2. Välj Appregistreringar. Om du inte kan se det här alternativet söker du efter det.

3. Öppna Microsoft Entra-programmet som du skapade i Steg 1 – Registrera ett Microsoft Entra-program.

4. På menyn Hantera väljer du Autentisering.

5. I Plattformskonfigurationer konfigurerar du din webbplattform på följande sätt:

   1. I Omdirigerings-URI:er lägger du till https://localhost:3000 och väljer Konfigurera.

      Kommentar

      Om du inte har någon webbplattform väljer du Lägg till en plattform och i fönstret Konfigurera plattformar väljer du Webb.

   2. I Implicit beviljande och hybridflöden aktiverar du båda alternativen:

      • Åtkomsttoken
      • ID-token

6. Spara dina ändringar.

Konfigurera exempelinbäddningsappen

1. Öppna mappen Bädda in för din organisation>UserOwnsData>src.

2. Öppna filen Config.ts med hjälp av en textredigerare och fyll i följande parametervärden:

   • clientId– Använda klient-ID GUID

   • workspaceId – Använd arbetsyte-ID: t

   • reportId – Använd rapport-ID: t

3. Spara filen.

Kör exempelappen

1. Öppna en terminal och gå till Bädda in för din organisation>UserOwnsData.

2. Installera nödvändiga beroenden genom att ange följande kommando:

   npm install

3. Kör programmet genom att ange följande kommando:

   npm run start

   Kommentar

   Under din första inloggning uppmanas du att tillåta Microsoft Entra-behörigheter för appen.

Utveckla ditt program

När du har konfigurerat och kört inbäddningen för kundernas exempelprogram kan du börja utveckla ditt eget program.

Uppdatera användarbehörigheter

Användare behöver behörighet att komma åt power BI-mappen som rapporten finns i. När du ger en användare behörighet att komma åt en mapp börjar ändringen vanligtvis gälla först efter att användaren har loggat in på Power BI-portalen. För att de nya behörigheterna ska börja gälla omedelbart gör du ett explicit anrop till REST-API:et RefreshUser Permissions vid start i embedded-scenariot. Det här API-anropet uppdaterar behörigheterna och undviker auktoriseringsfel för användare med nyligen beviljade behörigheter.

Relaterat innehåll

Självstudie: Bädda in Power BI-innehåll med hjälp av en exempelinbäddning för dina kunders program

Bädda in sidnumrerade rapporter

Fråga Power BI Community