Řešení potíží s vloženou aplikací

Tento článek popisuje některé běžné problémy, které se můžou zobrazit při vkládání obsahu z Power BI.

Nástroje pro řešení potíží

Trasování Fiddleru

Fiddler je bezplatný nástroj od Společnosti Telerik, který monitoruje provoz HTTP. Provoz můžete zobrazit pomocí rozhraní API Power BI z klientského počítače. Tento nástroj může zobrazit chyby a další související informace.

snímek obrazovky s oknem výstupu nástroje Fiddler, ve kterém se zobrazuje přenos HTTP rozhraní API Power BI.

F12 v prohlížeči pro ladění front-endu

Klávesa F12 spustí okno pro vývojáře v prohlížeči. Tento nástroj umožňuje podívat se na síťový provoz a zobrazit další cenné informace.

snímek obrazovky s kartou Síť okna pro vývojáře webového prohlížeče, která zobrazuje síťový provoz.

Extrahování podrobností o chybě z odpovědi Power BI

Tento fragment kódu ukazuje, jak extrahovat podrobnosti o chybě z výjimky HTTP:

C#
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;
}

Doporučujeme protokolovat ID žádosti (a podrobnosti o chybě pro řešení potíží). Při přístupu k podpoře Microsoftu zadejte ID žádosti.

Registrace aplikace

Selhání registrace aplikace

Chybové zprávy na webu Azure Portal nebo na stránce registrace aplikace Power BI vás upozorní, pokud nemáte dostatečná oprávnění k registraci aplikace. Pokud chcete zaregistrovat aplikaci, musíte být správcem v tenantovi Microsoft Entra nebo registrace aplikací musí být povolené pro uživatele, kteří nejsou správci.

Služba Power BI se nezobrazuje na webu Azure Portal při registraci nové aplikace

K Power BI musí být zaregistrovaný alespoň jeden uživatel. Pokud v seznamu rozhraní API nevidíte službu Power BI, není k Power BI zaregistrovaný žádný uživatel.

Jaký je rozdíl mezi ID objektu aplikace a ID hlavního objektu?

Při registraci aplikace Microsoft Entra existují dva parametry s názvem ID objektu. Tato část vysvětluje účel každého parametru a jeho získání.

ID objektu aplikace

ID objektu aplikace , označované také jako ID objektu , je jedinečné ID objektu aplikace Microsoft Entra.

Pokud chcete získat ID objektu aplikace, přejděte do aplikace Microsoft Entra a zkopírujte jej z Přehled.

snímek obrazovky okna webu Azure Portal, který zobrazuje ID objektu v okně Přehled aplikace Microsoft Entra.

ID hlavního objektu

ID instančního objektu, označované také jako ID objektu , je jedinečné ID instančního objektu přidružené k vaší aplikaci Microsoft Entra.

Pokud chcete získat ID hlavního objektu, přejděte do aplikace Microsoft Entra a v Přehledvyberte odkaz aplikace v Spravovaná aplikace v místním adresáři.

Snímek obrazovky okna portálu Azure, který zobrazuje možnost spravované aplikace v místním adresáři v panelu Přehled aplikace Microsoft Entra.

V části Vlastnosti zkopírujte ID objektu.

snímek obrazovky okna portálu Azure, který zobrazuje ID hlavního objektu v sekci Vlastnosti v části Přehled aplikace Microsoft Entra.

Autentizace

Ověřování selhalo s AADSTS70002 nebo AADSTS50053

(AADSTS70002: Chyba při ověřování přihlašovacích údajů AADSTS50053: Pokusili jste se přihlásit příliš mnohokrát s nesprávným ID uživatele nebo heslem)

Pokud používáte Power BI Embedded a přímé ověřování Microsoft Entra, může se vám při pokusu o přihlášení zobrazit zpráva podobná předchozí zprávě, protože přímé ověřování není povolené.

Přímé ověřování můžete znovu zapnout pomocí zásad Microsoft Entra, které jsou vymezeny pro organizaci, nebo aplikačního objektu.

Tuto zásadu doporučujeme povolit jenom pro jednotlivé aplikace.

Abyste mohli tuto zásadu vytvořit, je nutné být globálním správcem adresáře, kde vytváříte a přiřazujete zásadu. Tady je ukázkový skript pro vytvoření zásady a jeho přiřazení k SP pro tuto aplikaci:

  1. Nainstalujte Microsoft Graph PowerShell SDK .

  2. Spusťte následující příkazy PowerShellu po řádku (ujistěte se, že proměnná $sp nemá v důsledku toho víc než jednu aplikaci).

    PowerShell
    Connect-MgGraph -Scopes "Directory.Read.All","Policy.ReadWrite.ApplicationConfiguration"
    
    $sp = Get-MgServicePrincipal -Filter "DisplayName eq 'Name_Of_Application'"
    
    $policy = New-MgBetaPolicyActivityBasedTimeoutPolicy -Definition @("{`"AllowCloudPasswordValidation`":true}") `
       -DisplayName EnableDirectAuth -IsOrganizationDefault:$false
    
    $params = @{
       "@odata.id" = "https://graph.microsoft.com/v1.0/policies/claimsMappingPolicies/$policy.Id"
    }
    New-MgBetaServicePrincipalClaimMappingPolicyByRef -ServicePrincipalId $sp.Id `
       -BodyParameter $params
    

Po přiřazení zásady počkejte před testováním přibližně 15 až 20 sekund, aby se změny projevily.

Selhání generování tokenu při poskytování efektivní identity

GenerateToken může selhat s efektivní identitou zadanou z několika různých důvodů:

  • Sémantický model nepodporuje efektivní identitu.
  • Uživatelské jméno nebylo zadané.
  • Role nebyla poskytnuta.
  • DatasetId nebyl poskytnut.
  • Uživatel nemá správná oprávnění.

Pokud chcete zjistit problém, vyzkoušejte následující kroky:

  • Spusťte pro získání datové sady. Je vlastnost IsEffectiveIdentityRequired true?
  • Uživatelské jméno je vyžadováno pro všechny EffectiveIdentity.
  • Pokud je IsEffectiveIdentityRolesRequired pravdivá, je vyžadována role.
  • DatasetId se vyžaduje pro jakýkoliv EffectiveIdentity.
  • Pro Analysis Services musí být hlavním uživatelem správce brány.

AADSTS90094: Udělení vyžaduje oprávnění správce.

příznaky :

Když se uživatel bez oprávnění správce pokusí přihlásit k aplikaci poprvé při udělování souhlasu, zobrazí se jedna z následujících chyb:

  • Output
      ConsentTest needs permission to access resources in your organization that only an admin can grant. Ask an admin to grant permission to this app before you can use it.
    
  • Output
      AADSTS90094: The grant requires admin permission.
    

    snímek obrazovky s přihlašovacím dialogem okna webu Azure Portal, který zobrazuje chybu oprávnění k testu souhlasu.

Uživatel s oprávněním správce se může přihlásit a udělit souhlas úspěšně.

Hlavní příčina:

Souhlas uživatele je pro tenanta zakázaný.

je možné provést několik oprav:

  • Povolení souhlasu uživatele pro celého tenanta (všichni uživatelé, všechny aplikace):
  1. Na webu Azure Portal přejděte na ID Microsoft Entra>Uživatelé a skupiny>Nastavení uživatele.
  2. Povolte nastavení Uživatelé můžou udělit souhlas s aplikacemi, které přistupují k firemním datům jejich jménem, a uložte změny.

snímek obrazovky webu Azure Portal

  • Správce může aplikaci udělit oprávnění – buď pro celého tenanta, nebo pro konkrétního uživatele.

Chyba CS1061

Pokud dojde k následující chybě, stáhněte Microsoft.IdentityModel.Clients.ActiveDirectory:

Output
'AuthenticationContext' does not contain a definition for 'AcquireToken' and no accessible 'AcquireToken' accepting a first argument of type 'AuthenticationContext' could be found (are you missing a using directive or an assembly reference?)

Token Microsoft Entra pro jiného klienta (hostující uživatel)

Když vložení pro vaši organizaci, aby hosté Microsoft Entra měli přístup k vašemu obsahu, musíte v parametru authorityUri zadat ID tenanta.

  • Adresa URL pro ověřování v tenantovi vaší organizace:

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

  • Adresa URL pro ověření hostujícího uživatele Microsoft Entra:

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

K vyhledání ID tenanta můžete použít pokyny v Najít ID tenanta Microsoft Entra a primární název domény.

Další informace naleznete v tématu Jak vytvořit vaši aplikaci víceklientskou.

Zdroje dat

IsV chce mít pro stejný zdroj dat jiné přihlašovací údaje.

Zdroj dat může mít jednu sadu přihlašovacích údajů pro jednoho hlavního uživatele. Pokud potřebujete použít jiné přihlašovací údaje, vytvořte další hlavní uživatele. Potom přiřaďte k jednotlivým kontextům hlavního uživatele různé přihlašovací údaje a vložte je pomocí tokenu Microsoft Entra tohoto uživatele.

Řešení potíží s vloženou aplikací pomocí objektu IError

Použijte objekt IError vrácený událostí chyby ze sady JavaScript SDK k ladění aplikace a lepšímu pochopení příčiny chyb.

Po získání objektu IError byste se měli podívat na příslušnou tabulku běžných chyb, která odpovídá používanému typu vložení. Porovnejte vlastnosti IError s vlastnostmi v tabulce a vyhledejte možné důvody selhání.

Typické chyby při vkládání pro uživatele Power BI

Zpráva Podrobná zpráva Kód chyby Možné důvody
Platnost tokenu vypršela Platnost přístupového tokenu vypršela, odešlete prosím žádost znovu s novým přístupovým tokenem. 403 Token s vypršenou platností
PowerBIEntityNotFound Získání sestavy se nezdařilo. 404
  • Nesprávné ID sestavy
  • Sestava neexistuje.
  • Neplatné parametry Parametr powerbiToken není zadaný. Není k dispozici
  • Nebyl poskytnut žádný přístupový token.
  • Nebylo poskytnuto ID sestavy
  • NačteníZprávySelhalo Nepodařilo se inicializovat – Nepodařilo se vyřešit cluster 403
  • Chybný přístupový token
  • Typ vložení neodpovídá typu tokenu
  • PowerBINotAuthorizedException Zprávu se nepodařilo získat. 401
  • Nesprávné ID skupiny
  • Neautorizovaná skupina
  • Platnost tokenu vypršela Platnost přístupového tokenu vypršela, odešlete znovu s novým přístupovým tokenem. Nelze vykreslit vizuál sestavy s názvem: název vizuálu Není k dispozici
  • Dotazování dat
  • Token s vypršenou platností
  • OpenConnectionError Vizuál se nedá zobrazit. Vizuál sestavy nelze vykreslit s názvem: název vizuálu Není k dispozici Kapacita byla pozastavena nebo smazána během relace, kdy byla otevřena sestava související s kapacitou.
    Kontejner průzkumu: Nepodařilo se načíst model - Výchozí podrobnosti Nelze načíst schéma modelu přidružené k této sestavě. Ujistěte se, že máte připojení k serveru, a zkuste to znovu. Není k dispozici
  • Kapacita pozastavena
  • Odstraněná kapacita
  • Typické chyby při vkládání pro uživatele mimo Power BI (pomocí tokenu pro vložení)

    Zpráva Podrobná zpráva Kód chyby Možné důvody
    Platnost tokenu vypršela Platnost přístupového tokenu vypršela, znovu odešlete žádost s novým přístupovým tokenem. 403 Token s vypršenou platností
    NačteníZprávySelhalo Nepodařilo se získat sestavu. 404
  • Nesprávné ID sestavy
  • Sestava neexistuje.
  • NačteníZprávySelhalo Získání sestavy se nezdařilo. 403 ID sestavy neodpovídá tokenu
    Selhání načítání zprávy Nepodařilo se získat sestavu. 500 Zadané poskytnuté ID není GUID
    Neplatné parametry Parametr powerbiToken není zadaný. Není k dispozici
  • Nebyl poskytnut žádný přístupový token.
  • Není poskytnuto žádné ID sestavy
  • NačítáníZprávySelhalo Nepodařilo se inicializovat – Nepodařilo se vyřešit cluster 403 Nesprávný typ tokenu nebo chybný token
    PowerBINotAuthorizedException Sestavu se nepodařilo získat. 401 Nesprávné nebo neautorizované ID skupiny
    Platnost tokenu vypršela Platnost přístupového tokenu vypršela, použijte nový přístupový token k odeslání žádosti znovu. Vizuál sestavy nelze vykreslit s názvem: název vizuálu Není k dispozici
  • Dotazování dat
  • Token s vypršenou platností
  • OpenConnectionError Vizuál se nedá zobrazit. Nelze vykreslit vizuál sestavy s názvem: název vizuálu Není k dispozici Zatímco byla v relaci otevřena sestava související s kapacitou, kapacita byla pozastavena nebo odstraněna.
    Průzkumník_Kontejner_NepodařiloSeNačístModel_VýchozíPodrobnosti Nelze načíst schéma modelu přidružené k této sestavě. Ujistěte se, že máte připojení k serveru, a zkuste to znovu. Není k dispozici
  • Kapacita pozastavena
  • Odstraněná kapacita
  • Načítání zprávy selže – chyba 401 – vyřešte sami

    Ve scénáři uživatel vlastní data se někdy uživatelům zobrazí chyba 401, která se vyřeší po přístupu k portálu Power BI. Pokud dojde k chybě 401, přidejte do aplikace volání RefreshUser oprávnění, jak je uvedeno v Aktualizace uživatelských oprávnění.

    Sémantické modely

    Správa části dat, která uživatelé uvidí

    Každý uživatel s oprávněním ke čtení pro sémantický model může zobrazit celé schéma (tabulky, sloupce a míry) a všechna data. Zobrazení oprávnění k nezpracovaným a agregovaným datům nemůžete řídit samostatně ve stejném sémantickém modelu.

    Pokud chcete spravovat, kterou část dat můžou uživatelé zobrazit, použijte jednu z následujících metod:

    Vykreslování obsahu

    Pokud chcete vyřešit problémy s vykreslováním ve vložených položkách Power BI (například sestavách a řídicích panelech), projděte si tuto část.

    Ověřte, že se položka Power BI načte ve službě Power BI

    Pokud chcete vyloučit problémy s vaší aplikací nebo rozhraními API pro vkládání, ověřte, že je možné položku zobrazit ve službě Power BI (powerbi.com).

    Ověřte, že se položka Power BI načte v testovacím prostředí Power BI pro vloženou analytiku.

    Chcete-li vyloučit problémy s vaší aplikací, ověřte, že je možné položku Power BI zobrazit v integrovaném analytickém prostředí Power BI na .

    Ověřte, že nevypršela platnost přístupového tokenu.

    Pro účely zabezpečení mají přístupové tokeny (token Microsoft Entra nebo token pro vložení) omezenou životnost. V případě potřeby byste měli neustále monitorovat přístupový token a aktualizovat ho. Další informace najdete v tématu Aktualizace přístupového tokenu.

    Výkon

    Pokud chcete dosáhnout nejlepšího výkonu vloženého obsahu, doporučujeme se řídit osvědčenými postupy pro analýzy Power BI Embedded .

    Power BI Embedded – nejčastější dotazy

    Máte další otázky? Položit otázku komunitě Power BI