Riešenie problémov s vloženou aplikáciou

V tomto článku sa popisujú niektoré bežné problémy, ktoré môžu prísť pri vkladaní obsahu zo služby Power BI.

Nástroje na riešenie problémov

Trasovanie Fiddlera

Fiddler je bezplatný nástroj od spoločnosti Telerik, ktorý monitoruje prenos údajov cez HTTP. S rozhraniami API služby Power BI môžete z klientskeho počítača sledovať prenosy. Tento nástroj môže zobrazovať chyby a ďalšie súvisiace informácie.

F12 v prehliadači na klientske ladenie

Pomocou kľúča F12 sa v prehliadači spustí vývojárske okno. Tento nástroj vám umožní pozrieť sa na sieťovú prevádzku a zobraziť ďalšie cenné informácie.

Extrahovanie podrobností o chybe z odpovede služby Power BI

Tento zlomok kódu ukazuje, ako extrahovať podrobnosti o chybe z výnimky HTTP:

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

Odporúčame zapisovanie ID požiadavky (a podrobností o chybách) do denníka. Riešenie problémov sa odporúča zapisovať do denníka. Keď sa obrátite na podporu spoločnosti Microsoft, uveďte ID požiadavky.

Registrácia aplikácie

Zlyhanie registrácie aplikácie

Chybové hlásenia na portáli Azure Portal alebo na registračnej stránke aplikácie služby Power BI vás upozorní, ak nemáte dostatočné oprávnenia na registráciu aplikácie. Aby ste mohli aplikáciu zaregistrovať, musíte byť správcom v nájomníkovi Microsoft Entra alebo musí byť povolená registrácia aplikácií pre používateľov bez povolenia správcu.

Po registrácii novej aplikácie sa služba Power BI nezobrazuje na portáli Azure Portal

V službe Power BI musí byť zaregistrovaný aspoň jeden používateľ. Ak sa v zozname rozhraní API nezobrazuje služba Power BI, v službe Power BI nie je zaregistrovaný žiadny používateľ.

Aký je rozdiel medzi ID objektu aplikácie a ID hlavného objektu?

Pri registrácii aplikácie Microsoft Entra existujú dva parametre s názvom ID objektu. Táto časť vysvetľuje účel každého parametra a ako ho získať.

Overovanie

Overenie zlyhalo s AADSTS70002 alebo AADSTS50053

(AADSTS70002: Chyba pri overovaní poverení. AADSTS50053: Pokúsili ste sa veľakrát prihlásiť s nesprávnou identifikáciou používateľa alebo heslom)

Ak používate priame overovanie v službách Power BI Embedded a Microsoft Entra, pri pokuse o prihlásenie sa môže zobraziť približne takéto hlásenie, pretože priame overovanie nie je povolené.

Priame overovanie môžete znova zapnúť pomocou politiky Microsoft Entra, ktorá je zameraná na organizáciu, alebo pomocou objektu služby.

Odporúčame, aby ste túto politiku povolili len pre jednotlivé aplikácie.

Ak chcete vytvoriť túto politiku, musíte byť globálny správca adresára, v ktorom vytvárate politiku a priraďujete ju. Tu je ukážkový skript na vytvorenie politiky a jej priradenie k SP pre túto aplikáciu:

1. Nainštalujte súpravu Microsoft Graph PowerShell SDK.

2. Spustite nasledujúce príkazy prostredia PowerShell riadok po riadku (uistite sa, že premenná $sp nemá viac výsledkov než jednu aplikáciu).

   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 priradení politiky počkajte približne 15 – 20 sekúnd na distribúciu pred testovaním.

Generovanie tokenu zlyhá po zadaní efektívnej identity

GenerateToken môže zlyhať s efektívnou identitou poskytnutou z niekoľkých rôznych dôvodov:

• Sémantický model nepodporuje efektívnu identitu.
• Nebolo zadané meno používateľa.
• Nebola zadaná rola.
• DatasetId nebol poskytnutý.
• Používateľ nemá správne povolenia.

Problém zistíte vykonaním nasledujúcich krokov:

• Spustite získanie množiny údajov. Je vlastnosť IsEffectiveIdentityRequired pravdivá?
• Meno používateľa sa vyžaduje pre všetky EffectiveIdentity.
• Ak je IsEffectiveIdentityRolesRequired true, vyžaduje sa funkcia Role.
• DatasetId sa vyžaduje pre všetky EffectiveIdentity.
• V prípade služieb Analysis Services musí byť hlavný používateľ správcom brány.

AADSTS90094: Udelenie vyžaduje povolenie správcu

príznaky:

Ak sa používateľ, ktorý nie je správcom, pokúša prihlásiť do aplikácie po prvýkrát počas udeľovania súhlasu, zobrazí sa mu jedna z nasledujúcich chýb:

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

•   AADSTS90094: The grant requires admin permission.
  

  

Správca sa môže prihlásiť a úspešne udeliť súhlas.

hlavná príčina:

Súhlas používateľa je pre nájomníka zakázaný.

k dispozícii je niekoľko opráv:

• Povoliť súhlas používateľa pre celého nájomníka (všetci používatelia, všetky aplikácie):

1. Na portáli Azure prejdite na ID služby Microsoft Entra>používatelia a skupiny>používateľských nastavení.
2. Povoľte nastavenie Používatelia môžu udeliť súhlas s aplikáciami, ktoré pristupujú k firemným údajom v ich mene a uložte zmeny.

• Správca môže udeliť povolenia pre aplikáciu – buď pre celého nájomníka, alebo pre konkrétneho používateľa.

Chyba CS1061

Ak sa zobrazí nasledujúca chyba, stiahnite si Microsoft.IdentityModel.Clients.ActiveDirectory:

'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 pre iného nájomníka (hosťovského používateľa)

Keď pre svoju organizáciu, aby ste hosťovským používateľom služby Microsoft Entra umožnili prístup k vášmu obsahu, musíte v parametri authorityUri zadať ID nájomníka.

• URL adresa na overovanie v nájomníkovi vašej organizácie:

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

• URL adresa na overenie hosťa používateľa entra spoločnosti Microsoft:

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

Ak chcete nájsť SVOJE ID nájomníka, môžete použiť pokyny v Nájdite ID nájomníka Microsoft Entra a názov primárnej domény.

Ďalšie informácie nájdete Vytvorenie viacúčelovejaplikácie.

Zdroje údajov

Nezávislý dodávateľ softvéru chce mať iné poverenia pre ten istý zdroj údajov

Zdroj údajov môže mať jeden súbor poverení pre jedného hlavného používateľa. Ak potrebujete použiť iné poverenia, vytvorte viac hlavných používateľov. Potom priraďte rôzne poverenia do kontextov hlavných používateľov a vkladanie vložte pomocou tokenu Microsoft Entra daného používateľa.

Riešenie problémov s vloženou aplikáciou pomocou objektu IError

Pomocou objektu IError vráteného udalosťou chyby zo súpravy JavaScript SDK môžete ladiť aplikáciu a lepšie porozumieť príčine chyby.

Po získaní objektu IError by ste sa mali pozrieť na príslušnú tabuľku s bežnými chybami, ktorá je vhodná pre typ vkladacieho kódu, ktorý používate. Porovnajte vlastnosti IError a s vlastnosťami v tabuľke a nájdite možné dôvody zlyhania.

Typické chyby pri vkladaní pre používateľov služby Power BI

Typické chyby pri vkladaní pre používateľov bez služby Power BI (pomocou tokenu na vloženie)

Get report fails - error 401 - resolve themselves

V scenári používateľ vlastní údaje scenári, niekedy sa používateľom zobrazí chyba 401, ktorá sa sama vyrieši po prístupe na portál služby Power BI. Keď sa vyskytne chyba 401, pridajte povolenia RefreshUser do aplikácie, ako je vysvetlené v článku Aktualizovať povolenia používateľa,.

Sémantické modely

Spravujte, ktorú časť údajov si používatelia môžu zobraziť

Každý používateľ s povoleniami na čítanie pre sémantický model môže vidieť celú schému (tabuľky, stĺpce a mierky) a všetky údaje. Nie je možné ovládať zobrazovanie povolení pre nespracované a agregované údaje samostatne v rovnakom sémantickom modeli.

Ak chcete spravovať, ktorú časť údajov si používatelia môžu zobraziť, použite jeden z nasledujúcich postupov:

• Filtrovanie na úrovni riadkov pomocou služby Power BI zabezpečenia na úrovni riadkov (RLS).

• zabezpečenia na úrovni objektu (Object-Level Security, OLS).

• Oddeľte údaje do rôznych sémantických modelov. Môžete napríklad vytvoriť sémantický model, ktorý obsahuje iba agregované údaje, a poskytnúť používateľom prístup len k tomuto sémantickému modelu.

Vykresľovanie obsahu

Ak chcete vyriešiť problémy s vykresľovaním vo vložených položkách Služby Power BI (napríklad v zostavách a tabuliach), prečítajte si túto časť.

Overenie načítania položky power BI v službe Power BI

Ak chcete vylúčiť problémy so aplikácie alebo rozhraním API na vkladanie, overte, či je možné zobraziť položku v službe Power BI (powerbi.com).

Overte, či sa položka Power BI načíta na lokalite Power BI Embedded Analytics

Ak chcete vylúčiť problémy v aplikácii, overte, či je položka služby Power BI zobrazená v ihrisko pre vloženú analýzu služby Power BI.

Overte, či neuplyla platnosť prístupového tokenu

Prístupové tokeny (token Microsoft Entra alebo token na vloženie) sú z bezpečnostných dôvodov obmedzené. Prístupový token by ste mali neustále monitorovať a v prípade potreby obnovovať. Ďalšie informácie nájdete Obnovenie prístupového tokenu.

Výkon

Ak chcete získať vložený obsah s najlepším výkonom, odporúčame vám postupovať podľa osvedčených postupov vloženej analýzy služby Power BI .

Súvisiaci obsah

najčastejšie otázky o službe Power BI Embedded

Máte ďalšie otázky? spýtajte sa komunity Power BI