Git 整合原始程式碼格式
Microsoft Fabric 中的項目儲存在資料夾中。 包含該項目的資料夾既可以位於根目錄，也可以位於子目錄中。 在將工作區連線至 Git 時，請連線到包含相關項目的資料夾。 資料夾中的每個項目均以自己的子目錄表示。
目錄名稱
在 Git 中儲存項目時，Git 整合會自動為該項目建立目錄。
項目目錄的名稱為 <item name>.<item type>，後面接著項目類型。 如果該名稱無法使用，則會使用項目的邏輯 ID (GUID) 名稱，後面接著項目類型。
- 目錄名稱建立之後，Git 整合永遠不會變更目錄的名稱。 即使更改項目的名稱，目錄名稱仍會維持不變。
- 如果手動更改項目目錄的名稱，請務必將項目的相依性納入考慮。 例如，如果更改語意模型的目錄，應務必更新報表的相依性檔案中語意模型的路徑。 請記住，相依性位置會因不同的 Fabric 體驗而異。
目錄內容
每個項目目錄都包含項目定義檔案，以及一個或兩個自動產生的系統檔案。
項目定義檔案
每個項目的目錄都有定義該項目的特定必要檔案。
Microsoft Fabric 中目前支援下列項目：
筆記本檔案
筆記本資料夾包含一個 .py 檔案：
如需關於搭配使用 Git 整合與筆記本的指示，請參閱＜筆記本原始檔控制和部署＞。
編頁報表檔案
編頁報表資料夾包含一個定義編頁報表的 .rdl 檔案。 報表定義語言 (RDL) 是編頁報表定義的 XML 表示法。
如需關於 RDL 的詳細資訊，請參閱＜報表定義語言 (RDL)＞。 如需關於搭配使用 Git 整合與編頁報表的指示，請參閱＜Git 整合與編頁報表＞。
報表檔案
報表資料夾內含下列檔案：
- definition.pbir
- report.json
如需關於報表資料夾及其內容完整清單的詳細資訊，請參閱＜Power BI Desktop 專案報表資料夾＞。
語意模型檔案
語意模型資料夾內含下列檔案：
- definition.pbidataset
- model.bim 檔案 (TMSL 格式) 或者 \definition 資料夾 (TMDL 格式)
如需關於語意模型資料夾及其內容完整清單的詳細資訊，請參閱＜Power BI Desktop 專案語意模型資料夾＞。
自動產生的系統檔案
除了項目定義檔案之外，每個項目目錄都包含一或兩個自動產生的系統檔案，視您使用的版本而定：
- 第 1 版目錄包含 item.metadata.json 和 item.config.json。 使用 V1 版本時，這兩個檔案都必須位於目錄中。
- 第 2 版目錄包含 .platform。 此檔案包含 item.metadata.json 和 item.config.json 兩個檔案的內容。 如果有此檔案，則不能有其他兩個檔案。 如果使用的是第 1 版並認可變更，系統檔案會自動更新為此版本相應的檔案。
注意
目錄必須包含 item.metadata.json 和 item.config.json 檔案 或者 .platform 檔案。 不能同時有這三個檔案。
平台檔案
在第 2 版中，.platform 檔案不是在每個項目目錄中都有兩個來源檔案，而是將所有資訊與 $schema 屬性一起合併到一個檔案中。 如果有此檔案，則不能有其他兩個檔案。
{
"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"
}
}
.platform 檔案包含下列屬性：
version：系統檔案的版本號碼。 此號碼用來啟用回溯相容性。 項目的版本號碼可能不同。logicalId：自動產生的跨工作區識別碼，表示項目及其原始檔控制表示法。type：(字串) 項目類型 (語意模型、報表等)displayName：(字串) 項目的名稱。description：(選用字串) 項目的描述。
注意
- type 欄位需區分大小寫。 請勿更改其自動產生的方式，否則可能會失敗。
- 雖然通常情況下不應該更改項目的 logicalId 或顯示名稱，但若是要透過拷貝現有的項目目錄來建立新項目，是一個例外狀況。 在此情況下，必須將 logicalId 和 顯示名稱 更改為存放庫中唯一的 logicalId 和顯示名稱。