Selvstudium: Integrer Power BI-indhold ved hjælp af et eksempel på integrering for dit organisationsprogram

Med en integreret Power BI-analyse kan du integrere Power BI-indhold, f.eks. 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 din organisation (også kaldet brugeren ejer data).

Hvis du vil bruge dit program, skal brugerne logge på Power BI.

Løsningen Integrer for din organisation bruges typisk af virksomheder og store organisationer og er beregnet til interne brugere.

Vigtigt

Hvis du integrerer indhold til en national/regional cloud, er de første trin i dette selvstudium forskellige. Se Integrer indhold for nationale/regionale cloudmiljøer for at få flere oplysninger.

Specifikationer for kodeeksempel

Dette selvstudium indeholder instruktioner til konfiguration af et eksempelprogram til integrering for din organisation i en af følgende strukturer:

• .NET Framework
• .NET Core
• React TypeScript

Bemærk

Eksemplerne .NET Core og Microsoft .NET Framework gør det muligt for slutbrugeren at få vist alle Power BI-dashboards, -rapporter eller -felter, de har adgang til i Power BI-tjeneste. Med React TypeScript-eksemplet kan du kun integrere én rapport, som slutbrugeren allerede har adgang til i Power BI-tjeneste.

Kodeeksempler understøtter følgende browsere:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Forudsætninger

Før du starter dette selvstudium, skal du kontrollere, at du både har følgende Power BI- og kodeafhængigheder:

• Power BI-afhængigheder

  • Din egen Microsoft Entra-lejer.

    • En af følgende licenser:

      • Power BI Pro

      • Premium pr. bruger

    Bemærk

    Hvis du vil flytte til produktion , skal du bruge en af følgende konfigurationer:

    • Alle brugere med Pro-licenser.
    • Alle brugere med Premium pr. bruger-licenser.
    • En SKU, der svarer til eller højere end en F64 SKU. Denne konfiguration gør det muligt for alle brugere at have gratis licenser.

• Kodeafhængigheder

  .NET Core

  • .NET Core 3.1 SDK (eller nyere)

  • Et integreret udviklingsmiljø (IDE). Vi anbefaler, at du bruger en af følgende IDE'er:

    • Visual Studio

    • Visual Studio-kode

  Microsoft .NET Framework

  • Microsoft .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • En teksteditor

  • Kommandolinjeterminal (eller PowerShell)

---

Metode

Hvis du vil oprette en eksempelapp til integrering for din organisation , skal du følge disse trin:

1. Registrer et Microsoft Entra-program.

2. Opret et Power BI-arbejdsområde.

3. Opret og publicer en Power BI-rapport.

4. Hent integreringsparameterværdierne.

5. Integrer dit indhold.

Trin 1 – Registrer et Microsoft Entra-program

Hvis du registrerer dit program med Microsoft Entra ID, kan du oprette en identitet for din app.

Hvis du vil registrere dit program med Microsoft Entra ID, skal du følge vejledningen i Registrer dit program.

Trin 2 – Opret et Power BI-arbejdsområde

Power BI bevarer 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.

Benyt følgende fremgangsmåde for at oprette et arbejdsområde:

1. Log på Power BI.

2. Vælg Arbejdsområder.

3. Vælg Opret et arbejdsområde.

4. Navngiv dit arbejdsområde, og vælg Gem.

Trin 3 – Opret og publicer en Power BI-rapport

Dit 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 i dit arbejdsområde. Du kan også uploade en eksempelrapport til dit arbejdsområde.

Tip

Hvis du allerede har et arbejdsområde med en rapport, kan du springe dette trin over.

Følg disse trin for at downloade en eksempelrapport og publicere den i dit arbejdsområde:

1. Åbn mappen GitHub Power BI Desktop-eksempler .

2. Vælg Kode, og vælg derefter Download zip.

   

3. Udpak den downloadede ZIP, og naviger til mappen Eksempler på rapporter .

4. Vælg en rapport, der skal integreres, og publicer den i dit arbejdsområde.

Trin 4 – Hent parameterværdierne for integrering

Hvis du vil integrere dit indhold, skal du hente et par parameterværdier. Parameterværdierne afhænger af sproget i det eksempelprogram, du vil bruge. I nedenstående tabel kan du se, hvilke parameterværdier der kræves for hvert eksempel.

Parameter	.NET Core	.NET Framework	React TypeScript
Klient-id
Klienthemmelighed
Arbejdsområde-id
Rapport-id

Client ID

Tip

Gælder for: .NET Core Microsoft .NET Framework React TypeScript

Hvis du vil hente guid'et for klient-id'et (også kaldet program-id), skal du følge disse trin:

1. Log på Microsoft Azure.

2. Søg efter Appregistreringer, og vælg linket Appregistreringer .

3. Vælg den Microsoft Entra-app, du bruger til at integrere dit Power BI-indhold.

4. Kopiér GUID'et for program-id'et (klient) i afsnittet Oversigt.

Klienthemmelighed

Tip

Gælder for: .NET Core Microsoft .NET Framework React TypeScript

Følg disse trin for at hente klienthemmeligheden:

1. Log på Microsoft Azure.

2. Søg efter Appregistreringer, og vælg linket Appregistreringer .

3. Vælg den Microsoft Entra-app, du bruger til at integrere dit Power BI-indhold.

4. Under Administrer skal du vælge Certifikater & hemmeligheder.

5. Under Klienthemmeligheder skal du vælge Ny klienthemmelighed.

6. I pop op-vinduet Tilføj en klienthemmelighed skal du angive en beskrivelse af programhemmeligheden, vælge, hvornår programhemmeligheden udløber, og vælge Tilføj.

7. I afsnittet Klienthemmeligheder skal du kopiere strengen i kolonnen Value for den nyoprettede programhemmelighed. Værdien for klienthemmeligheden er dit klient-id.

Bemærk

Sørg for at kopiere værdien for klienthemmeligheden, første gang den vises. Når du har navigeret væk fra denne side, skjules klienthemmeligheden, og du kan ikke hente dens værdi.

Id for arbejdsområde

Tip

Gælder for: .NET Core Microsoft .NET Framework React TypeScript

Følg disse trin for at hente GUID'et for arbejdsområdets id:

1. Log på Power BI-tjenesten.

2. Åbn den rapport, du vil integrere.

3. Kopiér GUID'et fra URL-adressen. GUID'et er tallet mellem /groups/ og /reports/.

   

Rapport-id

Tip

Gælder for: .NET Core Microsoft .NET Framework ReactTypeScript

Følg disse trin for at hente GUID'et for rapport-id'et:

1. Log på Power BI-tjenesten.

2. Åbn den rapport, du vil integrere.

3. Kopiér GUID'et fra URL-adressen. GUID'et er tallet mellem /reports/ og /ReportSection.

   

Trin 5 – Integrer dit indhold

Med det integrerede Power BI-eksempelprogram kan du oprette en Power BI-app til integrering i din organisation .

Følg disse trin for at ændre eksempelappen Integrer for din organisation for at integrere din Power BI-rapport.

1. Åbn mappen Power BI-udviklereksempler .

2. Vælg Kode, og vælg derefter Download zip.

   

3. Udpak den downloadede ZIP, og naviger til mappen PowerBI-Developer-Samples-master .

4. Åbn en af følgende mapper, afhængigt af det sprog dit program skal bruge:

   • .NET Core
   • .NET Framework
   • React-TS

   Bemærk

   Eksempelprogrammerne til integrering for din organisation understøtter kun de tidligere angivne strukturer. Java-, Node JS- og Python-eksempelprogrammerne understøtter kun løsningen integrer for dine kunder.

.NET Core

Konfigurer din Microsoft Entra-app

1. Log på Azure-portalen.

2. Vælg Appregistreringer. Hvis du ikke kan se denne indstilling, skal du søge efter den.

3. Åbn det Microsoft Entra-program, du oprettede i trin 1 – Registrer et Microsoft Entra-program.

4. Vælg Godkendelse i menuen Administrer.

5. Åbn webplatformeni Platformkonfigurationer, og tilføj https://localhost:5000/signin-oidci afsnittet Omdirigerings-URI'er.

   Bemæ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.

6. Gem dine ændringer.

Konfigurer eksempelappen til integrering

1. Åbn mappen Integrer for din organisation .

2. Åbn eksempelappen Integrer for din organisation ved hjælp af en af disse metoder:

   • Hvis du bruger Visual Studio, skal du åbne filen UserOwnsData.sln .

   • Hvis du bruger Visual Studio Code, skal du åbne mappen UserOwnsData .

3. Åbn appsettings.json , og udfyld følgende parameterværdier:

   • ClientId– Brug klient-id-GUID'et

   • ClientSecret - Brug klienthemmeligheden

Kør eksempelappen

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

2. Log på eksempelprogrammet til integrering.

   Bemærk

   Under dit første logon bliver du bedt om at tillade Microsoft Entra-tilladelser til appen.

3. Når eksempelprogrammet til integrering indlæses, skal du vælge det Power BI-indhold, du vil integrere, og derefter vælge Integrer.

   

Microsoft .NET Framework

Konfigurer din Microsoft Entra-app

1. Log på Azure-portalen.

2. Vælg Appregistreringer. Hvis du ikke kan se denne indstilling, skal du søge efter den.

3. Åbn det Microsoft Entra-program, du oprettede i trin 1 – Registrer et Microsoft Entra-program.

4. Vælg Godkendelse i menuen Administrer.

5. Konfigurer følgende indstillinger i Platformkonfigurationer:

   1. På din webplatform skal du i afsnittet Omdirigerings-URI'er tilføje https://localhost:44300/.

      Bemæ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.

   2. Aktivér indstillingen ID-tokens i implicitte tildelings- og hybridflows.

6. Gem dine ændringer.

Konfigurer eksempelappen til integrering

1. Åbn mappen Integrer for din organisation .

2. Åbn filen UserOwnsData.sln ved hjælp af Visual Studio.

3. Åbn Web.config, og udfyld følgende parameterværdier:

   • clientId– Brug klient-id-GUID'et

   • clientSecret - Brug klienthemmeligheden

Kør eksempelappen

1. Kør projektet ved at vælge IIS Express (afspil).

2. Log på eksempelprogrammet til integrering.

   Bemærk

   Under dit første logon bliver du bedt om at tillade Microsoft Entra-tilladelser til appen.

3. Når eksempelprogrammet til integrering indlæses, skal du vælge det Power BI-indhold, du vil integrere, og derefter vælge Integrer.

   

React TypeScript

Konfigurer din Microsoft Entra-app

1. Log på Azure-portalen.

2. Vælg Appregistreringer. Hvis du ikke kan se denne indstilling, skal du søge efter den.

3. Åbn det Microsoft Entra-program, du oprettede i trin 1 – Registrer et Microsoft Entra-program.

4. Vælg Godkendelse i menuen Administrer.

5. Konfigurer webplatformen på følgende måde i Platformkonfigurationer:

   1. I Omdirigerings-URI'er skal du tilføje https://localhost:3000 og vælge Konfigurer.

      Bemærk

      Hvis du ikke har en webplatform, skal du vælge Tilføj en platform og vælge Web i vinduet Konfigurer platforme.

   2. Aktivér begge muligheder i Implicit tildeling og hybridflow:

      • Adgangstokens
      • Id-tokens

6. Gem dine ændringer.

Konfigurer eksempelappen til integrering

1. Åbn mappen Integrer for din organisation>UserOwnsData>src.

2. Åbn filen Config.ts ved hjælp af en teksteditor, og udfyld følgende parameterværdier:

   • clientId– Brug klient-id-GUID'et

   • workspaceId– Brug arbejdsområde-id'et

   • reportId – Brug rapport-id'et

3. Gem filen.

Kør eksempelappen

1. Åbn en terminal, og naviger til Integrer for din organisation>UserOwnsData.

2. Installér de påkrævede afhængigheder ved at angive følgende kommando:

   npm install

3. Kør programmet ved at angive følgende kommando:

   npm run start

   Bemærk

   Under dit første logon bliver du bedt om at tillade Microsoft Entra-tilladelser til appen.

Udvikl dit program

Når du har konfigureret og kørt eksempelprogrammet Integrer for dine kunder , kan du begynde at udvikle dit eget program.

Opdater brugertilladelser

Brugerne skal have tilladelse til at få adgang til den Power BI-mappe, som rapporten er i. Når du giver en bruger tilladelse til at få adgang til en mappe, træder ændringen normalt først i kraft, når brugeren logger på Power BI-portalen. Hvis de nye tilladelser skal træde i kraft med det samme, skal du i scenariet Integreret foretage et eksplicit kald til REST API'en RefreshUser Permissions ved start. Dette API-kald opdaterer tilladelserne og undgår godkendelsesfejl for brugere med nyligt tildelte tilladelser.

Relateret indhold

Selvstudium: Integrer Power BI-indhold ved hjælp af et eksempel på integrering for dine kunders program

Integrer sideinddelte rapporter

Spørg Power BI-community'et