Power BI Desktop proje raporu klasörü

Önemli

Power BI Desktop projeleri şu anda önizleme aşamasındadır.

Bu makalede, Bir Microsoft Power BI Desktop projesinin Rapor klasöründeki dosyalar ve alt klasörler açıklanmaktadır. Buradaki dosyalar ve alt klasörler bir Power BI raporunu temsil eder. Projenize bağlı olarak rapor klasörü şunları içerebilir:

• .pbi\
  • localSettings.json
• CustomVisuals\
• StaticResources\
  • RegisteredResources\
• semanticModelDiagramLayout.json
• definition.pbir¹
• mobileState.json
• report.json²
• tanım\ klasör³
• .platform

1 - Bu dosya gereklidir.
2 - Bu dosya PBIR-Legacy biçime kaydedilirken gereklidir.
3 - Bu dosya PBIR biçimine kaydedilirken gereklidir.

Her proje raporu klasörü burada açıklanan tüm dosyaları ve alt klasörleri içermez.

Rapor dosyaları

.pbi\localSettings.jsaçık

Yalnızca geçerli kullanıcı ve yerel bilgisayar için geçerli olan rapor ayarlarını içerir. GitIgnore veya diğer kaynak denetimi dışlamalarına dahil edilmelidir. Varsayılan olarak Git bu dosyayı yoksayar.

Daha fazla bilgi için localSettings.json şema belgesine bakın.

CustomVisuals\

Rapordaki özel görseller için meta verileri içeren bir alt klasör. Power BI üç tür özel görseli destekler:

• Kurumsal görselleştirme - Kuruluşlar, özel görselleri onaylayıp kendi kuruluşları için Power BI'a dağıtabilir. Daha fazla bilgi edinmek için bkz. Kuruluş deposu.
• AppSource Power BI görselleri - "Genel özel görseller" olarak da bilinir. Bu görseller Microsoft AppSource'tan edinilebilir. Rapor geliştiricileri bu görselleri doğrudan Power BI Desktop'tan yükleyebilir.
• Özel görsel dosyaları - "Özel kişisel görseller" olarak da bilinir. Dosyalar bir pbiviz paketi yüklenerek rapora eklenebilir.

CustomVisuals klasörüne yalnızca özel özel görseller yüklenir. AppSource ve Kuruluş görselleri Power BI Desktop tarafından otomatik olarak yüklenir.

RegisteredResources\

Rapora özgü kaynak dosyalarını içeren ve özel temalar, resimler ve özel görseller (pbiviz dosyaları) gibi kullanıcı tarafından yüklenen bir alt klasör.

Buradaki dosyalardan geliştiriciler sorumludur ve değişiklikler desteklenir. Örneğin, bir dosyayı değiştirebilirsiniz ve Power BI Desktop yeniden başlatıldıktan sonra yeni dosya rapora yüklenir. Bu klasör, aşağıdakiler gibi bazı yararlı senaryoların engellemesini kaldırabilir:

• Genel şemayı kullanarak Power BI Desktop dışında özel temalar yazma.
• Birden çok rapordaki kaynak dosyasını değiştirerek toplu iş değişiklikleri uygulama. Örneğin, kurumsal özel temayı değiştirebilir, açık ve koyu temalar arasında değişiklik yapabilir ve logo görüntülerini değiştirebilirsiniz.

Her kaynak dosyasının, önizleme sırasında düzenlemeyi desteklemeyen report.json dosyasında karşılık gelen bir girdisi olmalıdır. RegisteredResources dosyalarındaki düzenlemeler yalnızca Power BI Desktop'ın kaynağı report.json kaydetmesine neden olan önceden yüklenmiş kaynaklar için desteklenir.

semanticModelDiagramLayout.json

Raporla ilişkili anlam modelinin yapısını açıklayan veri modeli diyagramlarını içerir. Önizleme sırasında bu dosya dış düzenlemeyi desteklemez.

tanım.pbir

Bir raporun ve temel ayarların genel tanımını içerir. Bu dosya, rapor tarafından kullanılan anlam modeline başvuruyu da barındırıyor. Power BI Desktop, raporun PBIP dosyasından açılmasıyla aynı şekilde bir PBIR dosyasını doğrudan açabilir. PBIR dosyasının açılması, byPath kullanılarak göreli bir başvuru olduğunda semantik modeli de açar.

Örnek tanım.pbir:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    }    
  }
}

Tanımı, raporda kullanılan anlam modeline başvuran özelliğini içerir datasetReference . Referans aşağıdakilerden biri olabilir:

byPath - Hedef anlam modeli klasörünün göreli yolunu belirtir. Mutlak yollar desteklenmez. Klasör ayırıcısı olarak eğik çizgi (/) kullanılır. Power BI Desktop kullanıldığında, anlam modelini tam düzenleme modunda da açar.

byConnection - Bağlantı dizesi kullanarak Fabric çalışma alanındaki bir semantik modele bağlantıyı belirtir. Bir byConnection başvuru kullanıldığında Power BI Desktop semantik modeli düzenleme modunda açmaz.

Sürüm 2

byConnection başvuru kullanılarak, aşağıdaki özellikler belirtilmelidir.

Mülk	Açıklama
bağlantı dizesi	Bir Fabric çalışma alanında anlam modeline başvuran bağlantı dizesi.

Örnek byConnection kullanımı:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "Data Source=\"powerbi://api.powerbi.com/v1.0/myorg/[WorkpaceName]\";initial catalog=[SemanticModelName];access mode=readonly;integrated security=ClaimsToken;semanticmodelid=[SemanticModelId]"
    }
  }
}

Fabric REST API'sini kullanarak bir rapor dağıtırken yalnızca semanticmodelid özelliğini belirtmeniz gerekir. Örneğin:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "semanticmodelid=[SemanticModelId]"
    }
  }
}

Sürüm 1

byConnection başvuru kullanılarak, aşağıdaki özellikler belirtilmelidir.

Mülk	Açıklama
bağlantı dizesi	Bir Fabric çalışma alanında anlam modeline başvuran bağlantı dizesi.
pbiModelVeritabanıAdı	Uzak anlam modeli kimliği.
bağlantıTürü	Bağlantı türü. Hizmet uzaktan anlam modeli için bu değer pbiServiceXmlaStyleLive olmalıdır.
pbiModelVirtualServerName	değerine sahip olması gereken bir iç özellik. sobe_wowvirtualserver
pbiServiceModelId	değerine sahip olması gereken bir iç özellik. null
isim	değerine sahip olması gereken bir iç özellik. EntityDataSource

Örnek byConnection kullanımı:

{
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/1.0.0/schema.json",
    "version": "4.0",
    "datasetReference": {  
      "byConnection": {
        "connectionString": "Data Source=powerbi://api.powerbi.com/v1.0/myorg/[WorkpaceName];Initial Catalog=[SemanticModelName];Integrated Security=ClaimsToken",
        "pbiServiceModelId": null,
        "pbiModelVirtualServerName": "sobe_wowvirtualserver",
        "pbiModelDatabaseName": "[Semantic Model Id]",
        "connectionType": "pbiServiceXmlaStyleLive",
        "name": "EntityDataSource"
      }
  }
}

Önemli

Fabric REST API kullanarak bir rapor dağıtırken byConnection başvurular kullanmalısınız. Bu, DirectQuery gibi bir anlam modelinin depolama moduyla karıştırılmamalıdır. datasetReference rapordaki yalnızca raporun hangi semantik modele bağlandığını belirtir, modelin verilerine nasıl depolandığını veya verilerine nasıl eriştiğini tanımlamaz.

Birden çok *.pbir dosyası

Anlamsal model ve rapor aynı çalışma alanını paylaştığında, Doku Git Tümleştirmesi her zaman anlam modeline bir byPath başvuruyla tanımları dışarı aktarır. Raporu canlı bağlantıda açmaya zorlamak istiyorsanız (örneğin, rapor düzeyinde ölçülerle çalışmak için), biri byPath bağlantısına ve diğeri byConnection bağlantısına sahip olan dosyalar gibi birden çok *.pbir dosyaya sahip olabilirsiniz. Doku Git Tümleştirmesi yalnızca definition.pbir dosyasını işler ve diğer tüm *.pbir dosyalarını yoksayar. Ancak, bu dosyalar aynı depoda birlikte bulunabilir.

  ├── definition\
  ├── StaticResources\
  ├── .platform
  ├── definition-liveConnect.pbir
  └── definition.pbir

Dosya definition.pbir , 'version' özelliği aracılığıyla desteklenen rapor tanımı biçimlerini de belirtir.

Sürüm	Desteklenen biçimler
1.0	Rapor tanımı, report.json dosyasında PBIR-Legacy olarak depolanmalıdır.
4.0 veya üzeri	Rapor tanımı PBIR-Legacy (report.json dosyası) veya PBIR (\definition klasörü) olarak depolanabilir.

Daha fazla bilgi için definition.pbir şema belgesine bakın.

mobileState.json

Mobil cihazda işlenirken rapor görünümü ve davranış ayarlarını içerir. Bu dosya dış düzenlemeyi desteklemiyor.

report.json

Bu dosya, Power BI Raporu Eski biçiminde (PBIR-Legacy) rapor tanımını içerir ve dış düzenlemeyi desteklemez.

tanım\ klasör

Bu klasör yalnızca Power BI projesi Power BI gelişmiş rapor biçimi (PBIR) kullanılarak kaydedildiğinde kullanılabilir. report.json dosyasının yerini alır.

.platform

Fabric ögeleri ile Git arasındaki bağlantıyı kurmak ve sürdürmek için hayati öneme sahip özellikleri barındıran Fabric platform dosyası.

Daha fazla bilgi edinmek için bkz. Git tümleştirmesi otomatik olarak oluşturulan sistem dosyaları.

PBIR biçimi

Önemli

Önizleme aşamasındaki tüm PBIR sınırlamalarını göz önünde bulundurun.

Power BI Proje dosyalarınızı (PBIP) Power BI Gelişmiş Rapor Biçimi (PBIR) kullanarak kaydetmek, düzgün biçimlendirilmiş JSON dosyalarını kullanarak değişiklik izleme ve birleştirme çakışması çözümünü büyük ölçüde geliştirir.

Her sayfa, görsel, yer işareti vb. bir klasör yapısı içinde ayrı, ayrı bir dosya halinde düzenlenir. Bu biçim, kod geliştirme çakışması çözümlemesi için idealdir.

PBIR-Legacy (report.json) sürümünden farklı olarak PBIR, Power BI dışı uygulamalardan yapılan değişiklikleri destekleyen genel olarak belgelenmiş bir biçimdir. Her dosyanın yalnızca dosyayı belgeleyen değil, aynı zamanda Visual Studio Code gibi kod düzenleyicilerinin düzenleme sırasında söz dizimi doğrulaması gerçekleştirmesine olanak tanıyan genel bir JSON şeması vardır.

PBIR ile kullanılabilen olası senaryolardan bazıları şunlardır:

• Raporlar arasında sayfaları/görselleri/yer işaretlerini kopyalayın.
• Görsel dosyalarını kopyalayıp yapıştırarak tüm sayfalarda bir dizi görselin tutarlılığını sağlayın.
• Birden çok rapor dosyasında kolay bulma ve değiştirme.
• Tüm görsellerde betik kullanarak toplu düzenleme yapın (örn. görsel düzeyi filtrelerini gizleme)

PBIR biçimi önizleme özelliğini etkinleştirme

PBIR kullanarak Power BI raporları olarak kaydetme işlemi şu anda önizleme aşamasındadır. Bunu kullanmadan önce Power BI Desktop önizleme özelliklerinde etkinleştirin:

Power BI Project (PBIP) dosyaları için:

1. Dosya > Seçenekleri ve ayarları > Seçenekler > Önizleme özellikleri'ne gidin.
2. Gelişmiş meta veri biçimi (PBIR) kullanarak raporları depola onay kutusunu seçin.

PBIX dosyaları için:

1. Dosya > Seçenekleri ve ayarları > Seçenekler > Önizleme özellikleri'ne gidin.
2. Gelişmiş meta veri biçimi (PBIR) kullanarak PBIR raporlarını depola onay kutusunu seçin.

PBIX için PBIR'in etkinleştirilmesi, PBIR biçiminin yalnızca Power BI Project (PBIP) dosyalarına değil PBIX dosyalarına da kaydedilmesini sağlar.

PBIR kullanarak proje olarak kaydetme

PBIR Önizleme özelliği etkinleştirildiğinde, bir projeyi kaydettiğinizde raporunuz rapor klasörünün içindeki \definition adlı bir klasöre kaydedilir:

PBIR klasör yapısı hakkında daha fazla bilgi edinin.

Mevcut raporu PBIR'e dönüştürme

PBIR-Legacy biçimini kullanan bir PBIP'niz zaten varsa, bunu aşağıdaki gibi PBIR'e dönüştürebilirsiniz:

1. Power BI Desktop'ta PBIP'yi açın.

2. Önizleme Özelliğinin etkinleştirildiğinden emin olun.

3. Projeyi kaydedin. PBIR'a yükseltmenizi isteyen bir istem görüntülenir.

4. Yükselt'i seçin.

   

   Önemli

   PBIR'a yükselttikten sonra kullanıcı arabiriminden PBIR-Legacy geri döndüremezsiniz. PBIR-Legacy'ye geri dönmek için PBIP dosyalarınızın bir kopyasını kaydedin.

   Power BI Desktop, PBIR'e yükseltmeden önce raporun yedeğini otomatik olarak oluşturur. Bu yedekleme, aşağıdaki konumlardan birinde 30 gün boyunca saklanır:

   • Microsoft Store sürümü: %USERPROFILE%\Microsoft\Power BI Desktop Store App\TempSaves\Backups
   • Yürütülebilir yükleyici sürümü: %USERPROFILE%\AppData\Local\Microsoft\Power BI Desktop\TempSaves\Backups

Var olan PBIR-Legacy dosyası (report.json), raporun PBIR gösterimini içeren bir \definition klasörüyle değiştirilir.

Geçerli biçimi koru seçeneğini belirlerseniz, Masaüstü bir daha yükseltme istemeyecektir.

Hizmette PBIR

Hizmette oluşturulan yeni raporlar varsayılan olarak PBIR biçimini kullanır. Düzenlenen mevcut raporlar da otomatik olarak PBIR biçimine dönüştürülür.

Genel Önizleme sırasında, yöneticiler kiracı ayarını devre dışı bırakarak PBIR'i geri çevirmeyi seçebilir: Raporları Power BI gelişmiş meta veri biçiminde (PBIR) otomatik olarak dönüştürün ve depolayın.

Önemli

• PBIR Genel Kullanılabilirliğe (GA) ulaştığında, desteklenen tek rapor biçimi olur ve dönüştürme zorunlu olur. Müşterilerin GA öncesinde bu geçişe hazırlık yapmaya başlamalarını öneririz.
• Power BI hizmetindeki PBIR henüz kiracınızda kullanılamayabilir. Kiracı ayarı öncelikle özellik tam olarak etkinleştirilmeden önce geri çevirmenizi sağlamak için vardır. En son güncelleştirmeler için Power BI Blogunu ziyaret edin.

PBIR-Legacy'ye geri yükleme işlemi

Hizmette bir rapor PBIR'e dönüştürüldüğünde, PBIR-Legacy biçimindeki bir yedek kopya otomatik olarak oluşturulur ve 28 gün boyunca saklanır. Çalışma alanından Rapor ayarlarını açıp PBIR-Legacy olarak geri yükle'yi seçerek raporu PBIR-Legacy sürümüne geri yükleyebilirsiniz.

Geri yüklenen bir rapor otomatik olarak PBIR'a geri dönüştürülmeyecek. Otomatik dönüştürmeyi yeniden etkinleştirmek için rapor ayarlarını açın ve PBIR'ı Etkinleştir'i seçin.

Önemli

PBIR-Eski hizmet yedeklemesi yalnızca doğrudan Power BI hizmetinde yükseltilen raporlar için oluşturulur. Raporunuzu Power BI Desktop'tan yayımlayarak veya PBIX dosyasını karşıya yükleyerek yükseltiyorsanız ve PBIR-Legacy sürümünü geri yüklemeniz gerekiyorsa, Power BI Desktop tarafından oluşturulan yedeklemeyi kullanın.

PBIR klasörü ve dosyaları

Rapor tanımı aşağıdaki yapıya definition\ sahip klasörün içinde depolanır:

├── bookmarks\
│   ├── [bookmarkName].bookmark.json
|   └── bookmarks.json
├── pages\
│   ├── [pageName]\
│   |   ├── \visuals
|   │   |   ├── [visualName]\
|   |   │   │   |── mobile.json
|   |   |   └   └── visual.json
|   |   └── page.json
|   └── pages.json
├── version.json
├── reportExtensions.json
└── report.json

Dosya/Klasör	Zorunlu	Açıklama
Yer imleri	Hayır	Raporun tüm yer işareti dosyalarının bulunduğu klasör.
── [bookmarkName].bookmark.json	Hayır	Yer imi meta verileri; hedef görseller ve filtreler gibi. Şemada daha fazla bilgi.
── bookmarks.json	Hayır	Yer işareti sırası ve gruplar gibi bilgiler içeren yer işaretleri meta verileri. Şemada daha fazla bilgi.
Sayfalar	Evet	Raporun tüm sayfalarını tutan klasör.
── [pageName]\	Evet	Sayfa başına bir klasör.
──── görseller\	Hayır	Sayfanın tüm görsellerini barındıran klasör.
────── [visualName]\	Hayır	Görsel başına bir klasör.
──────── mobile.json	Hayır	Mobil konum ve biçimlendirme gibi görsel mobil düzen meta verileri. Şemada daha fazla bilgi.
──────── visual.json	Evet	Konum ve biçimlendirme, sorgu gibi görsel meta veriler. Şemada daha fazla bilgi.
──── page.json	Evet	Sayfa düzeyi filtreleri ve biçimlendirme gibi sayfa meta verileri. Şemada daha fazla bilgi.
── pages.json	Hayır	Sayfa sırası ve etkin sayfa gibi sayfa meta verileri. Şemada daha fazla bilgi.
version.json	Evet	PBIR dosya sürümü, diğer faktörler arasında, yüklenecek gerekli dosyaları belirler. Şemada daha fazla bilgi
reportExtensions.json	Hayır	Rapor uzantıları, örneğin rapor düzeyi ölçümleri. Şemada daha fazla bilgi
report.json	Evet	Rapor düzeyi filtreleri ve biçimlendirme gibi rapor meta verileri. Şemada daha fazla bilgi

Önemli

visual.json veya bookmarks.jsongibi bazı rapor meta verileri dosyaları, anlam modelinizdeki veri değerleriyle kaydedilebilir. Örneğin, 'Şirket' = 'Contoso' alanı için bir görsele filtre uygularsanız, 'Contoso' değeri meta verilerin bir parçası olarak kalır. Bu, dilimleyici seçimleri, matris özel sütun genişliği ve belirli seriler için biçimlendirme gibi diğer yapılandırmalar için de geçerlidir.

PBIR adlandırma kuralı

Önceki tablodaki köşeli ayraçların ([]) içindeki tüm adlar varsayılan adlandırma kuralını izler, ancak daha kolay adlarla yeniden adlandırılabilir. Varsayılan olarak sayfalar, görseller ve yer işaretleri, rapor nesne adlarını dosya veya klasör adı olarak kullanır. Bu nesne adları başlangıçta '90c2e07d8e84e7d5c026' gibi 20 karakterlik benzersiz bir tanımlayıcıdır.

Her bir JSON dosyasında 'name' özelliğinin yeniden adlandırılması desteklenir, ancak raporun içinde ve dışında dış referansları bozabilir. Nesne adı ve/veya dosya/klasör adı bir veya daha fazla sözcük karakteri (harf, basamak, alt çizgi) veya kısa çizgiden oluşmalıdır.

PBIR dosyalarını veya klasörlerini yeniden adlandırdıktan sonra Power BI Desktop'ı yeniden başlatmanız gerekir. Yeniden başlatıldıktan sonra, Power BI Desktop kaydederken özgün dosya veya klasör adlarını korur.

Rapor nesnesi adını kopyalama

Rapordaki her nesne ayrı bir klasöre veya dosyaya kaydedilir, ancak klasörün adı her zaman belirgin değildir. Bunu kolaylaştırmak için, herhangi bir rapor nesnesi adının (sayfalar, görseller, yer işaretleri ve filtreler dahil) adını doğrudan Power BI'dan panonuza kopyalayabilirsiniz.

Masaüstünden

1. Dosya > Seçenekleri ve ayarları > Rapor ayarları > Rapor nesneleri'ne gidin ve Rapor nesnelerine sağ tıklandığında nesne adlarını kopyala ayarını etkinleştirin. Bu işlemin yalnızca bir kez yapılması gerekir.

   

2. Herhangi bir rapor nesnesine sağ tıklayın ve Nesne adını kopyala'yı seçin.

   

Nesne adı panonuza kopyalandıysa, nesne adını PBIR klasöründe bulmak veya tanımlamak için bunu Windows Gezgini'nin veya Visual Studio Code'un arama çubuğuna kolayca girebilirsiniz.

Hizmetten

1. Rapor nesnelerine sağ tıklandığında nesne adlarını kopyala ayarını etkinleştirin. Bu işlemin yalnızca bir kez yapılması gerekir. Her rapor için etkinleştirmeniz gerekmez.

   

2. Raporu düzenlerken herhangi bir rapor nesnesine sağ tıklayın ve Nesne adını kopyala'yı seçin.

   

Kopyalanan nesneyi, PBIR dosya biçiminde dosya adlarını tanımlamak veya DAX sorgusunu rapordaki bir görsele bağlamak için Çalışma Alanı İzleme veya Log Analytics aracılığıyla performans sorunlarını gidermek için kullanabilirsiniz.

PBIR Json Şemaları

Her PBIR JSON dosyası, belgenin en üstünde bir JSON şema bildirimi içerir. Bu şema URL'sine genel erişim sağlanır ve her dosya için kullanılabilir özellikler ve nesneler hakkında daha fazla bilgi edinmek için kullanılabilir. Ayrıca , Visual Studio Code gibi kod düzenleyicileriyle düzenleme yaparken yerleşik IntelliSense ve doğrulama sağlar.

Şema URL'si, belgenin rapor tanımı geliştikçe değişmesi beklenen sürümünü de tanımlar.

Tüm JSON şemaları burada yayımlanır.

PBIR notları

Her visualpage ve reportiçin rapor tanımına ad-değer çiftleri olarak ek açıklamalar ekleyebilirsiniz. Power BI Desktop bu ek açıklamaları görmezden gelse de, bunlar betikler gibi dış uygulamalar için değerli olabilir.

Örneğin, dosyadaki report.json rapor için defaultPage değerini belirtebilirsiniz. Bu sayfa daha sonra bir dağıtım betiği tarafından kullanılabilir.

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/report/1.0.0/schema.json",
  "themeCollection": {
    "baseTheme": {
      "name": "CY24SU06",
      "reportVersionAtImport": "5.55",
      "type": "SharedResources"
    }
  },
  ...
  "annotations": [
    {
      "name": "defaultPage",
      "value": "c2d9b4b1487b2eb30e98"
    }
  ]
}

PBIR dosyalarında dış değişiklikler

Dosya JSON şemasına uyduğu sürece, Visual Studio Code gibi bir kod düzenleyicisi veya bir dış araç kullanarak PBIR JSON dosyalarını düzenleyebilirsiniz. Yanlış bir özellik adı veya türü kullanmak doğrudan Visual Studio Code'da kolayca algılanabilir:

PBIR içeriğinde yapılan dış değişiklikler, Power BI Desktop'ta dosyaları yeniden açarken hatalara neden olabilir. Bu hatalar iki türde olabilir:

Engelleme hataları Power BI Desktop'ın raporu açmasını engeller. Bu hatalar, sorunu ve yeniden açmadan önce düzeltilmesi gereken sorunlu dosyayı tanımlamaya yardımcı olur:

Geçersiz şema veya eksik gerekli özellikler gibi hatalar engelleme hataları olarak kabul edilir. Bu hatalar, dosyayı Visual Studio Code'da açıp şema hatalarını inceleyerek kolayca tanımlanabilir.

Engelleyici olmayan hatalar Power BI Desktop'ın raporu açmasını engellemez ve otomatik olarak çözülür.

Geçersiz activePageName yapılandırması gibi hatalar, otomatik olarak düzeltilebilen engelleyici olmayan hatalara örnektir. Bu uyarı, size raporu otomatik düzeltmeyle kaydetmekten kaçınma şansı vererek, olası bir iş kaybını önlemek için gereklidir.

Yaygın PBIR hataları

Senaryo:Görsel veya sayfa klasörü adlarını yeniden adlandırdıktan sonra, rapor açılırken görselim veya sayfam artık görünmüyor.

Çözüm: Adın adlandırma kuralına uygun olup olmadığını doğrulayın. Eğer öyle değilse, Power BI Desktop dosyayı veya klasörü yoksayar ve özel kullanıcı dosyaları olarak kabul eder.

Senaryo:Yeni rapor nesneleri diğerlerinden farklı olarak adlandırılır. Örneğin, çoğu sayfa klasörü 'ReportSection0e71dafbc949c0853608' olarak adlandırılırken, bazıları '1b3c2ab12b603618070b' olarak adlandırılır.

Çözüm: PBIR her nesne için yeni bir adlandırma kuralı benimsedi, ancak yalnızca yeni nesneler için geçerlidir. Mevcut bir raporu PBIP olarak kaydettiğinizde, referansların bozulmasını önlemek için geçerli adların korunması gerekir. Tutarlılık istiyorsanız, bir betik kullanarak toplu yeniden adlandırma yapmanıza izin verilir.

Senaryo:Yer işareti dosyasını kopyaladım ve kaydettikten sonra yer işareti yapılandırmasının çoğu silindi.

Çözüm: Bu davranış kasıtlı olarak gerçekleştirilir, rapor yer işaretleri, tüm görselleri ile birlikte bir rapor sayfasının durumunu yakalar. Yakalanan durum farklı görsellere sahip başka bir rapor sayfasından kaynaklandığından, geçersiz görseller yer işareti yapılandırmasından kaldırılır. Bağımlı görselleri ve sayfayı da kopyalarsanız, yer işareti yapılandırmasını olduğu gibi korur.

Senaryo:Başka bir rapordan bir sayfa klasörü kopyaladım ve "'pageBinding.name' özelliğinin değerleri benzersiz olmalıdır" hatasını aldım.

Çözüm: detaylandırma ve sayfa araç ipuçlarını desteklemek için pageBinding nesnesi gereklidir. Bunlara başka sayfalar tarafından başvurulabileceği için, adın rapor içinde benzersiz olması gerekir. Yeni kopyalanan sayfada, hatayı çözmek için benzersiz bir değer atayın. Haziran 2024'ten sonra, pageBinding adı varsayılan olarak BİR GUID olduğundan bu durum artık sorun teşkil etmez.

PBIR ile ilgili önemli noktalar ve sınırlamalar

PBIR şu anda önizleme aşamasındadır. Aşağıdakileri göz önünde bulundurun:

• Bağımsız Bulutlarda PBIR, Genel Kullanılabilirlik öncesinde hizmette otomatik olarak yükseltilmeyecektir. O zamana kadar Bağımsız Bulut müşterileri, PBIR önizleme özelliklerini etkinleştirerek raporlarını Power BI Desktop'ta PBIR biçiminde test edebilir.
• 500'den fazla dosya içeren büyük raporlar yazma performansı sorunlarıyla karşılaşabilir (rapor görüntüleme etkilenmez).
• Bir rapor PBIR-Legacy'den PBIR'a dönüştürüldükten sonra geri almak mümkün değildir. Dönüştürme sırasında bir yedekleme oluşturulsa da.
• "Farklı Kaydet" özelliğini kullanarak PBIP dosyasını PBIX dosyasına dönüştürmek, PBIR raporunu PBIX dosyasına ekler ve tüm PBIR sınırlamalarını PBIX'e taşır.
• Görsel otomatik filtreler , yalnızca filtre bölmesi raporu düzenlerken en az bir kez genişletildikten sonra PBIR visual.json dosyasında kalıcı olur.
• Şablon Uygulaması çalışma alanlarında desteklenmez

Hizmet tarafından zorunlu kılınan PBIR boyut sınırlamaları:

• Rapor başına en fazla 1.000 sayfa.
• Sayfa başına en fazla 1000 görsel.
• Rapor başına en fazla 1.000 kaynak paketi dosyası.
• Tüm kaynak paketi dosyaları için en fazla 300 MB boyut.
• Tüm rapor dosyalarının en büyük boyutu 300 MB'tır.

Önemli

Yukarıdaki sınırlara ulaşırsanız raporunuzu iyileştirmeyi düşünmelisiniz. Power BI İyileştirme belgesine bakın.

Doku Git Tümleştirmesi ve Doku REST API'leri , hizmette geçerli olarak uygulanan biçimi kullanarak raporları dışarı aktarır. PBIR biçimi kullanılarak bir rapor oluşturulur veya Doku'ya aktarılırsa, PBIR biçiminde dışarı aktarılır. Benzer şekilde, bir rapor PBIR-Legacy ise, PBIR-Legacy biçiminde dışarı aktarılır.

İlgili içerik

• Power BI Desktop proje anlam modeli klasörü
• Power BI Desktop projeleri