Opplæring: Bygge inn Power BI-innhold ved hjelp av en eksempelinnbygging for kundenes program

GJELDER FOR: Appen eier data Brukeren eier data

Med innebygd analyse og Power BI Embedded (Azure-tilbudet) kan du bygge inn Power BI-innhold, for eksempel rapporter, instrumentbord og fliser, i programmet.

I denne opplæringen lærer du hvordan du kan gjøre følgende:

  • Konfigurer det innebygde miljøet.
  • Konfigurer en innebygging for kundene (også kjent som app eier data) eksempelprogram.

Hvis du vil bruke programmet, trenger ikke brukerne å logge på Power BI eller ha en Power BI-lisens.

Vi anbefaler at du bruker innebyggingsmetoden for kundene til å bygge inn Power BI-innhold, hvis du er en uavhengig programvareleverandør (ISV) eller en utvikler, som ønsker å opprette programmer for tredjeparter.

Viktig

Hvis du bygger inn innhold for en nasjonal/regional sky, er de første trinnene i denne opplæringen forskjellige. Se Bygge inn innhold for nasjonale/regionale skyer for mer informasjon.

Kodeeksempelspesifikasjoner

Denne opplæringen inneholder instruksjoner for hvordan du konfigurerer en innebygging for kundenes eksempelprogram i ett av følgende rammeverk:

  • .NET Framework
  • .NET Core
  • Java
  • Node JS
  • Python

Kodeeksempler støtter følgende nettlesere:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Forutsetning

Før du starter denne opplæringen, må du kontrollere at du har både Power BI- og kodeavhengighetene oppført nedenfor:

  • Power BI-avhengigheter

  • Kodeavhengigheter

Metode

Følg disse trinnene for å opprette en innebygging for kundenes eksempelapp:

  1. Velg godkjenningsmetoden.

  2. Registrer et Microsoft Entra-program.

  3. Opprett et Power BI-arbeidsområde.

  4. Opprett og publiser en Power BI-rapport.

  5. Hent parameterverdiene for innebygging.

  6. API-tilgang for tjenestekontohaver

  7. Aktiver arbeidsområdetilgang.

  8. Bygg inn innholdet.

Trinn 1 – Velg godkjenningsmetode

Den innebygde løsningen varierer avhengig av godkjenningsmetoden du velger. Derfor er det viktig å forstå forskjellene mellom godkjenningsmetodene og bestemme hvilken som passer best til løsningen.

Tabellen nedenfor beskriver noen viktige forskjeller mellom tjenestekontohaveren og metodene for hovedbrukergodkjenning.

Vurdering Tjenestekontohaver Hovedbruker
Mekanisme Microsoft Entra-appens tjenestekontohaverobjekt gjør det mulig for Microsoft Entra ID å godkjenne den innebygde løsningsappen mot Power BI. Microsoft Entra-appen bruker legitimasjonen (brukernavn og passord) for en Power BI-bruker til å godkjenne mot Power BI.
Sikkerhet Tjenestekontohaver er anbefalt godkjenningsmetode for Microsoft Entra ID. Hvis du bruker en tjenestekontohaver, kan du godkjenne ved hjelp av enten en programhemmelighet eller et sertifikat.

Denne opplæringen beskriver bare bruk av tjenestekontohaver med en programhemmelighet. Hvis du vil bygge inn ved hjelp av en tjenestekontohaver og et sertifikat, kan du se tjenestekontohaveren med en sertifikatartikkel .
Denne godkjenningsmetoden er ikke like sikker som en tjenestekontohaver. Du må være årvåken med legitimasjonen for hovedbrukeren (brukernavn og passord). Du kan for eksempel ikke vise dem i innebyggingsprogrammet og endre passordet ofte.
Delegerte tillatelser for Microsoft Entra ID Ikke obligatorisk. Hovedbrukereneller en administrator må gi samtykke til at appen skal få tilgang til POWER BI REST-API-tillatelser (også kalt omfang). Eksempel: Report.ReadWrite.All.
Power Bi-tjeneste tilgang Du får ikke tilgang til Power Bi-tjeneste med en tjenestekontohaver. Du kan få tilgang til Power Bi-tjeneste med legitimasjonen for hovedbrukeren.
Lisens Krever ikke en Pro-lisens. Du kan bruke innhold fra et hvilket som helst arbeidsområde som du er medlem eller administrator av. Krever en Lisens for Power BI Pro eller Premium per bruker (PPU).

Trinn 2 – Registrer et Microsoft Entra-program

Når du registrerer programmet med Microsoft Entra ID, kan du:

Hvis du vil registrere programmet med Microsoft Entra ID, følger du instruksjonene i Registrer programmet.

Merk

Før du registrerer programmet, må du bestemme hvilken godkjenningsmetode du skal bruke, tjenestekontohaver eller hovedbruker.

Trinn 3 – Opprett et Power BI-arbeidsområde

Power BI beholder rapporter, instrumentbord og fliser i et arbeidsområde. Hvis du vil bygge inn disse elementene, må du opprette dem og laste dem opp til et arbeidsområde.

Tips

Hvis du allerede har et arbeidsområde, kan du hoppe over dette trinnet.

Gjør følgende for å opprette et arbeidsområde:

  1. Logg på Power BI.

  2. Velg arbeidsområder.

  3. Velg Opprett et arbeidsområde.

  4. Gi arbeidsområdet et navn, og velg Lagre.

Trinn 4 – Opprette og publisere en Power BI-rapport

Det neste trinnet er å opprette en rapport og laste den opp til arbeidsområdet. Du kan opprette din egen rapport ved hjelp av Power BI Desktop, og deretter publisere den til arbeidsområdet. Du kan også laste opp en eksempelrapport til arbeidsområdet.

Tips

Hvis du allerede har et arbeidsområde med en rapport, kan du hoppe over dette trinnet.

Følg disse trinnene for å laste ned en eksempelrapport og publisere den til arbeidsområdet:

  1. Åpne GitHub Power BI Desktop-eksempelmappen .

  2. Velg Kode , og velg deretter Last ned zip.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  3. Pakk ut den nedlastede ZIP-en, og gå til Eksempelrapporter-mappen .

  4. Velg en rapport som skal bygges inn, og publiser den til arbeidsområdet.

Trinn 5 – Hent parameterverdiene for innebygging

Hvis du vil bygge inn innholdet, må du hente bestemte parameterverdier. Tabellen nedenfor viser de nødvendige verdiene, og angir om de gjelder for godkjenningsmetoden for tjenestekontohaver , metoden for hovedbrukergodkjenning eller begge deler.

Før du bygger inn innholdet, må du kontrollere at du har alle verdiene oppført nedenfor. Noen av verdiene varierer avhengig av godkjenningsmetoden du bruker.

Parameter Tjenestekontohaver Hovedbruker
Klient-ID Applies to. Applies to.
Arbeidsområde-ID Applies to. Applies to.
Rapport-ID Applies to. Applies to.
Klienthemmelighet Applies to. Does not apply to.
Leier-ID Applies to. obligatorisk bare for Node JS
Power BI-brukernavn Does not apply to. Applies to.
Power BI-passord Does not apply to. Applies to.

Client ID

Tips

Gjelder for hovedbruker for tjenestekontohaverApplies to.Applies to.

Følg disse trinnene for å få GUID-en for klient-ID (også kjent som program-ID):

  1. Logg på Microsoft Azure.

  2. Søk etter appregistreringer, og velg appregistreringskoblingen.

  3. Velg Microsoft Entra-appen du bruker til å bygge inn Power BI-innholdet.

  4. Kopier GUID-en for program-ID (klient) fra oversiktsdelen.

Arbeidsområde-ID

Tips

Gjelder for hovedbruker for tjenestekontohaverApplies to.Applies to.

Følg disse trinnene for å få GUID-en for arbeidsområde-ID:

  1. Logg på Power BI-tjenesten.

  2. Åpne rapporten du vil bygge inn.

  3. Kopier GUIDen fra URL-adressen. GUID-en er tallet mellom /groups/ og /reports/.

    A screenshot showing workspace ID GUID in the Power B I service U R L

Du kan også finne arbeidsområde-ID-en i innstillingene for administrasjonsportalen ved å velge Detaljer ved siden av navnet på arbeidsområdet.

A screenshot showing how to find the workspace I D from the admin settings.

Rapport-ID

Tips

Gjelder for hovedbruker for tjenestekontohaverApplies to.Applies to.

Følg disse trinnene for å få GUID-en for rapport-ID:

  1. Logg på Power BI-tjenesten.

  2. Åpne rapporten du vil bygge inn.

  3. Kopier GUIDen fra URL-adressen. GUID-en er tallet mellom /reports/ og /ReportSection.

    A screenshot showing report ID GUID in the Power B I service U R L

Klienthemmelighet

Tips

Gjelder for hovedbruker for tjenestekontohaverApplies to.Does not apply to.

Følg disse trinnene for å få klienthemmeligheten:

  1. Logg på Microsoft Azure.

  2. Søk etter appregistreringer, og velg appregistreringskoblingen.

  3. Velg Microsoft Entra-appen du bruker til å bygge inn Power BI-innholdet.

  4. Velg Sertifikater og hemmeligheter under Administrer.

  5. Velg Ny klienthemmelighet under Klienthemmeligheter.

  6. Angi en beskrivelse for programhemmeligheten i popup-vinduet Legg til en klienthemmelighet , velg når programhemmeligheten utløper, og velg Legg til.

  7. Kopier strengen i Verdi-kolonnen for den nyopprettede programhemmeligheten fra delen Klienthemmeligheter. Klienthemmelighetsverdien er klient-ID-en din.

Merk

Kontroller at du kopierer den hemmelige klientverdien når den vises først. Når du har navigert bort fra denne siden, skjules klienthemmeligheten, og du kan ikke hente verdien.

Leier-ID

Tips

Gjelder for hovedbruker for tjenestekontohaverApplies to.Does not apply to.

Følg disse trinnene for å få GUID-en for leier-ID:

  1. Logg på Microsoft Azure.

  2. Søk etter appregistreringer, og velg appregistreringskoblingen.

  3. Velg Microsoft Entra-appen du bruker til å bygge inn Power BI-innholdet.

  4. Kopier GUID-en for Katalog (leier) ID fra Oversikt-delen.

Brukernavn og passord for Power BI

Tips

Gjelder for hovedbruker for tjenestekontohaverDoes not apply to.Applies to.

Få brukernavnet og passordet til Power BI-brukeren du bruker som hovedbruker. Dette er den samme brukeren du brukte til å opprette et arbeidsområde og laste opp en rapport til, i Power Bi-tjeneste.

Trinn 6 – API-tilgang for tjenestekontohaver

Tips

Gjelder for hovedbruker for tjenestekontohaverApplies to.Does not apply to.

Dette trinnet er bare relevant hvis du bruker godkjenningsmetoden tjenestekontohaver . Hvis du bruker en hovedbruker, hopper du over dette trinnet og fortsetter med trinn 7 – Aktiver tilgang til arbeidsområdet.

For at en Microsoft Entra-app skal kunne få tilgang til Power BI-innhold og API-er, må en Power BI-administrator aktivere tjenestekontohavertilgang i administrasjonsportalen for Power BI. Hvis du ikke er administrator for leieren, kan du få tenantens administrator til å aktivere leierinnstillingene for deg.

  1. Velg Innstillinger Innstillinger Admin-portalen i> Power Bi-tjeneste>.

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

  2. Velg leierinnstillinger , og rull deretter ned til inndelingen Utviklerinnstillinger .

  3. Utvid Tillat tjenestekontohavere å bruke Power BI-API, og aktiver dette alternativet.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

Merk

Når du bruker en tjenestekontohaver, anbefales det å begrense tilgangen til leierinnstillingene ved hjelp av en sikkerhetsgruppe. Hvis du vil ha mer informasjon om denne funksjonen, kan du se disse delene i hovedartikkelen for tjenesten :

Trinn 7 – Aktiver arbeidsområdetilgang

Hvis du vil aktivere microsoft Entra-appens tilgangsobjekter, for eksempel rapporter, instrumentbord og semantiske modeller i Power Bi-tjeneste, legger du til tjenestekontohaveren eller hovedbrukeren, som medlem eller administrator i arbeidsområdet.

  1. Logg på Power BI-tjenesten.

  2. Rull til arbeidsområdet du vil aktivere tilgang for, og velg Arbeidsområdetilgang fra Mer-menyen.

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  3. Kopier tjenestekontohaveren eller hovedbrukeren til tekstboksen Skriv inn e-postadresse i Access-ruten, avhengig av hvilken godkjenningsmetode du bruker.

    Merk

    Hvis du bruker en tjenestekontohaver, er navnet navnet du gav Microsoft Entra-appen.

  4. Velg Legg til.

Trinn 8 – Bygg inn innholdet

Med det innebygde eksempelprogrammet for Power BI kan du opprette en innebygging for kundenes Power BI-app.

Følg disse trinnene for å endre innebygging for kundenes eksempelprogram for å bygge inn Power BI-rapporten.

  1. Åpne eksempelmappen for Power BI-utviklere.

  2. Velg Kode , og velg deretter Last ned zip.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

  3. Trekk ut den nedlastede ZIP-en, og gå til mappen PowerBI-Developer-Samples-master .

  1. Åpne én av disse mappene, avhengig av hvilket språk du vil at appen skal bruke:

    • .NET Core
    • .NET Framework
    • Java
    • Node JS
    • Python

    Merk

    Innebygging for kundenes eksempelprogrammer støtter bare rammeverkene som er oppført ovenfor. React-eksempelprogrammet støtter bare innebygging for organisasjonsløsningen.

  2. Åpne Bygg inn for kundene-mappen.

  1. Åpne innebygging for kundenes eksempelapp ved hjelp av én av disse metodene:

  2. Åpne appsettings.json.

  3. Avhengig av godkjenningsmetoden fyller du ut følgende parameterverdier:

    Parameter Tjenestekontohaver Hovedbruker
    AuthenticationMode ServicePrincipal MasterUser
    ClientId Klient-ID-en for Microsoft Entra-appen Klient-ID-en for Microsoft Entra-appen
    TenantId Leier-ID-en for Microsoft Entra Ikke tilgjengelig
    PbiUsername Ikke tilgjengelig Brukernavnet for hovedbrukeren , se Brukernavn og passord for Power BI
    PbiPassword Ikke tilgjengelig Hovedbrukerpassordet ditt, se Brukernavn og passord for Power BI
    ClientSecret Microsoft Entra ID-klienthemmelighet Ikke tilgjengelig
    WorkspaceId ID-en for arbeidsområdet med den innebygde rapporten, se Arbeidsområde-ID ID-en for arbeidsområdet med den innebygde rapporten, se Arbeidsområde-ID
    ReportId ID-en for rapporten du bygger inn, kan du se Rapport-ID ID-en for rapporten du bygger inn, kan du se Rapport-ID
  4. Kjør prosjektet ved å velge det aktuelle alternativet:

    • Hvis du bruker Visual Studio, velger du IIS Express (spill av).

    • Hvis du bruker Visual Studio Code, velger du Kjør > Start feilsøking.

Utvikle programmet

Når du har konfigurert og kjørt innebygging for kundenes eksempelprogram, kan du begynne å utvikle ditt eget program.

Prøv den innebygde analyselekeplassen for Power BI for å komme i gang med utviklingen og holde tritt med alle de nye funksjonene og oppdateringene for Power BI Embedded.

Når du er klar, kan du se gjennom overgangen til produksjonskravene . Du trenger også en kapasitet, og bør se gjennom artikkelen om kapasitetsplanlegging for å finne ut hvilken SKU som passer best til dine behov.

Viktig

Hvis du brukte gratis prøveversjonstokener for utvikling, må du kjøpe en kapasitet for produksjon. Til en kapasitet er kjøpt, vil banneret for gratis prøveversjon fortsatt vises øverst i den innebygde rapporten.

Har du flere spørsmål? Spør Power BI-fellesskap.