Feilsøk det innebygde programmet

Denne artikkelen diskuterer noen kjente problemer som kan oppstå når du bygger inn innhold fra Power BI.

Verktøy for å feilsøke

Fiddler-sporing

Fiddler er et gratis verktøy fra Telerik, som overvåker HTTP-trafikk. Du kan se bevegelsene med Power BI-API-er fra klientmaskinen. Dette verktøyet kan vise feilmeldinger og annen relatert informasjon.

Fiddler-sporing

F12 i nettleseren for feilsøking på frontdelen

F12 starter utvikler-vinduet i nettleseren. Dette verktøyet gir muligheten til å se på nettverkstrafikk og annen informasjon.

F12-feilsøking av nettleser

Trekk ut feilinformasjon fra Power BI-svar

Denne kodesnutten viser hvordan du trekker ut informasjon om feilen fra HTTP-unntaket:

public static string GetExceptionText(this HttpOperationException exc)
{
    var errorText = string.Format("Request: {0}\r\nStatus: {1} ({2})\r\nResponse: {3}",
    exc.Request.Content, exc.Response.StatusCode, (int)exc.Response.StatusCode, exc.Response.Content);
    if (exc.Response.Headers.ContainsKey("RequestId"))
    {
        var requestId = exc.Response.Headers["RequestId"].FirstOrDefault();
        errorText += string.Format("\r\nRequestId: {0}", requestId);
    }

    return errorText;
}

Vi anbefaler at du loggfører ID-er for forespørsler (og feilinformasjon for feilsøking). Oppgi ID for forespørsler når du kontakter Microsoft Kundestøtte.

App-registrering

Mislykket appregistrering

Feilmeldinger i Azure-portalen eller på registreringssiden for Power BI-appen nevner utilstrekkelige rettigheter. Du må være administrator i Azure AD-leieren, eller programregistreringer må være aktivert for brukere uten administratorrettigheter, for å kunne registrere et program.

Power BI-tjenesten vises ikke i Azure-portalen når du registrerer en ny app

Minst en bruker må være registrert for Power BI. Hvis du ikke ser Power BI-tjenesten som er oppført i API-listen, er ingen brukere registrert for Power BI.

Hva er forskjellen mellom program objekt-ID-en og ID for Principal Object?

Når du registrerer en Azure AD-app, finnes det to parametere som heter objekt-ID. Denne delen forklarer formålet med hver parameter, og hvordan du får tak i den.

Program objekt-ID

Application Object ID, som også er ganske enkelt som objekt-ID, er den unike ID-en til Azure ad Application-objektet.

For å hente Application Object ID, kan du gå til Azure AD-appen og kopiere den fra oversikten.

Et skjerm bilde som viser objektet I D i oversikts bladet til et Azure A D-program

Objekt-ID for hovedstol

Principal Object-ID-en, også kjent som objekt-ID, er den unike ID-en til Service Principal-objektet som er knyttet til Azure ad-programmet.

Hvis du vil hente ID-en for Principal Object, navigerer du til Azure AD-appen, og fra oversikten velger du koblingen app i administrert program i lokal katalog.

Et skjerm bilde som viser alternativet administrert program i lokal mappe i oversikts bladet for et Azure A D-program

Kopier objekt-ID- en fra egenskaps delen.

Et skjerm bilde som viser Principal Object i D i egenskaps delen i oversikts bladet til et Azure A D-program

REST-API

API-kall returnerer 401

Et fiddler-opptak kan være nødvendig for å undersøke nærmere. Tillatelsen som kreves for området, mangler kanskje for det registrerte programmet i Azure AD. Kontroller at det nødvendige omfanget er til stede i appregistrering for Azure AD i Azure-portalen.

API-kall returnerer 403

Et fiddler-opptak kan være nødvendig for å undersøke nærmere. Det kan være flere årsaker til 403-feilen.

  • Brukeren har overskredet mengden innebyggingstoken som kan genereres på en delt kapasitet. Kjøp Azure-kapasitet for å generere innebyggingstokener og tilordne arbeidsområdet til denne kapasiteten. Se Opprette Power BI Embedded-kapasitet i Azure-portalen.
  • Azure AD-godkjenningstoken utløpt.
  • Den godkjente brukeren er ikke medlem av gruppen (arbeidsområdet).
  • Den godkjente brukeren er ikke administrator i gruppen (arbeidsområdet).
  • Den godkjente brukeren har ikke tillatelser. Tillatelser kan oppdateres ved hjelp av refreshUserPermissions API
  • Det kan hende at autorisasjonshodet ikke er oppført på riktig måte. Kontroller at det ikke er noen skrivefeil.

Serverdelen for programmet må kanskje oppdatere godkjenningstoken før du kaller GenerateToken. Hvis du vil ha mer informasjon, kan du se oppdatere tilgangstoken.

GET https://wabi-us-north-central-redirect.analysis.windows.net/metadata/cluster HTTP/1.1
Host: wabi-us-north-central-redirect.analysis.windows.net
...
Authorization: Bearer eyJ0eXAiOi...
...

HTTP/1.1 403 Forbidden
...

{"error":{"code":"TokenExpired","message":"Access token has expired, resubmit with a new access token"}}

Hvordan reparere tids avbrudds unntak ved bruk av import-og eksport-API-er?

når du sender en Power BI REST-API -forespørsel, kan det hende at den ankommer en klynge som ikke inneholder data fra leieren din. I slike tilfeller kan det hende at omadressering av forespørselen mislykkes på grunn av et tids avbrudd.

Hvis du vil rette opp tids avbrudds unntaket, kan du sende forespørselen på nytt med preferClientRouting parameteren satt til true . hvis forespørselen ankommer i feil klynge, returnerer Power BI-tjenesten et 307 midlertidig omdirigerings -HTTP-svar. I slike tilfeller må du omadressere forespørselen til den nye adressen som er angitt i hodet for https-plasseringen.

Godkjenning

Godkjenning mislyktes med AADSTS90002: Fant ikke «godkjenning» av leier

Hvis du mottar meldinger når du logger deg på, som feil: invalid_request, error_description: AADSTS90002: Fant ikke «godkjenning» av leier, er det fordi at ADAL 4.x ikke støtter "https://login.microsoftonline.com/{Tenant}/oauth2/authorize/" som en myndighets-nettadresse.

Du løser dette problemet ved å trimme oauth2/authorize/ fra slutten av myndighets-nettadressen, kan du se Utviklereksempler for Power BI for referanse.

Merk av for Bedre godkjenningsvalidering fra produktmerknadene for ADAL 4.x.

Godkjenning mislyktes med AADSTS70002 eller AADSTS50053

(AADSTS70002: Feil under validering av legitimasjon. AADSTS50053: Du har prøvd å logge deg på for mange ganger med feil bruker-ID eller passord)

hvis du bruker Power BI Embedded og bruker Azure AD Direct-godkjenning og mottar meldinger ved å logge på for eksempel feil: unauthorized_client, error_description: AADSTS70002: feil under valide ring av legitimasjon. AADSTS50053: du har prøvd å logge på for mange ganger med feil bruker-ID eller passord, det er fordi direkte godkjenning ikke lenger er i bruk.

Du kan ta i bruk direktegodkjenning igjen ved å bruke en Azure AD-policy som er begrenset til organisasjonen eller en SP (service principal).

Vi anbefaler at du bare aktiverer denne policyen på per-app-basis.

Hvis du vil opprette denne policyen, må du være en Global administrator for mappen der du oppretter og tilordner policyen. Her er et eksempelskript for å opprette policyen og tilordne den til SP-en for dette programmet:

  1. Installer PowerShell-modulen for Azure AD-forhåndsversjonen.

  2. Kjør den følgende PowerShell-kommandoen linje for linje (kontroller at variabelen $sp ikke har mer enn ett program som resultat).

Connect-AzureAD
$sp = Get-AzureADServicePrincipal -SearchString "Name_Of_Application"
$policy = New-AzureADPolicy -Definition @("{`"HomeRealmDiscoveryPolicy`":{`"AllowCloudPasswordValidation`":true}}") -DisplayName EnableDirectAuth -Type HomeRealmDiscoveryPolicy -IsOrganizationDefault $false
Add-AzureADServicePrincipalPolicy -Id $sp.ObjectId -RefObjectId $policy.Id 

Når du har tilordnet policyen, må du vente i rundt 15–20 sekunder på overføringen før du tester.

Generer token mislykkes ved angivelse av effektiv identitet

GenerateToken kan mislykkes med angitt effektiv identitet av ulike årsaker.

  • Datasettet støtter ikke gjeldende identitet
  • Brukernavnet ble ikke angitt
  • Rollen ble ikke angitt
  • Datasett-ID ble ikke angitt
  • Brukeren har ikke riktige tillatelser

Hvis du vil kontrollere hvilken det er, kan du prøve følgende fremgangsmåte.

  • Utfør Hent datasett. Er egenskapen IsEffectiveIdentityRequired sann?
  • Brukernavnet er obligatorisk for en hvilken som helst EffectiveIdentity.
  • Hvis IsEffectiveIdentityRolesRequired er sann, kreves Rolle.
  • Datasett-ID er obligatorisk for en hvilken som helst EffectiveIdentity.
  • For Analysis Services må hovedbrukeren være en administrator for gatewayen.

AADSTS90094: Tildelingen krever administratortillatelse

Symptomer:
Når en bruker som ikke er administrator, prøver å logge seg på et program for første gang og samtidig gi samtykke, får vedkommende én av følgende feilmeldinger:

  • ConsentTest må ha tillatelse til å få tilgang til ressurser i organisasjonen som bare en administrator kan gi. Be en administrator om å gi tillatelse til denne appen før du kan bruke den.

  • AADSTS90094: Tildelingen krever administratortillatelse.

    ConsentTest

En administratorbruker kan logge seg på og gi samtykke.

Grunnårsak:
Brukersamtykke er deaktivert for leieren.

Flere løsninger er mulige:

Aktiver brukersamtykke for hele leieren (alle brukere, alle programmer)

  1. Gå til Azure Active Directory = > Brukere og grupper = > Brukerinnstillinger i Azure Portal

  2. Aktiver «Brukere kan gi samtykke til at apper får tilgang til firmadata på deres vegne», og lagre endringene

    ConsentTest-løsning

Gi tillatelser til programmet via en administrator – for hele leieren eller for en bestemt bruker.

CS1061-feil

Last ned Microsoft.IdentityModel.Clients.ActiveDirectory hvis du opplever feilen «'AuthenticationContext' inneholder ikke en definisjon for 'AcquireToken', og finner ingen tilgjengelig 'AcquireToken' som godtar et første argument av typen 'AuthenticationContext' (mangler du et bruksdirektiv eller en samlingsreferanse?)».

Azure AD-token for en annen leier (gjestebruker)

Når du bygger inn for organisasjonen, må du angi leier-ID-en i parameteren for å gi gjestebrukere i Azure AD tilgang til innholdet authorityUri ditt.

  • Nettadresse for godkjenning i organisasjonens leier:

    https://login.microsoftonline.com/common/v2.0

  • Nettadresse for godkjenning av en gjestebruker av Azure AD:

    https://login.microsoftonline.com/<tenant ID>

Hvis du vil finne leier-ID-en, kan du bruke instruksjonene i Finn Microsoft Azure AD-ID-enfor leieren og det primære domenenavnet .

Hvis du vil ha mer informasjon, kan du se Slik logger du deg på Azure Active Directory bruker ved hjelp av mønsteret for fler tenantprogram.

Datakilder

ISV vil ha annen legitimasjon for den samme datakilden

En datakilde kan ha ett enkelt sett med legitimasjon for en overordnet bruker. Hvis du vil bruke annen legitimasjon, kan du opprette flere overordnede brukere. Deretter tilordner du ulik legitimasjon i hver kontekst for hovedbrukeren, og bygger inn ved hjelp av Azure AD-tokenet for denne brukeren.

Feilsøk det innebygde programmet med IError-objektet

Bruk IError-objektet som ble returnert av feil-hendelsen fra JavaScript SDK til å feilsøke programmet og bedre forstå årsaken til feilene.

Etter å ha hentet IError-objektet, bør du se på «vanlige feil»-tabellen som passer for innebyggingstypen du bruker. Sammenlign IError-egenskapene med feilene i tabellen og finn de(n) mulige årsaken(e) til feilen.

Vanlige feil når du bygger inn for Power BI-brukere

Melding Detaljert melding Feilkode Mulig(e) årsak(er)
TokenExpired Tilgangstokenet er utløpt, send inn på nytt med et nytt tilgangstoken 403 Utløpt token
PowerBIEntityNotFound Innlasting av rapport mislyktes 404
  • Feil rapport-ID
  • Rapporten finnes ikke
  • Ugyldige parametere powerbiToken-parameter er ikke angitt I/T
  • Ingen tilgangstoken angitt
  • Ingen rapport-ID angitt
  • LoadReportFailed Kan ikke initialisere – kan ikke løse klynge 403
  • Ugyldig tilgangstoken
  • Innebyggingstypen samsvarer ikke med tokentypen
  • PowerBINotAuthorizedException Innlasting av rapport mislyktes 401
  • Feil gruppe-ID
  • Uautorisert gruppe
  • TokenExpired Tilgangstokenet er utløpt, send inn på nytt med et nytt tilgangstoken. Kan ikke gjengi visualobjekt i en rapport med navnet: tittel på visualobjekt I/T Spørringsdata for utløpte token
    OpenConnectionError Kan ikke vise visualobjektet. Kan ikke gjengi visualobjekt i en rapport med navnet: tittel på visualobjekt I/T Kapasitet satt på pause eller slettet mens en rapport som er relatert til kapasiteten var åpen i en økt
    ExplorationContainer_FailedToLoadModel_DefaultDetails Kan ikke laste inn modellskjemaet knyttet til denne rapporten. Kontroller at du har en tilkobling til serveren, og prøv på nytt. I/T
  • Kapasiteten er midlertidig stanset
  • Kapasiteten er slettet
  • Vanlige feil når du bygger inn for andre enn Power BI-brukere (ved bruk av et innebyggingstoken)

    Melding Detaljert melding Feilkode Årsak(er)
    TokenExpired Tilgangstokenet er utløpt, send inn på nytt med et nytt tilgangstoken 403 Utløpt token
    LoadReportFailed Innlasting av rapport mislyktes 404
  • Feil rapport-ID
  • Rapporten finnes ikke
  • LoadReportFailed Innlasting av rapport mislyktes 403 Rapport-IDen samsvarer ikke med token
    LoadReportFailed Innlasting av rapport mislyktes 500 Den angitte ID-en for rapporten er ikke en guid
    Ugyldige parametere powerbiToken-parameter er ikke angitt I/T
  • Ingen tilgangstoken angitt
  • Ingen rapport-ID angitt
  • LoadReportFailed Kan ikke initialisere – kan ikke løse klynge 403 Ugyldig tokentype, ugyldig token
    PowerBINotAuthorizedException Henting av rapport mislyktes 401 Feil/uautorisert gruppe-ID
    TokenExpired Tilgangstokenet er utløpt, send inn på nytt med et nytt tilgangstoken. Kan ikke gjengi visualobjekt i en rapport med navnet: tittel på visualobjekt I/T Spørringsdata for utløpte token
    OpenConnectionError Kan ikke vise visualobjektet. Kan ikke gjengi visualobjekt i en rapport med navnet: tittel på visualobjekt I/T Kapasitet satt på pause eller slettet mens en rapport som er relatert til kapasiteten var åpen i en økt
    ExplorationContainer_FailedToLoadModel_DefaultDetails Kan ikke laste inn modellskjemaet knyttet til denne rapporten. Kontroller at du har en tilkobling til serveren, og prøv på nytt. I/T
  • Kapasiteten er midlertidig stanset
  • Kapasiteten er slettet
  • Datasett

    Administrere hvilken del av dataene som brukerne kan se

    Alle brukere med lesetilgang for et datasett kan se hele skjemaet (tabeller, kolonner og mål) og alle dataene. Du kan ikke kontrollere visningstillatelser separat for rå og aggregerte data i samme datasett.

    Hvis du vil administrere hvilken del av dataene brukerne kan vise, kan du bruke én av disse metodene:

    Gjengivelse av innhold

    Hvis du vil løse problemer med gjengivelse i innebygde Power BI elementer (for eksempel rapporter og instrumentbord), kan du se gjennom denne delen.

    Bekreft at Power BI innlasting av Power BI tjenesten

    Hvis du vil utelukke problemer med programmet eller de innebygde API-ene , må du bekrefte at elementet kan vises i Power BI-tjenesten (powerbi.com).

    Kontroller at Power BI laster inn det innebygde Power BI analyse-lekeplassen

    Hvis du vil utelukke problemer med programmet, må du Power BI at elementelementet Power BI vises i den Power BI innebygde analyse-lekeplassen.

    Kontroller at tilgangstokenet ikke utløper

    Av sikkerhetsgrunner har tilgangstokener (et Azure AD-token eller et innebyggingstoken) en begrenset levetid. Du bør kontinuerlig overvåke tilgangstokenet ditt og oppdatere det ved behov. Hvis du vil ha mer informasjon, kan du se Oppdatere tilgangstokenet.

    Ytelse

    Hvis du vil ha best mulig innebygd innhold, anbefaler vi at du følger de Power BI anbefalte fremgangsmåtene for analyse.

    Konfigurasjonsverktøy for innbygging

    Du kan gå gjennom konfigurasjonsverktøyet for innbygging for å raskt å laste ned et eksempelprogram. Deretter kan du sammenligne programmet ditt med eksempelprogrammet.

    Forutsetninger

    Kontroller at du har alle de nødvendige forutsetningene før du bruker konfigurasjonsverktøyet for innbygging. Du trenger en Power BI Pro-konto og et Microsoft Azure-abonnement.

    Vanlige problemer

    Noen vanlige problemer som kan oppstå når du prøver ut konfigurasjonsverktøyet for innbygging:

    Å bruke Bygg inn for kundene sine eksempelprogrammer

    Hvis du arbeider med Bygg inn for kundene, lagrer og pakker du ut PowerBI-Developer-Samples.zip-filen. Deretter åpner du PowerBI-Developer-Samples-master\App Owns Data-mappen og kjører PowerBIEmbedded_AppOwnsData.sln-filen.

    Når du velger Gi tillatelser (Gi tillatelser-trinnet), får du følgende feilmelding:

    AADSTS70001: Application with identifier <client ID> wasn't found in the directory <directory ID>
    

    Løsningen er å lukke hurtigmenyen, vente litt og prøve på nytt. Du må kanskje gjenta denne handlingen et par ganger. Et tidsintervall forårsaker problemet med å fullføre registreringsprosessen for når programmet skal være tilgjengelig for eksterne API-er.

    Følgende feilmelding vises når du kjører eksempelappen:

    Password is empty. Please fill password of Power BI username in web.config.
    

    Denne feilen oppstår fordi den eneste verdien som ikke blir satt inn i eksempelprogrammet, er brukerpassordet ditt. Åpne filen Web.config i løsningen og fyll ut feltet pbiPassword med brukerens passord.

    Hvis du får feilen AADSTS50079: Brukeren må bruke godkjenning med flere faktorer.

    Du må bruke en AAD-konto som ikke har godkjenning med flere faktorer aktivert.

    Å bruke Bygg inn for organisasjonens eksempelprogram

    Hvis du arbeider med Bygg inn for organisasjonen, lagrer og pakker du ut PowerBI-Developer-Samples.zip-filen. Deretter åpner du mappen PowerBI-Developer-Samples-master\User Owns Data\integrate-report-web-app og kjører pbi-saas-embed-report.sln-filen.

    Når du kjører eksempelappen Bygg inn for organisasjonen, får du følgende feilmelding:

    AADSTS50011: The reply URL specified in the request doesn't match the reply URLs configured for the application: <client ID>
    

    Denne feilen skyldes at nettadressen for omadressering for webserver-programmet er forskjellig fra nettadressen fra eksemplet. Hvis du vil registrere eksempelprogrammet, kan du bruke https://localhost:13526/ som nettadressen for omadressering.

    Hvis du vil redigere det registrerte programmet, må du lære hvordan du oppdaterer det Azure AD-registrerte programmet, slik at programmet kan gi tilgang til web-API-er.

    Hvis du ønsker å redigere brukerprofilen eller data for Power BI, bør du lære hvordan du redigerer Power BI-data.

    Hvis du får feilen AADSTS50079, må brukeren bruke godkjenning med flere faktorer.

    Du må bruke en AAD-konto som ikke har godkjenning med flere faktorer aktivert.

    Hvis du vil ha mer informasjon, kan du se Vanlige spørsmål om Power BI Embedded.

    Har du flere spørsmål? Prøv Power BI-fellesskapet

    Hvis du trenger mer hjelp, kan du kontakte kundestøtte eller opprette en støtteforespørsel via Azure Portal og angi feilmeldingen(e) du møter på.

    Neste trinn

    Hvis du vil ha mer informasjon, kan du se Vanlige spørsmål.

    Har du flere spørsmål? Prøv Power BI-fellesskapet