Share via

Power BI Desktop proje raporu klasörü

  • Makale

Ö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:

1 - Bu dosya gereklidir.

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

Rapor dosyaları

.pbi\local Ayarlar.json

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 yerel Ayarlar.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:

  • Kuruluş deposu görselleri - Kuruluşlar özel görselleri onaylayabilir ve 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 özel görseller" olarak da bilinir. Dosyalar bir pbiviz paketi karşıya yüklenerek rapora yüklenebilir.

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.

definition.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. Bir pbir açıldığında, kullanılarak byPathgöreli bir başvuru varsa semantik modelin yanı sıra açılır.

Örnek definition.pbir:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    },
    "byConnection": null
  }
}

Tanımı, raporda kullanılan anlam modeline başvuran özelliğini içerir datasetReference . Başvuru 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 Power BI hizmeti uzak bir anlam modeli belirtir. Bir byConnection başvuru kullanıldığında Power BI Desktop semantik modeli düzenleme modunda açmaz.

Başvuru byConnection kullanılırken aşağıdaki özellikler belirtilmelidir:

Özellik Açıklama
Connectionstring Uzak anlam modeline başvuran bağlantı dizesi.
pbiModelDatabaseName Uzak anlam modeli kimliği.
Connectiontype Bağlantı türü. Hizmet uzak anlam modeli için bu değer olmalıdır pbiServiceXmlaStyleLive.
pbiModelVirtualServerName değerine sahip olması gereken bir iç özellik. sobe_wowvirtualserver

kullanan byConnectionörnek:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": null,
    "byConnection": {
      "connectionString": "Data Source=powerbi://api.powerbi.com/v1.0/myorg/WorkpaceName;Initial Catalog=SemanticModelName;Integrated Security=ClaimsToken",
      "pbiServiceModelId": null,
      "pbiModelVirtualServerName": "sobe_wowvirtualserver",
      "pbiModelDatabaseName": "e244efd3-e253-4390-be28-6be45d9da47e",
      "connectionType": "pbiServiceXmlaStyleLive",
      "name": null
    }
  }
}

Anlamsal model ve rapor aynı çalışma alanını paylaştığında, Doku Git Tümleştirmesi her zaman anlam modeline bir byPath başvuru kullanır.

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

Görseller, sayfa düzeni ve hedeflenen etkileşimler dahil olmak üzere bir rapor tanımlar. Önizleme sırasında bu dosya dış düzenlemeyi desteklemez.

.Platform

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

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

İlgili içerik