Självstudie: Bädda Power BI innehåll med hjälp av en exempelinbäddning för ditt organisationsprogram
Power BI inbäddad analys kan du bädda 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 din organisation (även kallat användaren äger data) exempelprogram.
För att kunna använda ditt program måste användarna logga in på Power BI.
Lösningen Embed for your organization (Bädda in för din organisation) används vanligtvis av företag och stora organisationer och är avsedd för interna användare.
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 Maskin
Anteckning
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 Power BI tjänsten.
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
En av följande licenser:
Anteckning
Om du vill flytta till produktion behöver du någon av följande konfigurationer:
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 din organisations exempelapp:
Steg 1 – Registrera ett Azure AD-program
Genom att registrera ditt program med Azure AD kan du upprätta en identitet för din app.
Registrera ditt program med Azure AD genom att följa anvisningarna i Registrera ditt program.
Steg 2 – 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 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. 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 4 – Hämta inbäddningsparametervärdena
Om du vill bädda in ditt innehåll måste du hämta några parametervärden. Vilka parametervärden du behöver beror på språket i exempelprogrammet som du vill använda. Tabellen nedan visar vilka parametervärden som krävs för varje exempel.
| Parameter | .NET Core | .NET Framework | React Maskin |
|---|---|---|---|
| Klient-ID | ![]() |
![]() |
![]() |
| Klienthemlighet | ![]() |
![]() |
![]() |
| Arbetsyte-ID | ![]() |
![]() |
![]() |
| Rapport-ID | ![]() |
![]() |
![]() |
Klient-ID
Tips
Gäller för:
för. . NET Core
React Maskin
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).
Klienthemlighet
Tips
Gäller för:
för. . NET Core
React Maskin
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.
Arbetsyte-ID
Tips
Gäller för:
för. . NET Core
React Maskin
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:
för. . NET Core
ReactTypeScript
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.
Steg 5: Bädda in innehåll
Med Power BI inbäddat exempelprogram kan du skapa en inbäddning för din Power BI app.
Följ de här stegen för att ändra inbäddning för din organisations exempelprogram för att bädda Power BI rapporten.
Ö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
- React-TS
Anteckning
Inbäddning för din organisations exempelprogram stöder endast de ramverk som anges ovan. Java, Node JS och Python-exempelprogrammen har endast stöd för inbäddning för dina kunder.
Konfigurera din Azure AD-app
Logga in på Azure-portalen.
Välj Appregistreringar. Om du inte ser det här alternativet söker du efter det.
Öppna Azure AD-programmet som du skapade i steg 1 – Registrera ett Azure AD-program.
Välj Autentisering på menyn Hantera.
I Plattformskonfigurationer öppnar du webbplattformen och i avsnittet Omdirigerings-URI:er lägger du till
https://localhost:5000/signin-oidc.Anteckning
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.
Spara ändringarna.
Konfigurera exempelinbäddningsappen
Öppna mappen Bädda in för din organisation.
Öppna inbäddning 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.
Öppna appsettings.json och fyll i följande parametervärden:
ClientId– Använd klient-ID:ts GUIDClientSecret– Använda klienthemligheten
Kör exempelappen
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.
Logga in på exempelprogrammet för inbäddning.
Anteckning
Under din första inloggning uppmanas du att tillåta Azure AD-behörigheter för appen.
När exempelprogrammet för inbäddning läses in väljer du Power BI innehåll som du vill bädda in och väljer sedan Bädda in.
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.