Git 整合原始程式碼格式

Microsoft Fabric 中的項目儲存在資料夾中。 包含該項目的資料夾既可以位於根目錄，也可以位於子目錄中。 在將工作區連線至 Git 時，請連線到包含相關項目的資料夾。 資料夾中的每個項目均以自己的子目錄表示。

目錄名稱

當您在 Git 中儲存新專案時，Git 整合會自動建立該專案的目錄。

項目目錄名稱是以下欄規則為基礎：

• 名稱的模式為 {display name}.{public facing type}。
• 如有必要，就會對顯示名稱進行下列變更：
  • 無效的字元會取代為 HTML 數位。
  • 前置空間會取代為其 HTML 編號。
  • 尾端空格或點會取代為其 HTML 編號。
• 如果該資料夾名稱無法使用，則會使用專案的logicalID （GUID） 名稱，而不是顯示名稱。

例如，如果您在工作區中有下列專案（請注意，第一個專案和第三個專案分別有不可見的前置和尾端空格）：

Git 存放庫中會建立下列目錄：

• 目錄名稱建立之後，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 版

平台檔案

在第 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：(選用字串) 項目的描述。

第 1 版

如果使用的是第 1 版，則每個項目目錄都有兩個檔案：

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

中繼資料檔案

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

item.metadata.json 檔案包含下列屬性：

• type：(字串) 項目類型 (語意模型、報表等)
• displayName：(字串) 項目的名稱
• description：(選用選用字串) 項目的描述

若要重新命名項目，請在“item.metadata.json”檔案中更改 displayName。 更改資料夾的名稱不會更改工作區中項目的顯示名稱。

組態檔

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

item.config.json 檔案包含下列屬性：

• version：系統檔案的版本號碼。 此號碼用來啟用回溯相容性。 項目的版本號碼可能不同。
• logicalId：自動產生的跨工作區識別碼，表示項目及其原始檔控制表示法。

logicalId 連接工作區中的項目與 Git 分支中與其對應的項目。 具有相同 logicalId 的項目會被視為是同一個項目。 即使名稱或目錄發生更改，logicalId 仍會保留連結。 由於分支可以同步至多個工作區，因此不同工作區中的項目可能具有相同的 logicalId，但單一工作區中不能有兩個具有相同 logicalId 的項目。 當工作區連線到 Git 分支或同步新項目時，就會建立 logicalId。 logicalId 對於 Git 整合的正常運作必不可少。 因此，請務必不要以任何方式對其進行更改。

注意

在第 1 版中認可變更至 Git 時，系統檔案會與變更一起自動更新為第 2 版。 此外，從 Power BI Desktop 開發人員模式匯出的任何新檔案都會以第 2 版檔案格式進行儲存。

注意

• type 欄位需區分大小寫。 請勿更改其自動產生的方式，否則可能會失敗。
• 雖然通常情況下不應該更改項目的 logicalId 或顯示名稱，但若是要透過拷貝現有的項目目錄來建立新項目，是一個例外狀況。 在此情況下，必須將 logicalId 和 顯示名稱 更改為存放庫中唯一的 logicalId 和顯示名稱。

相關內容

開始使用 Git 整合。