Selvstudium: Integrer Power BI-indhold ved hjælp af et eksempelprogram til integrering for dine kunder
Med integreret analyse og Power BI Embedded (Azure-tilbuddet) kan du integrere Power BI-indhold såsom rapporter, dashboards og felter i dit program.
I dette selvstudium lærer du, hvordan du:
- Konfigurer dit integrerede miljø.
- Konfigurer et eksempelprogram til integrering for dine kunder (også kendt som programmet ejer data).
Brugerne behøver ikke at logge på Power BI eller have en Power BI-licens for at bruge dit program.
Vi anbefaler, at du bruger metoden til integrering for dine kunder til at integrere dit Power BI-indhold, hvis du er en uafhængig softwareproducent eller en udvikler, der gerne vil oprette programmer til tredjeparter.
Specifikationer for kodeeksempel
Dette selvstudium indeholder instruktioner til konfiguration af et eksempelprogram til dine kunder i et af følgende frameworks:
- .NET Framework
- .NET Core
- Java
- Node JS
- Python
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.
Du skal have en af følgende for at godkende dit program i Power BI:
Tjenesteprincipal – Et objekt for en Azure Active Directory-tjenesteprincipal (Azure AD), der giver Azure AD mulighed for at godkende dit program.
Power BI Pro-licens – Dette vil være din masterbruger, og dit program bruger den til at godkende i Power BI.
En Premium Per User-licens (PPU) til Power BI – Dette vil være din masterbruger, og dit program bruger den til at godkende i Power BI.
Bemærk
Hvis du vil flytte til produktion, skal du bruge en kapacitet.
Kodeafhængigheder
.NET Core 3.1 SDK (eller nyere)
Et integreret udviklingsmiljø (IDE). Vi anbefaler, at du bruger en af følgende:
Metode
Følg disse trin for at oprette et eksempelprogram til integrering for din kunder:
Trin 1 – Vælg en godkendelsesmetode
Din integrerede løsning varierer, afhængigt af den valgte godkendelsesmetode. Det er derfor vigtigt at forstå forskellene mellem godkendelsesmetoderne og beslutte, hvilken metode der passer bedst til din løsning.
I nedenstående tabel beskrives nogle få vigtige forskelle mellem godkendelsesmetoderne tjenesteprincipal og masterbruger.
| Overvejelse | Tjenesteprincipal | Masterbruger |
|---|---|---|
| Mekanisme | Objektet for din tjenesteprincipal for dit Azure AD-program giver Azure AD mulighed for at godkende dit integrerede løsningsprogram i Power BI. | Azure AD-programmet bruger legitimationsoplysningerne (brugernavn og adgangskode) for en Power BI-bruger til at godkende i Power BI. |
| Sikkerhed | Tjenesteprincipal er den anbefalede godkendelsesmetode for Azure AD. Hvis du bruger en tjenesteprincipal*, kan du godkende ved hjælp af enten en programhemmelighed eller et certifikat.Dette selvstudium indeholder kun en beskrivelse af brug af en tjenesteprincipal med en programhemmelighed. Hvis du vil integrere ved hjælp af en tjenesteprincipal og et certifikat, skal du se artiklen om tjenesteprincipal med et certifikat. | Denne godkendelsesmetode anses ikke for at være lige så sikker som brug af en tjenesteprincipal. Det skyldes, at du skal være påpasselig med legitimationsoplysningerne for masterbrugeren (brugernavn og adgangskode). Du må f.eks. ikke fremvise dem i dit integreringsprogram, og du bør ændre adgangskoden ofte. |
| Delegerede tilladelser i Azure AD | Ikke påkrævet. | Din masterbruger eller en administrator skal give deres samtykke til, at dit program kan få adgang til REST API-tilladelser til Power BI (også kendt som områder). For eksempel Report.ReadWrite.All. |
| Adgang til Power BI-tjenesten | Du kan ikke få adgang til Power BI-tjenesten med en tjenesteprincipal. | Du kan få adgang til Power BI-tjenesten med legitimationsoplysningerne for din masterbruger. |
| Licens | Kræver ikke en Pro-licens. Du kan bruge indhold fra alle arbejdsområder, som du er medlem eller administrator af. | Kræver en Power BI Pro eller Premium PPU (Per User). |
Trin 2 – Registrer et Azure AD-program
Når du registrerer dit program med Azure AD, kan du:
- Etablere en identitet for dit program
- Give dit program adgang til REST API'erne til Power BI
- Angive REST-tilladelser til Power BI for programmet – hvis du bruger en masterbruger
Hvis du vil registrere dit program i Azure AD, skal du følge vejledningen under Registrer dit program.
Bemærk
Før du registrerer dit program, skal du beslutte, hvilken godkendelsesmetode du vil bruge, tjenesteprincipal eller masterbruger.
Trin 3 – Opret et 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 4 – Opret og publicer en 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 5 – Hent de integrerede parameterværdier
Hvis du vil integrere dit indhold, skal du hente bestemte parameterværdier. I nedenstående tabel vises de påkrævede værdier og angiver, om de gælder for godkendelsesmetoden for tjeneste principalen, den overordnede brugergodkendelsesmetode eller begge dele.
Før du integrerer dit indhold, skal du sørge for, at du har alle de værdier, der er angivet nedenfor. Nogle af værdierne vil variere, afhængigt af den valgte godkendelsesmetode.
| Parameter | Tjenesteprincipal | Masterbruger |
|---|---|---|
| Klient-id |  |
|
| Arbejdsområde-id | |
|
| Rapport-id | |
|
| Klienthemmelighed | |
 |
| Lejer-id | |
|
| Power BI-brugernavn | |
|
| Power BI-adgangskode | |
|
Klient-id
Tip
Gælder for: Tjenesteprincipal Masterbruger
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) .
Id for arbejdsområde
Tip
Gælder for: Tjenesteprincipal Masterbruger
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: Tjenesteprincipal Masterbruger
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.
Klienthemmelighed
Tip
Gælder for: Tjenesteprincipal Masterbruger
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.
Lejer-id
Tip
Gælder for: Tjenesteprincipal Masterbruger
Følg disse trin for at hente GUID for lejer-id'et:
Log på Microsoft Azure.
Søg efter Programregistreringer, og vælg linket Programregistreringer.
Vælg den Azure AD-app, du bruger til at integrere dit Power BI indhold.
I afsnittet Oversigt skal du kopiere GUID for mappe-id'et (lejer) .
Brugernavn og adgangskode til Power BI
Tip
Gælder for: Tjenesteprincipal Masterbruger
Hent brugernavnet og adgangskoden for den Power BI-bruger, du bruger som masterbruger. Det er den samme bruger, som du brugte til at oprette et arbejdsområde og uploade en rapport til, i Power BI-tjenesten.
Trin 6 – API-adgang til tjenesteprincipal
Tip
Gælder for: Tjenesteprincipal Masterbruger
Dette trin er kun relevant, hvis du bruger godkendelsesmetoden tjenesteprincipal. Hvis du bruger en masterbruger, kan du springe dette trin over og fortsætte med Trin 7 – Giv adgang til arbejdsområdet.
Hvis et Microsoft Azure AD-program skal kunne få adgang til Power BI-indholdet og API'erne, skal en Power BI-administrator have mulighed for at aktivere adgangen til tjenesteprincipalen i Power BI-administrationsportalen. Hvis du ikke er administrator af din lejer, kan du få lejerens administrator til at aktivere Lejerindstillingerne for dig.
I Power BI-tjenesten skal du vælge Indstillinger > Indstillinger > Administrationsportal.
Vælg Lejerindstillinger, og rul derefter ned til afsnittet Udviklerindstillinger.
Udvid Giv tjenesteprincipaler tilladelse til at bruge API'er til Power BI, og aktivér denne indstilling.
Bemærk
Når du bruger en tjenesteprincipal, anbefales det at begrænse adgangen til lejerindstillingerne ved hjælp af en sikkerhedsgruppe. Du kan få mere at vide om denne funktion ved at se disse afsnit i artiklen Tjenesteprincipal:
Trin 7 – Giv adgang til arbejdsområde
Hvis du vil aktivere artefakterne for adgang til dit Azure AD-program, f.eks. rapporter, dashboards og datasæt i Power BI-tjenesten, skal du tilføje tjenesteprincipalen eller masterbrugeren som et medlem eller administrator til dit arbejdsområde.
Log på Power BI-tjenesten.
Rul til det arbejdsområde, du vil aktivere adgang til, og vælg Adgang til arbejdsområde i menuen Mere.
Afhængigt af hvilken godkendelsesmetode du bruger, skal du i ruden Adgang kopiere tjenesteprincipalen eller masterbrugeren til tekstfeltet Angiv mailadresse.
Bemærk
Hvis du bruger en tjenesteprincipal, er dens navn det navn, du gav dit Azure AD-program.
Vælg Tilføj
Trin 8 – Integrer dit indhold
Det integrerede Power BI-eksempelprogram giver dig mulighed for at oprette et Power BI-program til integrering for dine kunder.
Følg disse trin for at ændre eksempelprogrammet til integrering for dine kunder, så du kan integrere din 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
- Java
- Node JS
- Python
Bemærk
Integreringen for eksempelprogrammer til dine kunder understøtter kun de frameworks, der er angivet ovenfor. Eksempelprogrammet React eksempel understøtter kun løsningen til integrering for din organisation.
Åbn mappen Integrer for dine kunder.
Åbn eksempelprogrammet til integrering for dine kunder ved hjælp af en af disse metoder:
Hvis du bruger Visual Studio, skal du åbne filen AppOwnsData.sln.
Hvis du bruger en Visual Studio Kode,skal du åbne mappen AppOwnsData.
Åbn appsettings.json.
Afhængigt af din godkendelsesmetode skal du udfylde følgende parameterværdier:
Parameter Tjenesteprincipal Masterbruger AuthenticationModeServicePrincipal MasterUser ClientIdKlient-id'et for dit Azure AD-program Klient-id'et for dit Azure AD-program TenantIdLejer-id'et for dit Azure AD I/T PbiUsernameI/T Brugernavnet for din masterbruger – se brugernavn og adgangskode til Power BI PbiPasswordI/T Adgangskoden for din masterbruger – se brugernavn og adgangskode til Power BI ClientSecretKlienthemmeligheden for dit Azure AD I/T WorkspaceIdId'et for arbejdsområdet med din integrerede rapport – se arbejdsområde-id Id'et for arbejdsområdet med din integrerede rapport – se arbejdsområde-id ReportIdId'et for den rapport du integrerer – se rapport-id Id'et for den rapport du integrerer – se rapport-id 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.
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.
Når du er klar, kan du gennemse kravene til flyt til produktion. Du har også brug for en kapacitet, og du bør gennemgå artiklen om kapacitetsplanlægning for at fastslå, hvilken SKU der bedst opfylder dine behov.