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

GÄLLER FÖR: Appen äger data Användaren äger data

Med inbäddad analys och Power BI Embedded (Azure-erbjudandet) kan du bädda in Power BI-innehåll som 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 dina kunder (kallas även app äger data) exempelprogram.

Om du vill använda ditt program behöver användarna inte logga in på Power BI eller ha en Power BI-licens.

Vi rekommenderar att du använder metoden embed for your customers för att bädda in ditt Power BI-innehåll, om du är en oberoende programvaruleverantör (ISV) eller en utvecklare som vill skapa program för tredje part.

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 dina kunders exempelprogram i något av följande ramverk:

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

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 Power BI och kodberoenden som anges nedan:

Metod

Följ dessa steg för att skapa en inbäddning för dina kunders exempelapp:

  1. Välj din autentiseringsmetod.

  2. Registrera ett Microsoft Entra-program.

  3. Skapa en Power BI-arbetsyta.

  4. Skapa och publicera en Power BI-rapport.

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

  6. API-åtkomst för tjänstens huvudnamn

  7. Aktivera åtkomst till arbetsytan.

  8. Bädda in ditt innehåll.

Steg 1 – Välj din autentiseringsmetod

Din inbäddade lösning varierar beroende på vilken autentiseringsmetod du väljer. Därför är det viktigt att förstå skillnaderna mellan autentiseringsmetoderna och bestämma vilken som passar bäst för din lösning.

I tabellen nedan beskrivs några viktiga skillnader mellan autentiseringsmetoderna för tjänstens huvudnamn och huvudanvändare .

Att tänka på Tjänstens huvudnamn Huvudanvändare
Mekanism Med microsoft Entra-appens huvudobjekt för tjänsten kan Microsoft Entra-ID autentisera din inbäddade lösningsapp mot Power BI. Din Microsoft Entra-app använder autentiseringsuppgifterna (användarnamn och lösenord) för en Power BI-användare för att autentisera mot Power BI.
Säkerhet Tjänstens huvudnamn är den rekommenderade auktoriseringsmetoden för Microsoft Entra-ID. Om du använder ett huvudnamn för tjänsten kan du autentisera med antingen en programhemlighet eller ett certifikat.

I den här självstudien beskrivs endast användning av tjänstens huvudnamn med en programhemlighet. Om du vill bädda in med tjänstens huvudnamn och ett certifikat läser du tjänstens huvudnamn med en certifikatartikel .
Den här autentiseringsmetoden är inte lika säker som tjänstens huvudnamn. Du måste vara vaksam med autentiseringsuppgifterna för huvudanvändaren (användarnamn och lösenord). Exponera dem till exempel inte i inbäddningsprogrammet och ändra lösenordet ofta.
Delegerade behörigheter för Microsoft Entra-ID Krävs inte. Huvudanvändareneller administratören måste bevilja medgivande för att din app ska få åtkomst till Power BI REST API-behörigheter (kallas även omfång). Till exempel Report.ReadWrite.All.
Power BI-tjänst åtkomst Du kan inte komma åt Power BI-tjänst med tjänstens huvudnamn. Du kan komma åt Power BI-tjänst med dina huvudanvändares autentiseringsuppgifter.
Licens Kräver ingen Pro-licens. Du kan använda innehåll från valfri arbetsyta som du är medlem i eller administratör för. Kräver en Licens för Power BI Pro eller Premium per användare (PPU).

Steg 2 – Registrera ett Microsoft Entra-program

Genom att registrera ditt program med Microsoft Entra-ID kan du:

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

Kommentar

Innan du registrerar ditt program måste du bestämma vilken autentiseringsmetod som ska användas, tjänstens huvudnamn eller huvudanvändare.

Steg 3 – 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 4 – 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.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  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 5 – Hämta parametervärdena för inbäddning

Om du vill bädda in ditt innehåll måste du hämta vissa parametervärden. Tabellen nedan visar de värden som krävs och anger om de gäller för autentiseringsmetoden för tjänstens huvudnamn , autentiseringsmetoden för huvudanvändare eller båda.

Innan du bäddar in ditt innehåll kontrollerar du att du har alla värden som anges nedan. Vissa av värdena skiljer sig åt beroende på vilken autentiseringsmetod du använder.

Parameter Tjänstens huvudnamn Huvudanvändare
Klient-ID Applies to. Applies to.
Arbetsyte-ID Applies to. Applies to.
Rapport-ID Applies to. Applies to.
Client secret Applies to. Does not apply to.
Tenant ID Applies to. krävs endast för Node JS
Power BI-användarnamn Does not apply to. Applies to.
Power BI-lösenord Does not apply to. Applies to.

Client ID

Dricks

Gäller för:Applies to.Huvudanvändare för tjänstens huvudnamn Applies to.

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

Arbetsplats-ID

Dricks

Gäller för:Applies to.Huvudanvändare för tjänstens huvudnamn Applies to.

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

    A screenshot showing workspace ID GUID in the Power B I service U R L

Du kan också hitta arbetsyte-ID:t i administratörsportalens inställningar genom att välja Information bredvid arbetsytans namn.

A screenshot showing how to find the workspace I D from the admin settings.

Rapport-ID

Dricks

Gäller för:Applies to.Huvudanvändare för tjänstens huvudnamn Applies to.

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.

    A screenshot showing report ID GUID in the Power B I service U R L

Klienthemlighet

Dricks

Gäller för:Applies to.Huvudanvändare för tjänstens huvudnamn Does not apply to.

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.

Klientorganisations-ID

Dricks

Gäller för:Applies to.Huvudanvändare för tjänstens huvudnamn Does not apply to.

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

  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 katalog-ID:t (klientorganisations-ID ).

Användarnamn och lösenord för Power BI

Dricks

Gäller för:Does not apply to.Huvudanvändare för tjänstens huvudnamn Applies to.

Hämta användarnamnet och lösenordet för den Power BI-användare som du använder som huvudanvändare. Det här är samma användare som du använde för att skapa en arbetsyta och ladda upp en rapport till i Power BI-tjänst.

Steg 6 – API-åtkomst för tjänstens huvudnamn

Dricks

Gäller för:Applies to.Huvudanvändare för tjänstens huvudnamn Does not apply to.

Det här steget är bara relevant om du använder autentiseringsmetoden för tjänstens huvudnamn . Om du använder en huvudanvändare hoppar du över det här steget och fortsätter med Steg 7 – Aktivera åtkomst till arbetsytan.

För att en Microsoft Entra-app ska kunna komma åt Power BI-innehåll och API:er måste en Power BI-administratör aktivera åtkomst till tjänstens huvudnamn i Power BI-administratörsportalen. Om du inte är administratör för din klientorganisation hämtar du klientorganisationens administratör för att aktivera klientinställningarna åt dig.

  1. I Power BI-tjänst väljer du Inställningar> Inställningar> Admin-portalen.

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

  2. Välj Klientinställningar och rulla sedan ned till avsnittet Inställningar för utvecklare .

  3. Expandera Tillåt att tjänstens huvudnamn använder Power BI-API och aktivera det här alternativet.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

Kommentar

När du använder tjänstens huvudnamn rekommenderar vi att du begränsar dess åtkomst till klientinställningarna med hjälp av en säkerhetsgrupp. Mer information om den här funktionen finns i de här avsnitten i artikeln tjänstens huvudnamn :

Steg 7 – Aktivera åtkomst till arbetsyta

Om du vill aktivera åtkomstobjekt för Microsoft Entra-appen, till exempel rapporter, instrumentpaneler och semantiska modeller i Power BI-tjänst, lägger du till tjänstens huvudnamn eller huvudanvändare som medlem eller administratör på din arbetsyta.

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

  2. Rulla till den arbetsyta som du vill aktivera åtkomst för och välj Åtkomst till arbetsyta på menyn Mer.

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  3. I fönstret Åtkomst , beroende på vilken autentiseringsmetod du använder, kopierar du tjänstens huvudnamn eller huvudanvändare till textrutan Ange e-postadress .

    Kommentar

    Om du använder ett huvudnamn för tjänsten är namnet på det namn som du gav din Microsoft Entra-app.

  4. Markera Lägga till.

Steg 8 – Bädda in ditt innehåll

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

Följ de här stegen för att ändra inbäddningen för dina kunders 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.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

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

  1. Beroende på vilket språk du vill att din app ska använda öppnar du en av dessa mappar:

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

    Kommentar

    Inbäddningen för dina kunders exempelprogram stöder endast de ramverk som anges ovan. React-exempelprogrammet stöder endast inbäddning för din organisationslösning.

  2. Öppna mappen Bädda in för dina kunder.

  1. Öppna inbäddningen för dina kunders exempelapp med någon av följande metoder:

  2. Öppna appsettings.json.

  3. Fyll i följande parametervärden beroende på din autentiseringsmetod:

    Parameter Tjänstens huvudnamn Huvudanvändare
    AuthenticationMode ServicePrincipal MasterUser
    ClientId Ditt Microsoft Entra-appklient-ID Ditt Microsoft Entra-appklient-ID
    TenantId Ditt Klient-ID för Microsoft Entra Saknas
    PbiUsername Saknas Användarnamnet för huvudanvändaren finns i Användarnamn och lösenord för Power BI
    PbiPassword Ej tillämpligt Ditt huvudanvändarlösenord finns i Användarnamn och lösenord för Power BI
    ClientSecret Din Microsoft Entra-ID-klienthemlighet Ej tillämpligt
    WorkspaceId ID för arbetsytan med din inbäddade rapport finns i Arbetsyte-ID ID för arbetsytan med din inbäddade rapport finns i Arbetsyte-ID
    ReportId ID:t för den rapport som du bäddar in finns i Rapport-ID ID:t för den rapport som du bäddar in finns i Rapport-ID
  4. 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.

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.

Prova den inbäddade Analyslekplatsen för Power BI för att komma igång med att utveckla och hålla jämna drag med alla nya Power BI Embedded-funktioner och -uppdateringar.

När du är klar kan du granska övergången till produktionskraven . Du behöver också en kapacitet och bör granska artikeln om kapacitetsplanering för att fastställa vilken SKU som passar dina behov bäst.

Viktigt!

Om du använde kostnadsfria utvärderingstoken för inbäddning för utveckling måste du köpa en kapacitet för produktion. Tills en kapacitet har köpts fortsätter banderollen för den kostnadsfria utvärderingsversionen att visas överst i den inbäddade rapporten.

Har du fler frågor? Fråga Power BI Community.