Självstudie: Bädda in Power BI-innehåll med hjälp av en exempelinbäddning för dina kunders app
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 den inbäddade miljön.
- Konfigurera en inbäddning för dina kunders (kallas även appen äger data) exempelapp.
Användarna måste logga in i Power BI eller ha en Power BI-licens för att kunna använda ditt program.
Vi rekommenderar att du använder metoden bädda in för dina kunder när du bäddar 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.
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
Krav
Innan du börjar med självstudien kontrollerar du att du har både Power BI-beroendena och de kodberoenden som anges nedan:
Power BI-beroenden
Om du vill autentisera din app mot Power BI behöver du något av följande:
Tjänstens huvudnamn – ett huvudobjekt för tjänsten för Azure Active Directory (Azure AD) så att Azure AD kan autentisera din app.
Power BI Pro-licens – det här är din huvudanvändare och appen använder den för att autentisera till Power BI.
En PPU-licens (Premium per användare) för Power BI – det här är din huvudanvändare och appen använder den för att autentisera till Power BI.
Anteckning
Om du vill flytta till produktion behöver du en kapacitet.
Kodberoenden
.NET Core 3.1 SDK (eller senare)
En integrerad utvecklingsmiljö (IDE). Vi rekommenderar att du använder något av följande alternativ:
Metod
Följ dessa steg om du vill skapa en inbäddning för kundernas exempelapp:
Steg 1 – Välj en autentiseringsmetod
Den inbäddade lösningen varierar beroende på vilken autentiseringsmetod du väljer. Därför är det viktigt att förstå skillnaderna mellan autentiseringsmetoderna och välja den som passar bäst för din lösning.
I tabellen nedan beskrivs några viktiga skillnader mellan autentiseringsmetoderna tjänstens huvudnamn och huvudanvändare.
| Att tänka på | Tjänstens huvudnamn | Huvudanvändare |
|---|---|---|
| Mekanism | Azure AD-appens objekt för tjänstens huvudnamn gör att Azure AD kan autentisera din inbäddade app mot Power BI. | Din Azure AD-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 autentiseringsmetoden för Azure AD. Om du använder ett tjänsthuvudnamn kan du autentisera med hjälp av en programhemlighet eller ett certifikat.Den här självstudien använder tjänstens huvudnamn med en programhemlighet. Om du vill bädda in ett tjänsthuvudnamn och ett certifikat kan du läsa artikeln om tjänstens huvudnamn med ett certifikat. | Den här autentiseringsmetoden anses inte vara lika säker som att använda ett tjänsthuvudnamn. Detta beror på att du måste vara försiktig med hur du hanterar huvudanvändarens autentiseringsuppgifter (användarnamn och lösenord). Du får till exempel inte visa dem i ditt inbäddningsprogram och du bör ändra lösenordet ofta. |
| Azure AD – delegerade behörigheter | Krävs inte. | Huvudanvändaren eller en administratör måste godkänna appen innan den kan komma åt REST-API-behörigheter för Power BI (kallas även omfång). Till exempel Report.ReadWrite.All. |
| Åtkomst till Power BI-tjänsten | Du kan inte komma åt Power BI-tjänsten med tjänstens huvudnamn. | Du kan komma åt Power BI-tjänsten med autentiseringsuppgifterna för huvudanvändaren. |
| Licens | Kräver ingen Pro-licens. Du kan använda innehåll från alla arbetsytor som du är medlem i eller administratör för. | Kräver en Power BI Pro eller Premium licens per användare (PPU). |
Steg 2 – Registrera ett Azure AD-program
Genom att registrera ditt program med Azure AD kan du:
- Upprätta en identitet för din app
- Låta appen komma åt REST-API:er för Power BI
- Om du använder en huvudanvändare anger du din apps Power BI REST-behörigheter
Registrera ditt program med Azure AD genom att följa anvisningarna i Registrera ditt program.
Anteckning
Innan du registrerar ditt program måste du välja vilken autentiseringsmetod du vill använda: tjänstens huvudnamn eller huvudanvändare.
Steg 3 – Skapa en Power BI-arbetsyta
Power BI förvarar dina rapporter, instrumentpaneler och paneler på en arbetsyta. Om du vill bädda in dessa objekt måste du skapa dem och överföra dem till en arbetsyta.
Tips
Om du redan har en arbetsyta kan du hoppa över det här steget.
Så här skapar du en arbetsyta:
Logga in i Power BI.
Välj Arbetsytor.
Välj Skapa en arbetsyta.
Namnge arbetsytan 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. Du kan också ladda upp en exempelrapport till din arbetsyta.
Tips
Om du redan har en arbetsyta med en rapport kan du hoppa över det här steget.
Följ dessa steg om du vill hämta en exempelrapport och publicera den på din arbetsyta:
Öppna GitHub-mappen med Power BI Desktop-exempel.
Välj Code (Kod) och välj sedan Download zip (Ladda ned ZIP-fil).
Extrahera den nedladdade ZIP-filen och gå till mappen Samples Reports (Exempelrapporter).
Välj en rapport som du vill bädda in och publicera den på arbetsytan.
Steg 5 – Hämta parametervärdena för inbäddningen
För att kunna bädda in ditt innehåll måste du hämta vissa parametervärden. Tabellen nedan visar de obligatoriska värdena och anger om de är tillämpliga för autentiseringsmetoden för tjänstens huvudnamn, autentiseringsmetoden för huvudanvändare eller båda.
Innan du bäddar in ditt innehåll ser du till att du har alla värden som anges nedan. Vissa av värdena varierar beroende på vilken autentiseringsmetod du använder.
| Parameter | Tjänstens huvudnamn | Huvudanvändare |
|---|---|---|
| Klient-ID |  |
|
| Arbetsyte-ID | |
|
| Rapport-ID | |
|
| Klienthemlighet | |
 |
| Klientorganisations-ID | |
|
| Power BI-användarnamn | |
|
| Power BI-lösenord | |
|
Klient-ID
Tips
Gäller för: Tjänstens huvudnamn Huvudanvändare
Följ dessa steg för att hämta klient-ID:t (GUID) (även kallat program-ID):
Logga in på Microsoft Azure.
Sök efter Appregistreringar och välj länken Appregistreringar.
Välj den Azure AD-app som du använder för att bädda in ditt Power BI-innehåll.
I avsnittet Översikt kopierar du program-ID (klient) (GUID).
Arbetsyte-ID
Tips
Gäller för: Tjänstens huvudnamn Huvudanvändare
Följ dessa steg om du vill hämta arbetsyte-ID:t (GUID):
Logga in på Power BI-tjänsten.
Öppna den rapport som du vill bädda in.
Kopiera GUID från URL:en. GUID är numret mellan /groups/ och /reports/ .
Rapport-ID
Tips
Gäller för: Tjänstens huvudnamn Huvudanvändare
Hämta rapport-ID:ts GUID genom att följa dessa steg:
Logga in på Power BI-tjänsten.
Öppna den rapport som du vill bädda in.
Kopiera GUID från URL:en. GUID är numret mellan /reports/ och /ReportSection.
Klienthemlighet
Tips
Gäller för: Tjänstens huvudnamn Huvudanvändare
Så här hämtar du klienthemligheten:
Logga in på Microsoft Azure.
Sök efter Appregistreringar och välj länken Appregistreringar.
Välj den Azure AD-app som du använder för att bädda in ditt Power BI-innehåll.
Välj Certifikat och hemligheter under Hantera.
Välj Ny klienthemlighet under Klienthemligheter.
I popup-fönstret Lägg till en klienthemlighet anger du en beskrivning för programhemligheten och väljer hur länge programhemligheten ska gälla. Välj sedan Lägg till.
I avsnittet Klienthemligheter kopierar du strängen i kolumnen Värde för den nyligen skapade programhemligheten. Värdet för klienthemligheten är ditt klient-ID.
Anteckning
Se till att du kopierar värdet för klienthemligheten när det visas första gången. 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
Tips
Gäller för: Tjänstens huvudnamn Huvudanvändare
Så här hämtar du klientorganisations-ID:t (GUID):
Logga in på Microsoft Azure.
Sök efter Appregistreringar och välj länken Appregistreringar.
Välj den Azure AD-app som du använder för att bädda Power BI innehåll.
I avsnittet Översikt kopierar du Katalog-ID (klientorganisation) (GUID).
Användarnamn och lösenord för Power BI
Tips
Gäller för: Tjänstens huvudnamn Huvudanvändare
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 i Power BI-tjänsten för att skapa en arbetsyta och överföra en rapport till.
Steg 6 – API-åtkomst för tjänstens huvudnamn
Tips
Gäller för: Tjänstens huvudnamn Huvudanvändare
Det här steget är bara relevant om du använder autentiseringsmetoden tjänstens huvudnamn. Om du använder huvudanvändare hoppar du över det här steget och fortsätter med Steg 7 – Aktivera arbetsyteåtkomst.
För att en Azure AD-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 administratörsportalen för Power BI. Om du inte är administratör för din klientorganisation ber du klientorganisationens administratör att aktivera klientorganisationsinställningarna åt dig.
I Power BI-tjänsten väljer du Inställningar > Inställningar > Administratörsportalen.
Välj Klientorganisationsinställningar och rulla sedan ned till avsnittet Inställningar för utvecklare.
Expandera Tillåt tjänstens huvudnamn att använda Power BI API:er och aktivera det här alternativet.
Anteckning
När du använder tjänstens huvudnamn är det rekommenderat att begränsa dess åtkomst till klientorganisationsinställningarna med en säkerhetsgrupp. Mer information om den här funktionen finns i följande avsnitt i artikeln om tjänstens huvudnamn:
Steg 7 – Aktivera arbetsyteåtkomst
Om du vill aktivera åtkomstartefakter för Azure AD-appen, till exempel rapporter, instrumentpaneler och datauppsättningar i Power BI-tjänsten, lägger du till tjänstens huvudnamn eller huvudanvändare som en medlem eller administratör på din arbetsyta.
Logga in på Power BI-tjänsten.
Bläddra till den arbetsyta som du vill aktivera åtkomst för och välj Åtkomst till arbetsytan på menyn Mer.
Beroende på vilken autentiseringsmetod du använder kopierar du tjänstens huvudnamn eller huvudanvändaren i fönstret Åtkomst till textrutan Ange e-postadress.
Anteckning
Om du använder tjänstens huvudnamn är namnet det namn som du gav din Azure AD-app.
Välj Lägg till.
Steg 8 – Bädda in innehåll
Med Power BI Embedded-exempelprogrammet kan du skapa en inbäddning för dina kunders Power BI-app.
Följ dessa steg om du vill ändra inbäddningen för dina kunders exempelprogram för att bädda in din Power BI-rapport.
Öppna mappen med Power BI-exempel för utvecklare.
Välj Code (Kod) och välj sedan Download zip (Ladda ned ZIP-fil).
Extrahera den nedladdade ZIP-filen och gå till mappen PowerBI-Developer-Samples-master.
Öppna någon av följande mappar beroende på vilket språk du vill använda för programmet:
- .NET Core
- .NET Framework
- Java
- Node JS
- Python
Anteckning
Inbäddning för dina kunders exempelprogram stöder endast de ramverk som anges ovan. Exempelprogrammet React endast inbäddning för din organisationslösning.
Öppna mappen Embed for your customers (Bädda in för dina kunder).
Öppna inbäddningen för kundernas exempelapp med någon av följande metoder:
Om du använder Visual Studio öppnar du filen AppOwnsData.sln.
Om du använder Visual Studio Codeöppnar du mappen AppOwnsData.
Öppna appsettings.json.
Fyll i följande parametervärden beroende på autentiseringsmetoden:
Parameter Tjänstens huvudnamn Huvudanvändare AuthenticationModeServicePrincipal MasterUser ClientIdDitt Klient-ID för Azure AD-appen Ditt Klient-ID för Azure AD-appen TenantIdDitt klientorganisations-ID för Azure AD Saknas PbiUsernameSaknas Huvudanvändarens användarnamn, se Användarnamn och lösenord för Power BI PbiPasswordSaknas Huvudanvändarens lösenord, se Användarnamn och lösenord för Power BI ClientSecretDin klienthemlighet för Azure AD Saknas WorkspaceIdID:t för arbetsytan med din inbäddade rapport, se Arbetsyte-ID ID:t för arbetsytan med din inbäddade rapport, se Arbetsyte-ID ReportIdID:t för rapporten som du bäddar in, se Rapport-ID ID:t för rapporten som du bäddar in, se Rapport-ID 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 exempelprogrammet embed for your customers (bädda in för dina kunder) kan du börja utveckla ditt eget program.
När du är klar kan du se kraven för att flytta till produktion. Du behöver också en kapacitet och bör läsaartikeln om kapacitetsplanering för att fastställa vilken SKU som bäst passar dina behov.