Eklenmiş uygulamanızın sorunlarını giderme

Bu makalede, Power BI'dan içerik eklenirken ortaya çıkabilecek bazı yaygın sorunlar ele alınmaktadır.

Sorun giderme araçları

Fiddler İzleme

Fiddler, Telerik'in HTTP trafiğini izleyen ücretsiz bir aracıdır. İstemci makinesinden Power BI API'leriyle trafiği görebilirsiniz. Bu araç hataları ve diğer ilgili bilgileri gösterebilir.

Ön uç hata ayıklaması için Tarayıcıda F12

F12 anahtarı, tarayıcınızda geliştirici penceresini başlatır. Bu araç, ağ trafiğine bakmanızı ve diğer değerli bilgileri görmenizi sağlar.

Power BI yanıtından hata ayrıntılarını ayıklama

Bu kod parçacığı, bir HTTP özel durumdan hata ayrıntılarını ayıklamayı gösterir:

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

Öneririz ki İstek Kimliğini (ve sorun giderme için hata ayrıntılarını) kaydetmenizi. Microsoft desteğine yaklaşırken İstek Kimliğini belirtin.

Uygulama kaydı

Uygulama kaydı hatası

Azure portalında veya Power BI uygulama kaydı sayfasında hata iletileri, uygulamanızı kaydetmek için yeterli ayrıcalığınız yoksa sizi bilgilendirir. Bir uygulamayı kaydetmek için Microsoft Entra kiracısında yönetici olmanız veya yönetici olmayan kullanıcılar için uygulama kayıtlarının etkinleştirilmesi gerekir.

Yeni bir uygulama kaydederken Power BI hizmeti Azure portalında görünmüyor

Power BI'a en az bir kullanıcının kaydolması gerekir. API listesinde Power BI hizmeti listelendiğini görmüyorsanız, hiçbir kullanıcı Power BI'a kaydolmaz.

Uygulama nesne kimliği ile asıl nesne kimliği arasındaki fark nedir?

Bir Microsoft Entra uygulamasını kaydettiğinizde, nesne kimliğiadlı iki parametre vardır. Bu bölümde her parametrenin amacı ve nasıl edinilen açıklanır.

Uygulama nesne kimliği

nesne kimliği olarak da bilinen uygulama nesnesi kimliği, Microsoft Entra uygulama nesnenizin benzersiz kimliğidir.

Uygulama nesne kimliğini almak için Microsoft Entra uygulamanıza gidin ve Genel Bakış'ndan kopyalayın.

Asıl nesne kimliği

nesne kimliği olarak da bilinen asıl nesne kimliği, Microsoft Entra uygulamanızla ilişkili hizmet sorumlusu nesnesinin benzersiz kimliğidir.

Asıl nesne kimliğinizi almak için Microsoft Entra uygulamanıza gidin ve Genel Bakışbölümünden yerel dizinde yönetilen uygulamauygulama bağlantısını seçin.

Özellikleri bölümünden Nesne Kimliğikopyalayın.

Kimlik doğrulama

Kimlik doğrulaması AADSTS70002 veya AADSTS50053 ile başarısız oldu

(AADSTS70002: Kimlik bilgileri doğrulanırken hata oluştu. AADSTS50053: Yanlış kullanıcı kimliği veya parolayla çok fazla oturum açmayı denediniz)

Power BI Embedded ve Microsoft Entra doğrudan kimlik doğrulamasını kullanıyorsanız, doğrudan kimlik doğrulaması etkinleştirilmediğinden oturum açmaya çalıştığınızda önceki iletiye benzer bir ileti alabilirsiniz.

Microsoft Entra ilkesini ya da hizmet sorumlusunukuruluş kapsamında kullanarak doğrudan kimlik doğrulamasını tekrar etkinleştirebilirsiniz.

Bu ilkeyi yalnızca uygulama bazında etkinleştirmenizi öneririz.

Bu ilkeyi oluşturmak için, ilkeyi oluşturup atadığınız dizin için Genel Yönetici olmanız gerekir. İlkeyi oluşturmak ve bu uygulama için SP'ye atamak için örnek bir betik aşağıda verilmiştir:

1. Microsoft Graph PowerShell SDK'sınıyükleyin.

2. Aşağıdaki PowerShell komutlarını satır satır çalıştırın ($sp değişkeninin sonuç olarak birden fazla uygulama olmadığından emin olun).

   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
   

İlkeyi atadıktan sonra, test etmeden önce yayma için yaklaşık 15-20 saniye bekleyin.

Etkin kimlik sağlanırken belirteç oluşturma işlemi başarısız oluyor

GenerateToken birkaç farklı nedenden dolayı sağlanan geçerli kimlikle başarısız olabilir:

• Anlam modeli etkin kimliği desteklemez.
• Kullanıcı adı sağlanmadı.
• Bir rol verilmedi.
• DatasetId sağlanmadı.
• Kullanıcının doğru izinleri yok.

Sorunu belirlemek için aşağıdaki adımları deneyin:

• komutunu çalıştırarak veri kümesi'i al. Özellik IsEffectiveIdentityRequired doğru mu?
• herhangi bir EffectiveIdentityiçin kullanıcı adı gereklidir.
• Eğer IsEffectiveIdentityRolesRequired doğruysa, Rol gereklidir.
• EffectiveIdentityiçin DatasetId gereklidir.
• Analysis Services için ana kullanıcının ağ geçidi yöneticisi olması gerekir.

AADSTS90094: Yetki vermek için yönetici izni gerekiyor

Belirtileri:

Yönetici olmayan bir kullanıcı onay verirken bir uygulamada ilk kez oturum açmaya çalıştığında aşağıdaki hatalardan birini alır:

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

  

Yönetici kullanıcı başarıyla oturum açabilir ve onay verebilir.

Kök nedeni:

Kiracı için kullanıcı onayı devre dışı bırakıldı.

Çeşitli düzeltmeler mümkündür:

• Kiracının tamamı için kullanıcı onayını etkinleştirin (tüm kullanıcılar, tüm uygulamalar):

1. Azure portalında Microsoft Entra ID>Kullanıcılar ve gruplar>Kullanıcı ayarlarıgidin.
2. Kullanıcıların şirket verilerine kendi adlarına erişmesine izin ayarını etkinleştirin ve değişiklikleri kaydedin.

• Yönetici uygulamaya kiracının tamamı veya belirli bir kullanıcı için izin verebilir.

CS1061 hatası

Aşağıdaki hatayla karşılaşırsanız Microsoft.IdentityModel.Clients.ActiveDirectory indirin:

'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?)

Farklı bir kiracı için Microsoft Entra belirteci (konuk kullanıcı)

kuruluşunuz için eklemeMicrosoft Entra konuk kullanıcılarının içeriğinize erişmesine izin vermek için, authorityUri parametresinde kiracı kimliğini belirtmeniz gerekir.

• Kuruluşunuzun kiracısında kimlik doğrulaması url'si:

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

• Konuk Microsoft Entra kullanıcısını kimlik doğrulaması için URL:

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

Kiracı kimliğinizi bulmak için Microsoft Entra kiracı kimliğini ve birincil etki alanı adını bulmaiçindeki yönergeleri kullanabilirsiniz.

Daha fazla bilgi için Uygulamanızı çok kiracılı hale getirmekonulu belgeye bakın.

Veri kaynakları

ISV, aynı veri kaynağı için farklı kimlik bilgilerine sahip olmak istiyor

Bir veri kaynağı, tek bir ana kullanıcı için tek bir kimlik bilgileri kümesine sahip olabilir. Farklı kimlik bilgileri kullanmanız gerekiyorsa daha fazla ana kullanıcı oluşturun. Ardından, ana kullanıcıların bağlamlarının her birine farklı kimlik bilgilerini atayın ve bu kullanıcının Microsoft Entra belirtecini kullanarak ekleyin.

IError nesnesiyle eklenmiş uygulamanızın sorunlarını giderme

Uygulamanızda hata ayıklamak ve hatalarınızın nedenini daha iyi anlamak için JavaScript SDK hata olayı tarafından döndürülen IError nesnesini kullanın.

IError nesnesini aldıktan sonra, kullandığınız ekleme türüne uyan uygun yaygın hatalar tablosuna bakmanız gerekir. IError özelliklerini tablodaki özelliklerle karşılaştırın ve hatanın olası nedenlerini bulun.

Power BI kullanıcıları için ekleme sırasında oluşan tipik hatalar

İleti	Ayrıntılı İleti	Hata Kodu	Olası nedenler
Jeton Süresi Doldu	Erişim belirtecinin süresi doldu, yeni bir erişim belirteci ile yeniden gönderin	403	Süresi dolan belirteç
PowerBIEntityNotFound - Power BI Varlığı Bulunamadı	Rapor alma başarısız oldu	404	Yanlış Rapor Kimliği Rapor yok
Geçersiz parametreler	powerbiToken parametresi belirtilmedi	Uygulanamaz	Erişim belirteci sağlanmadı Rapor Kimliği verilmedi
Rapor Yüklemesi Başarısız	Başlatılamadı - Küme çözülemedi	403	Hatalı erişim belirteci Ekleme türü belirteç türüyle eşleşmiyor
PowerBİ Yetkilendirilmemiş İstisnası	Rapor alınamadı	401	Yanlış grup kimliği Yetkisiz grup
Token Süresi Doldu	Erişim belirtecinin süresi doldu, yeni bir erişim belirteci ile yeniden gönderin. Başlıklı bir rapor görseli işlenemedi: görsel başlığı	YOK	Sorgu verileri Süresi dolan belirteç
OpenConnectionError	Görsel görüntülenemez. Başlıklı bir rapor görseli işlenemedi: görsel başlığı	YOK	Kapasiteyle ilgili bir rapor oturumda açıkken kapasite askıya alındı veya silindi
KeşifKonteyner_ModelYüklenemedi_VarsayılanDetaylar	Bu raporla ilişkilendirilmiş model şeması yüklenemedi. Sunucuyla bağlantınız olduğundan emin olun ve yeniden deneyin.	Mevcut Değil	Kapasite duraklatıldı Kapasite silindi

Power BI kullanıcısı olmayan kullanıcılar için ekleme sırasında oluşan tipik hatalar (Ekleme Belirteci kullanılarak)

İleti	Ayrıntılı İleti	Hata Kodu	Olası nedenler
Token Süresi Doldu	Erişim belirtecinin süresi doldu, yeni bir erişim belirteci ile yeniden gönderin	403	Süresi dolan belirteç
Rapor Yüklenemedi	Rapor alma işlemi başarısız oldu	404	Yanlış Rapor Kimliği Rapor yok
Rapor yüklenemedi	Rapor alınamadı	403	Rapor Kimliği belirteçle eşleşmiyor
Rapor Yüklenemedi	Rapor alınması başarısız oldu	500	Sağlanan rapor kimliği bir GUID değil
Geçersiz parametreler	powerbiToken parametresi belirtilmedi	Uygun Değil	Erişim belirteci sağlanmadı Rapor Kimliği sağlanmadı
Rapor Yükleme Başarısız	Başlatma başarısız oldu - Küme çözümlenmesi başarısız oldu	403	Yanlış belirteç tipi veya geçersiz belirteç
PowerBINotAuthorizedException	Rapor alınamadı	401	Yanlış/yetkisiz grup kimliği
Token Süresi Doldu	Erişim belirtecinin süresi doldu, yeni bir erişim belirteci ile yeniden gönderin. adlı bir rapor görseli oluşturulamadı: görsel başlığı	YOK	Sorgu verileri Süresi dolan belirteç
OpenConnectionError	Görsel görüntülenemez. Başlıklı bir rapor görseli işlenemedi: görsel başlığı	YOK	Oturumda kapasiteyle ilgili bir rapor açıkken kapasite duraklatıldı veya silindi.
ModelYüklemeHatası_Konteyner_KullanımaHazırDeğil_Detaylar	Bu raporla ilişkilendirilmiş model şeması yüklenemedi. Sunucuyla bağlantınız olduğundan emin olun ve yeniden deneyin.	Uygulanamaz	Kapasite duraklatıldı Kapasite silindi

Rapor alma başarısız - hata 401 - kendiliğinden çözülecekler

kullanıcının verileri sahip olduğu senaryosunda, bazen kullanıcılar Power BI portalına eriştikten sonra kendiliğinden düzelen bir 401 hatası alabilir. 401 hatası meydana geldiğinde, uygulamada Kullanıcı izinlerini güncelleyinkısmında açıklandığı gibi RefreshUser İzinleri çağrısını ekleyin.

Anlamsal modeller

Kullanıcılarınızın verilerin hangi bölümünü görebileceğini yönetme

Anlam modeli için okuma izinlerine sahip olan tüm kullanıcılar şemanın tamamını (tablolar, sütunlar ve ölçüler) ve tüm verileri görebilir. Aynı anlam modelinde ham ve toplanmış verilere yönelik görüntüleme izinlerini ayrı ayrı denetleyemezsiniz.

Kullanıcılarınızın verilerin hangi bölümünü görüntüleyebileceğini yönetmek için aşağıdaki yöntemlerden birini kullanın:

• Power BIsatır düzeyi güvenlik (RLS) kullanarak satır düzeyi filtreleme.

• nesne düzeyi güvenlik (OLS) .

• Verileri farklı anlamsal modellere ayırın. Örneğin, yalnızca toplanan verileri içeren bir anlam modeli oluşturabilir ve kullanıcılarınıza yalnızca bu anlam modeline erişim verebilirsiniz.

İçerik işleme

Eklenmiş Power BI öğelerindeki (raporlar ve panolar gibi) işleme sorunlarını çözmek için bu bölümü gözden geçirin.

Power BI öğesinin Power BI hizmetinde yüklendiğini doğrulayın

Uygulama veyaekleme API'leri ile ilgili sorunları elemek için öğenin Power BI hizmetinde görüntülenebildiğini doğrulayın (powerbi.com).

Power BI ekli analiz oyun alanında Power BI öğesinin yüklendiğini doğrulayın

Uygulamanızla ilgili sorunları elemek için Power BI öğesinin Power BI tümleşik analiz oyun alanında görüntülenebildiğini doğrulayın.

Erişim belirtecinizin süresinin dolmadığını doğrulayın

Güvenlik amacıyla erişim belirteçlerinin (Microsoft Entra belirteci veya ekleme belirteci) kullanım ömrü sınırlıdır. Erişim belirtecinizi sürekli izlemeli ve gerekirse yenilemelisiniz. Daha fazla bilgi için bkz. Erişim belirtecini yenileme.

Performans

En iyi performansa sahip ekli içeriği elde etmek için Power BI tümleşik analiz en iyi yöntemlerini izlemenizi öneririz.

İlgili içerik

Power BI Embedded Sık Sorulan Sorular

Başka sorularınız mı var? Power BI Topluluğu'na sorun