Ekli uygulamanızla ilgili sorunları giderme

Bu makalede, Power BI'dan içerik ekleme sırasında sıkça karşılaşılan bazı sorunlar açıklanmaktadır.

Sorun giderme araçları

Fiddler ile İzleme

Fiddler, Telerik tarafından kullanıma sunulup HTTP trafiğini izleyen ücretsiz bir araçtır. İstemci makinesinde Power BI API'lerini kullanarak trafiği görebilirsiniz. Bu araç hataları ve diğer ilgili bilgileri gösterebilir.

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

F12 tarayıcınızda geliştirici penceresini açar. Bu araç, ağ trafiğini ve diğer bilgileri görüntüleme olanağı sağlar.

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

Bu kod parçacığı, HTTP özel durumundan hata ayrıntılarını ayıklama işleminin nasıl yapılacağını göstermektedir:

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

Sorun giderme işlemi için İstek Kimliklerinin ve hata ayrıntılarının günlüğe kaydedilmesini öneriyoruz. Microsoft destek bölümüyle iletişime geçerken İstek Kimliğini belirtin.

Uygulama kaydı

Uygulama kaydı hatası

Azure portal veya Power BI uygulaması kayıt sayfasındaki hata iletileri, yetersiz ayrıcalıktan bahsedecektir. Bir uygulama kaydı için Azure AD kiracısında yönetici olmanız ya da yönetici olmayan kullanıcılar için uygulama kayıtlarının etkinleştirilmiş olması gerekir.

Power BI Hizmeti yeni bir Uygulama kaydı sırasında Azure portalında görünmüyor

En az bir kullanıcının Power BI'a kaydolmuş olması gerekir. API listesinde Power BI Hizmetini görmüyorsanız hiçbir kullanıcı Power BI'a kaydolmamış demektir.

Uygulama nesnesi KIMLIĞI ve asıl nesne KIMLIĞI arasındaki fark nedir?

Bir Azure AD uygulaması kaydettiğinizde, nesne kimliği adlı iki parametre vardır. Bu bölümde her parametrenin amacı ve nasıl alınacağı açıklanmaktadır.

REST API

401 kodunu döndüren API çağrısı

Daha fazla araştırmak için Fiddler ile yakalama gerekebilir. Azure AD'de kayıtlı uygulama için gerekli izin kapsamı eksik olabilir. Azure portalındaki Azure AD için uygulama kaydında gerekli kapsamın mevcut olduğunu doğrulayın.

403 kodunu döndüren API çağrısı

Daha fazla araştırmak için Fiddler ile yakalama gerekebilir. 403 hatasının birkaç nedeni olabilir.

• Kullanıcı, paylaşılan bir kapasitede oluşturulabilecek ekleme belirteci miktarını aşmıştır. Ekleme belirteçleri oluşturmak için Azure kapasitesi satın alın ve çalışma alanını bu kapasiteye atayın. Bkz. Azure portalında Power BI Embedded kapasitesi oluşturma.
• Azure AD kimlik doğrulama belirtecinin kullanım süresi dolmuştur.
• Kimliği doğrulanmış kullanıcı, grubun (çalışma alanı) üyesi değildir.
• Kimliği doğrulanmış kullanıcı, grubun (çalışma alanı) yöneticisi değildir.
• Kimliği doğrulanmış kullanıcının izinleri yoktur. İzinler refreshUserPermissions API'si kullanılarak güncelleştirilebilir
• Yetkilendirme üst bilgisi doğru listelenmemiş olabilir. Yazım hatası olmadığından emin olun.

GenerateToken çağrılmadan önce uygulamanın arka ucunun kimlik doğrulaması belirtecini yenilemesi gerekebilir. Daha fazla bilgi için bkz. erişim belirtecini yenileme.

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

API 'Ler içeri ve dışarı aktarma API 'Leri kullanılırken zaman aşımı özel durumları nasıl düzeltilir?

bir Power BI REST API isteği gönderdiğinizde, bu, kiracının verilerini içermeyen bir kümeye gelebilir. Böyle durumlarda, isteğin yeniden yönlendirilmesi zaman aşımı nedeniyle başarısız olabilir.

Zaman aşımı özel durumunu onarmak için, isteği preferClientRouting olarak ayarlanan parametre ile yeniden gönderebilirsiniz true . isteğiniz yanlış kümeye ulaştığında, Power BI hizmeti bir 307 geçici yeniden yönlendirme HTTP yanıtı döndürür. Bu gibi durumlarda, isteğinizi yanıt https konum üstbilgisinde belirtilen yeni adrese yeniden yönlendirmeniz gerekir.

Kimlik Doğrulama

Kimlik doğrulaması şu hatayla başarısız oldu: AADSTS90002: Kiracı 'yetkilendirmesi' bulunamadı

İleti günlüğünde hata: invalid_request, error_description: AADSTS90002: Kiracı 'yetkilendirmesi' bulunamadı gibi iletiler alırsanız, bunun nedeni ADAL 4.x'in yetki url'si olarak "https://login.microsoftonline.com/{Tenant}/oauth2/authorize/" url'sini desteklememesidir.

Bu sorunu çözmek için yetki url'nizin sonundaki "oauth2/authorize/" bölümünü kırpmalısınız. Bu konuda başvuru için Power BI Geliştirici Örnekleri'ne bakın.

ADAL 4.x sürüm notlarında Daha İyi Yetkili doğrulaması bölümünü gözden geçirin.

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

(AADSTS70002: Kimlik bilgileri doğrulanırken hata oluştu. AADSTS50053: Hatalı bir Kullanıcı Kimliği veya parolayla çok fazla sayıda oturum açma denemesi yaptınız)

Power BI Embedded kullanıyorsanız ve Azure AD doğrudan kimlik doğrulamasını kullanıyorsanız ve hata: unauthorized_client, error_description: AADSTS70002: kimlik bilgileri doğrulanırken hata oluştu. AADSTS50053: doğrudan kimlik doğrulama artık kullanımda olmadığından, yanlış bir kullanıcı KIMLIĞI veya parolasıyla çok fazla kez oturum açmaya çalıştınız.

Kapsam olarak kuruluşun veya bir hizmet sorumlusunun belirlendiği bir Azure AD İlkesi kullanarak bu işlemi geri almanın bir yolu vardır.

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

Bu ilkeyi oluşturmak için, ilkeyi oluşturduğunuz ve atadığınız dizinin Genel Yöneticisi olmanız gerekir. Burada, bu uygulama için ilkeyi oluşturmaya ve SP'ye atamaya yönelik örnek bir betik verilmiştir:

1. Azure AD Preview PowerShell Modülü'nü yükleyin.

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

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 

İlkeyi atadığınızda test etmeden önce yayılması için 15-20 saniye kadar bekleyin.

Etkin kimlik sağlanırken belirteç oluşturulamıyor

GenerateToken, etkin kimlik sağlandığında birkaç nedenden dolayı başarısız olabilir.

• Veri kümesi etkin kimliği desteklemiyor
• Kullanıcı adı sağlanmadı
• Rol sağlanmadı
• DatasetId sağlanmadı
• Kullanıcı doğru izinlere sahip değil

Hangisi olduğunu belirlemek için aşağıdaki adımları deneyin.

• Veri kümesi al komutunu yürütün. IsEffectiveIdentityRequired özelliği doğru mu?
• Kullanıcı adı her EffectiveIdentity için zorunludur.
• IsEffectiveIdentityRolesRequired doğruysa Rol gereklidir.
• DatasetId her EffectiveIdentity için zorunludur.
• Analysis Services için ana kullanıcı bir ağ geçidi yöneticisi olmak zorundadır.

AADSTS90094: Verme işlemi için yönetici izni gerekiyor

Belirtiler:
Yönetici olmayan bir kullanıcı onay vermek için uygulamada ilk kez oturum açmayı deniyorsa aşağıdaki hatalardan birini alır:

• Onay Testi'nin, kuruluşunuzdaki kaynaklara erişim için yalnızca yöneticinin verebileceği izne ihtiyacı vardır. Kullanabilmek için önce yöneticiden bu uygulamaya izin vermesini isteyin.

• AADSTS90094: Verme işlemi için yönetici izni gerekiyor.

  

Yönetici oturum açabilir ve başarılı bir şekilde onay verebilir.

Kök nedeni:
Kiracı için kullanıcı onayı devre dışı bırakıldı.

Çeşitli düzeltmeler yapılabilir:

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

1. Azure portalda "Azure Active Directory" => "Kullanıcılar ve gruplar" => "Kullanıcı ayarları" bölümüne gidin

2. "Kullanıcılar, uygulamalara kendileri adına şirket verilerine erişme izni verebilir" ayarını etkinleştirin ve değişiklikleri kaydedin

   

Kiracının tamamı için veya belirli bir kullanıcı için bir yönetici tarafından uygulamaya izin verme.

CS1061 hatası

"'AuthenticationContext' bir 'AcquireToken' tanımı içermiyor ve 'AuthenticationContext' türünde bir ilk bağımsız değişken kabul eden erişilebilir 'AcquireToken' genişletme metodu bulunamadı (bir kullanma yönergeniz veya derleme başvurunuz eksik olabilir mi?)" hatasıyla karşılaşırsanız Microsoft.IdentityModel.Clients.ActiveDirectory'yi indirin.

Farklı bir kiracı için Azure AD belirteci (Konuk Kullanıcı)

Kuruluşunuza eklediğiniz zaman, Azure AD Konuk kullanıcılarının içeriğinize erişmesine izin vermek için, PARAMETRESINDEKI Kiracı kimliğini belirtmeniz gerekir authorityUri .

• Kuruluşunuzun kiracısında kimlik doğrulaması için URL:

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

• Konuk Azure AD kullanıcısının kimliğini doğrulamak için URL:

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

kiracı kimliğinizi bulmak için Microsoft Azure AD kiracı kimliğini ve birincil etki alanı adını bul' daki yönergeleri kullanabilirsiniz.

daha fazla bilgi için bkz. nasıl yapılır: çok kiracılı uygulama modelini kullanarak tüm Azure Active Directory kullanıcıları oturum açma.

Veri kaynakları

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

Bir veri kaynağında, bir ana kullanıcı için tek kimlik bilgisi kümesi olabilir. Farklı kimlik bilgileri kullanmanız gerekiyorsa ek ana kullanıcılar oluşturun. Ardından, her ana kullanıcı bağlamında farklı kimlik bilgileri atayın ve kullanıcının Azure AD belirtecini kullanarak ekleyin.

IError nesnesini kullanarak ekli uygulamanızla ilgili sorunları giderme

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

IError nesnesine ulaştıktan sonra kullandığınız ekleme türüne uygun olan sık karşılaşılan hataları incelemeniz gerekir. IError özelliklerini aşağıdaki tabloda bulunan değerlerle karşılaştırarak arızanın olası nedenlerini bulabilirsiniz.

Power BI kullanıcıları için sık karşılaşılan ekleme hataları

Power BI kullanıcısı olmayanlar (Erişim Belirteci kullananlar) için ekleme sırasında karşılaşılan hatalar

Veri kümeleri

Kullanıcılarının hangi veri bölümünü göreceğini yönetme

Bir veri kümesi için okuma izni olan tüm kullanıcılar şemanın tamamını (tablolar, sütunlar ve ölçüler) ve tüm verileri görebilir. Aynı veri kümesinde ham ve toplu veriler için görüntüleme izinlerini ayrı ayrı kontrolamazsınız.

Kullanıcılarının görüntüleyecekleri verilerin hangi bölümünü yöneteceklerini yönetmek için şu yöntemlerden birini kullanın:

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

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

• Verileri farklı veri kümelerine ayırma. Örneğin, yalnızca toplu verileri içeren bir veri kümesi oluşturabilir ve kullanıcılarınıza yalnızca bu veri kümesine erişim veebilirsiniz.

İçerik işleme

Ekli pano öğelerinde (raporlar Power BI panolar gibi) işleme sorunlarını çözmek için bu bölümü gözden geçirebilirsiniz.

Uygulama öğesinin Power BI hizmette Power BI doğrulayın

Uygulama veya ekleme API'leri ile ilgili sorunları e-posta ile e-posta ile doğrulamak için, öğenin Power BI hizmette (powerbi.com).

Power BI ekli analiz oyun alanına Power BI doğrulayın

Uygulamanıza ilişkin sorunları elerken, Power BI ekli analiz oyun alanında Power BI doğrulayın.

Erişim belirtecin süresinin dolmadan önce

Güvenlik nedeniyle erişim belirteçleri (Azure AD belirteci veya ekleme belirteci) sınırlı bir yaşam süresine sahip olur. Erişim belirtecini sürekli olarak izlemeli ve gerekirse yenilemelisiniz. Daha fazla bilgi için bkz. Erişim belirteci yenileme.

Performans

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

Ekleme kurulum aracı

Bir örnek uygulamayı hızlıca indirmek için Katıştırma kurulum aracını inceleyebilirsiniz. Daha sonra uygulamanızı örnekle karşılaştırabilirsiniz.

Önkoşullar

Katıştırma kurulum aracını kullanmadan önce tüm uygun önkoşulları yerine getirdiğinizi doğrulayın. Bir Power BI Pro hesabı ve bir Microsoft Azure aboneliği gerekir.

• Power BI Pro’ya kaydolmadıysanız başlamadan önce ücretsiz deneme için kaydolun.
• Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Azure Active Directory kiracınız ayarlanmış olmalıdır.
• Visual Studio yüklü olmalıdır (sürüm 2013 veya üzeri).

Sık Karşılaşılan Sorunlar

Ekleme kurulum aracı ile test ederken karşılaşabileceğiniz bazı yaygın sorunlar şunlardır:

Embed for your customers örnek uygulamasını kullanma

Embed for your customers deneyimi ile çalışıyorsanız PowerBI-Developer-Samples.zip dosyasını kaydedin ve sıkıştırmasını açın. Ardından PowerBI-Developer-Samples-master\App Owns Data klasörünü açın ve PowerBIEmbedded_AppOwnsData.sln dosyasını çalıştırın.

İzin ver’i seçtiğinizde (İzin verme adımı) aşağıdaki hatayı alırsınız:

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

Bunun çözümü, açılır pencereyi kapatmak ve birkaç saniye bekleyip tekrar denemektir. Bu eylemi birkaç kez yinelemeniz gerekebilir. Uygulama kayıt işlemini tamamlama ile dış API’lerin kullanımına sunulması arasındaki zaman aralığı bu soruna neden olur.

Örnek uygulama çalıştırılırken aşağıdaki hata iletisi görüntülenir:

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

Örnek uygulamaya eklenmeyen tek değer kullanıcı parolanız olduğundan bu hata oluşur. Çözümde Web.config dosyasını açın ve pbiPassword alanını kullanıcınızın parolasıyla doldurun.

Şu hatayı alırsanız: AADSTS50079: Kullanıcının çok faktörlü kimlik doğrulaması kullanması gereklidir.

MFA özelliği etkin olmayan bir AAD hesabı kullanılması gerekir.

Kuruluşunuzun örnek uygulamasında Embed kullanma

Embed for your organization deneyimi ile çalışıyorsanız PowerBI-Developer-Samples.zip dosyasını kaydedin ve sıkıştırmasını açın. Ardından PowerBI-Developer-Samples-master\User Owns Data\integrate-report-web-app klasörünü açın ve pbi-saas-embed-report.sln dosyasını çalıştırın.

Embed for your organization örnek uygulamasını çalıştırdığınızda aşağıdaki hatayı alırsınız:

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

Bu hatanın nedeni, web sunucusu uygulaması için belirtilen yeniden yönlendirme URL’sinin örneğe ait URL’den farklı olmasıdır. Örnek uygulamayı kaydetmek istiyorsanız yeniden yönlendirme URL’si olarak https://localhost:13526/ kullanın.

Kayıtlı uygulamayı düzenlemek isterseniz, uygulamanın web API’lerine erişim sağlayabilmesi için Azure AD kayıtlı uygulamasını güncelleştirme hakkında bilgi edinin.

Power BI kullanıcı profilinizi veya verilerinizi düzenlemek istiyorsanız, Power BI verilerinizi düzenleme hakkında bilgi edinin.

AADSTS50079 hatasını alırsanız: Kullanıcının çok faktörlü kimlik doğrulaması kullanması gereklidir.

MFA özelliği etkin olmayan bir AAD hesabı kullanılması gerekir.

Daha fazla bilgi için lütfen bkz. Power BI Embedded SSS.

Başka bir sorunuz mu var? Power BI Topluluğu'na başvurun

Daha fazla yardıma ihtiyacınız varsa destek ekibine ulaşın veya Azure portal aracılığıyla bir destek bileti oluşturun ve karşılaştığınız hata iletilerini belirtin.

Sonraki adımlar

Daha fazla bilgi için bkz. SSS.

Başka bir sorunuz mu var? Power BI Topluluğu'na başvurun