Aracılığıyla paylaş


Git tümleştirme kaynak kodu biçimi

Microsoft Fabric'teki öğeler bir klasörde depolanır. Öğeyi içeren klasör kök dizinde veya bir alt dizinde olabilir. Çalışma alanınızı git'e bağladığınızda, öğeleri içeren klasöre bağlanın. Klasördeki her öğe kendi alt dizininde temsil edilir.

Dizin adı

Git'e yeni bir öğe kaydettiğinizde Git tümleştirmesi bu öğe için otomatik olarak bir dizin oluşturur.

Öğe dizini adı aşağıdaki kuralları temel alır:

  • Adın deseni şeklindedir {display name}.{public facing type}.
  • Gerekirse, görünen adda aşağıdaki değişiklikler yapılır:
    • Geçersiz karakterler HTML numarasıyla değiştirilir.
    • Baştaki alan, HTML numarasıyla değiştirilir.
    • Sondaki boşluk veya nokta, HTML numarasıyla değiştirilir.
  • Bu klasör adı kullanılamıyorsa, görünen ad yerine öğenin mantıksal kimliğinin (GUID) adı kullanılır.

Örneğin, bir çalışma alanında aşağıdaki öğeler varsa (birinci ve üçüncü öğelerin sırasıyla görünmez bir baştaki ve sondaki alana sahip olduğunu unutmayın):

Doku çalışma alanında öğelerin listesinin ekran görüntüsü.

Aşağıdaki dizinler Git deposunda oluşturulur:

Doku öğelerini içeren Git dizinlerinin adlarının ekran görüntüsü.

  • Oluşturulduktan sonra Git tümleştirmesi hiçbir zaman bir dizinin adını değiştirmez. Öğenin adını değiştirseniz bile dizin adı aynı kalır.
  • Öğe dizininin adını el ile değiştirirseniz, öğenin bağımlılıklarını hesaba katmaya dikkat edin. Örneğin, bir semantik modelin dizinini değiştirirseniz, raporun bağımlılık dosyasındaki semantik modelin yolunu güncelleştirdiğinizden emin olmanız gerekir. Bağımlılık konumlarının farklı Doku deneyimleri arasında farklılık gösterdiğini unutmayın. Dizin adının değiştirilmesi, çalışma alanında gelen bir değişikliğe neden olmaz .

Dizin içeriği

Her öğe dizini, öğe tanım dosyalarını ve otomatik olarak oluşturulan sistem dosyalarını içerir.

Öğe tanım dosyaları

Her öğenin dizini, bu öğeyi tanımlayan belirli, gerekli dosyalara sahiptir.

Şu anda Microsoft Fabric'te aşağıdaki öğeler desteklenmektedir:

Not defteri dosyaları

Not defteri klasörleri bir .py dosyası içerir:

Not defterleriyle Git tümleştirmesi kullanma yönergeleri için bkz . Not defteri kaynak denetimi ve dağıtımı.

Sayfalandırılmış rapor dosyaları

Sayfalandırılmış rapor klasörleri, sayfalandırılmış raporu tanımlayan bir .rdl dosyası içerir. RDL (Rapor Tanımı Dili), sayfalandırılmış rapor tanımının XML gösterimidir.

O RDL hakkında daha fazla bilgi için bkz . Rapor Tanımı Dili (RDL). Sayfalandırılmış raporlarla Git tümleştirmesi kullanma yönergeleri için bkz . Sayfalandırılmış raporlarla Git tümleştirmesi.

Rapor dosyaları

Rapor klasörleri aşağıdaki dosyaları içerir:

  • definition.pbir
  • report.json

Rapor klasörleri ve içeriklerinin tam listesi hakkında daha fazla bilgi için bkz . Power BI Desktop proje raporu klasörü.

Anlamsal model dosyaları

Anlam modeli klasörleri aşağıdaki dosyaları içerir:

  • definition.pbidataset
  • model.bim dosyası (TMSL biçimi) VEYA \tanım klasörü (TMDL biçimi)

Anlam modeli klasörleri ve bunların içeriğinin tam listesi hakkında daha fazla bilgi için bkz . Power BI Desktop proje anlam modeli klasörü.

Otomatik olarak oluşturulan sistem dosyaları

Öğe tanımı dosyalarına ek olarak, kullandığınız sürüme bağlı olarak her öğe dizini otomatik olarak oluşturulan bir veya iki sistem dosyası içerir:

  • Sürüm 1 dizini item.metadata.json ve item.config.json içerir. V1 ile her iki dosya da dizinde olmalıdır.
  • Sürüm 2 dizini .platform içerir. Bu dosya hem item.metadata.json hem de item.config.json dosyalarının içeriğini içerir. Bu dosyaya sahipseniz diğer iki dosyaya sahip olamazsınız. Sürüm 1'i kullanıyorsanız ve değişiklikleri işliyorsanız sistem dosyalarınız otomatik olarak bu sürüme güncelleştirilir.

Not

Dizininiz ve item.config.json dosyalarını veya .platform dosyasını içermelidiritem.metadata.json. Üç dosyaya da sahip olamazsınız.

Platform dosyası

Sürüm 2'de, her öğe dizininde iki kaynak dosya olması yerine .platform dosyası tüm bilgileri bir $schema özelliğiyle birlikte tek bir dosyada birleştirir. Bu dosyaya sahipseniz diğer iki dosyaya sahip olamazsınız.

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

Dosya .platform aşağıdaki öznitelikleri içerir:

  • version: Sistem dosyalarının sürüm numarası. Bu sayı geriye dönük uyumluluğu etkinleştirmek için kullanılır. Öğenin sürüm numarası farklı olabilir.
  • logicalId: Bir öğeyi ve kaynak denetimi gösterimini temsil eden otomatik olarak oluşturulan çalışma alanları arası tanımlayıcı.
  • type: (dize) Öğenin türü (anlamsal model, rapor vb.)
  • displayName: (dize) Öğenin adı.
  • description: (isteğe bağlı dize) Öğenin açıklaması.

Not

  • Tür alanı büyük/küçük harfe duyarlıdır. Otomatik olarak oluşturulma şeklini değiştirmeyin veya başarısız olabilir.
  • Bir öğenin mantıksal kimliğini veya görünen adını genel olarak değiştirmemelisiniz, ancak var olan bir öğe dizinini kopyalayarak yeni bir öğe oluşturuyorsanız bir özel durum olabilir. Bu durumda, mantıksal kimliği ve görünen adı depoda benzersiz bir adla değiştirmeniz gerekir.

Git tümleştirmesi ile çalışmaya başlayın.