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:
- 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):
Aşağıdaki dizinler Git deposunda oluşturulur:
- 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.