Selvstudium: Integrer Power BI ved hjælp af en eksempelintegrer til dit organisationsprogram
Power BI giver dig mulighed for at integrere Power BI, f.eks. rapporter, dashboards og felter, i din app.
I dette selvstudium lærer du, hvordan du:
- Konfigurer dit integrerede miljø.
- Konfigurer en integrering for din organisation (også kendt som eksempelprogrammet brugeren ejer dataene).
Hvis brugerne vil bruge dit program, skal de logge på for at Power BI.
Løsningen Integrer indhold for din organisation bruges normalt af virksomheder og store organisationer og er beregnet til interne brugere.
Specifikationer for kodeeksempel
Dette selvstudium indeholder instruktioner til konfiguration af et eksempelprogram til integrering af din organisation i et af følgende frameworks:
- .NET Framework
- .NET Core
- React Skrivemaskine
Bemærk
.NET Core- og .NET Framework-eksemplerne giver slutbrugeren mulighed for at få vist alle Power BI-dashboards, rapporter eller felter, de har adgang til Power BI tjenesten. Med React TypeScript-eksemplet kan du kun integrere én rapport, som din slutbruger allerede har adgang til Power BI tjenesten.
Kodeeksemplerne understøtter følgende browsere:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
Forudsætninger
Før du starter dette selvstudium, skal du bekræfte, at du har både de Power BI- og kodeafhængigheder, der er angivet nedenfor:
Power BI-afhængigheder
Din egen Azure Active Directory-lejer.
En af følgende licenser:
Bemærk
Hvis du vil skifte til produktion, skal du bruge en af følgende konfigurationer:
Kodeafhængigheder
.NET Core 3.1 SDK (eller nyere)
Et integreret udviklingsmiljø (IDE). Vi anbefaler, at du bruger en af følgende:
Metode
Hvis du vil oprette en eksempelapp til din organisation, skal du følge disse trin:
Trin 1 – Registrer et Azure AD-program
Når du registrerer dit program i Azure AD, får du mulighed for at oprette en identitet for din app.
Hvis du vil registrere dit program i Azure AD, skal du følge vejledningen under Registrer dit program.
Trin 2 – Opret et arbejdsområde Power BI arbejdsområde
Power BI opbevarer dine rapporter, dashboards og felter i et arbejdsområde. Hvis du vil integrere disse elementer, skal du oprette dem og uploade dem til et arbejdsområde.
Tip
Hvis du allerede har et arbejdsområde, kan du springe dette trin over.
Gør følgende for at oprette et arbejdsområde:
Log på Power BI.
Vælg Arbejdsområder.
Vælg Opret et arbejdsområde.
Navngiv dit arbejdsområde, og vælg Gem.
Trin 3 – Opret og publicer en rapport Power BI rapport
Det næste trin er at oprette en rapport og uploade den til dit arbejdsområde. Du kan oprette din egen rapport ved hjælp af Power BI Desktop og derefter publicere den til dit arbejdsområde. Eller du kan uploade en eksempelrapport til dit arbejdsområde.
Tip
Hvis du allerede har et arbejdsområde med en rapport, kan du springe dette trin over.
Hvis du vil downloade en eksempelrapport og publicere den i dit arbejdsområde, skal du følge disse trin:
Åbn GitHub-mappen Power BI Desktop-eksempler.
Vælg Kode, og vælg derefter Download zip.
Udpak den downloadede ZIP, og naviger til mappen Eksempelrapporter.
Vælg en rapport, der skal integreres, og publicer den i dit arbejdsområde.
Trin 4 – Hent værdierne for integreringsparameteren
Hvis du vil integrere dit indhold, skal du hente nogle få parameterværdier. De parameterværdier, du skal bruge, afhænger af sproget i det eksempelprogram, du vil bruge. I nedenstående tabel kan du se, hvilke parameterværdier der kræves til hvert eksempel.
| Parameter | .NET Core | .NET Framework | React Skrivemaskine |
|---|---|---|---|
| Klient-id |  |
|
|
| Klienthemmelighed | |
|
 |
| Arbejdsområde-id | |
|
|
| Rapport-id | |
|
|
Klient-id
Tip
Gælder for: for. . NET Core React Skrivemaskine
Følg disse trin for at hente GUID for klient-id'et (også kaldet program-id):
Log på Microsoft Azure.
Søg efter Programregistreringer, og vælg linket Programregistreringer.
Vælg det Azure AD-program, du bruger til at integrere dit Power BI-indhold.
I afsnittet Oversigt skal du kopiere GUID for program-id'et (klient) .
Klienthemmelighed
Tip
Gælder for: for. . NET Core React Skrivemaskine
Følg disse trin for at hente klienthemmeligheden:
Log på Microsoft Azure.
Søg efter Programregistreringer, og vælg linket Programregistreringer.
Vælg det Azure AD-program, du bruger til at integrere dit Power BI-indhold.
Under Administrer skal du vælge Certifikater og hemmeligheder.
Under Klienthemmeligheder skal du vælge Ny klienthemmelighed.
I pop op-vinduet Tilføj en klienthemmelighed skal du angive en beskrivelse af din programhemmelighed, vælge, hvornår programhemmeligheden udløber, og vælge Tilføj.
I afsnittet Klienthemmeligheder skal du kopiere strengen i kolonnen Værdi i den nyoprettede programhemmelighed. Værdien for klienthemmeligheden er dit klient-id.
Bemærk
Sørg for, at du kopierer den hemmelige kundeværdi, når den vises første gang. Når du har navigeret væk fra denne side, skjules klient hemmeligheden, og du kan ikke hente dens værdi.
Id for arbejdsområde
Tip
Gælder for: . NET Core React Skrivemaskine
Følg disse trin for at hente GUID for arbejdsområde-id'et:
Log på Power BI-tjenesten.
Åbn den rapport, du vil integrere.
Kopiér GUID'et fra URL-adressen. GUID'et er tallet mellem /groups/ og /reports/ .
Rapport-id
Tip
Gælder for: . NET Core ReactTypeScript
Hvis du vil hente GUID for rapport-id'et, skal du følge disse trin:
Log på Power BI-tjenesten.
Åbn den rapport, du vil integrere.
Kopiér GUID'et fra URL-adressen. GUID'et er tallet mellem /reports/ og /ReportSection.
Trin 5 – Integrer dit indhold
Med Power BI eksempelprogram kan du oprette en integrering til din Power BI app.
Følg disse trin for at ændre integreringsprogrammet for din organisations eksempelprogram for at integrere Power BI rapport.
Åbn mappen Power BI-udviklereksempler.
Vælg Kode, og vælg derefter Download zip.
Udpak den downloadede ZIP, og naviger til mappen PowerBI-Developer-Samples-master.
Afhængigt af det sprog du vil have, at dit program skal bruge, skal du åbne en af disse mapper:
- .NET Core
- .NET Framework
- React-TS
Bemærk
Eksempelprogrammer til integrering for din organisation understøtter kun de frameworks, der er angivet ovenfor. Java-, Node JS- og Python-eksempelprogrammer understøtter kun løsningen til integrering for dine kunder.
Konfigurer din Azure AD-app
Log på Azure-portalen.
Vælg Programregistreringer. Hvis du ikke kan se denne indstilling, skal du søge efter den.
Åbn det Azure AD-program, du oprettede i trin 1 – Registrer et Azure ad-program.
Vælg godkendelse i menuen Administrer .
Åbn webplatformen i Konfigurationer af platform, og tilføj i afsnittet Omdirigerings-URI'er.
https://localhost:5000/signin-oidcBemærk
Hvis du ikke har en webplatform, skal du vælge Tilføj en platform, og i vinduet Konfigurer platforme skal du vælge Web.
Gem dine ændringer.
Konfigurer eksempelintegreringsappen
Åbn mappen Integrer for din organisation.
Åbn eksempelappen Embed for your organization ved hjælp af en af disse metoder:
Hvis du bruger et Visual Studio, skal du åbne filen UserOwnsData.sln.
Hvis du bruger en Visual Studio kode,skal du åbne mappen Bruger ejer data.
Åbn appsettings.json, og udfyld følgende parameterværdier:
ClientId– Brug klient-id'et GUIDClientSecret– Brug klienthemmelighed
Kør eksempelappen
Kør projektet ved at vælge den relevante indstilling:
Hvis du bruger Visual Studio, skal du vælge IIS Express (afspil).
Hvis du bruger Visual Studio Code, skal du vælge Kør > Start fejlfinding.
Log på programmet til integrering af eksempler.
Bemærk
Når du logger på første gang, bliver du bedt om at tillade Azure AD-tilladelser til appen.
når prøveprogrammet til integrering indlæses, skal du vælge det Power BI indhold, du vil integrere, og derefter vælge integrer.
Udvikling af dit program
Når du har konfigureret og kørt eksempelprogrammet til integrering for dine kunder, kan du begynde at udvikle dit program.