Git-integreringens källkodsformat

Objekt i Microsoft Fabric lagras i en mapp. Mappen som innehåller objektet kan antingen finnas i rotkatalogen eller i en underkatalog. När du ansluter arbetsytan till git ansluter du till mappen som innehåller objekten. Varje objekt i mappen representeras i sin egen underkatalog. Dessa objektkataloger har samma namn som objektet följt av objekttypen.

Viktigt!

Den här funktionen är i förhandsversion.

Varje objektkatalog innehåller objektdefinitionsfilernaoch antingen en eller två automatiskt genererade systemfiler.

Objektdefinitionsfiler

Varje objekts katalog har specifika obligatoriska filer som definierar objektet.

Följande objekt stöds för närvarande i Microsoft Fabric:

• Notebook-fil
• Sidnumrerad rapport
• Rapport
• Semantisk modell

Notebook-filer

Notebook-mappar innehåller en .py fil:

Anvisningar om hur du använder Git-integrering med notebook-filer finns i Källkontroll och distribution av notebook-filer.

Sidnumrerade rapportfiler

Sidnumrerade rapportmappar innehåller en rdl-fil som definierar den sidnumrerade rapporten. RDL (Report Definition Language) är en XML-representation av en sidnumrerad rapportdefinition.

Mer information o RDL finns i Report Definition Language (RDL). Anvisningar om hur du använder Git-integrering med sidnumrerade rapporter finns i Git-integrering med sidnumrerade rapporter.

Rapportfiler

Rapportmappar innehåller följande filer:

• definition.pbir
• report.json

Mer information om rapportmappar och en fullständig lista över deras innehåll finns i Power BI Desktop-projektrapportmappen.

Semantiska modellfiler

Semantiska modellmappar innehåller följande filer:

• definition.pbidataset
• model.bim-fil (TMSL-format) ELLER \definitionsmapp (TMDL-format)

Mer information om semantiska modellmappar och en fullständig lista över deras innehåll finns i power BI Desktop-projektets semantiska modellmapp.

Automatiskt genererade systemfiler

Förutom objektdefinitionsfilerna innehåller varje objektkatalog en eller två automatiskt genererade systemfiler, beroende på vilken version du använder:

• En version 1-katalog innehåller item.metadata.json och item.config.json. När du använder V1 måste båda filerna finnas i katalogen.
• En version 2-katalog innehåller .platform. Den här filen innehåller innehållet i både item.metadata.json och item.config.json filer. Om du har den här filen kan du inte ha de andra två filerna. Om du använder version 1 och genomför ändringar uppdateras systemfilerna automatiskt till den här versionen.

Kommentar

Katalogen måste innehålla antingen item.metadata.json filerna och item.config.json eller.platform filen. Du kan inte ha alla tre filerna.

Version 2

Plattformsfil

I version 2, i stället för att ha två källfiler i varje objektkatalog, kombinerar .platform-filen all information till en fil tillsammans med en $schema egenskap. Om du har den här filen kan du inte ha de andra två filerna.

{
    "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"
    }
}

Filen .platform innehåller följande attribut:

• version: Versionsnummer för systemfilerna. Det här talet används för att aktivera bakåtkompatibilitet. Versionsnumret för objektet kan vara annorlunda.
• logicalId: En automatiskt genererad identifierare för flera arbetsytor som representerar ett objekt och dess källkontrollrepresentation.
• type: (sträng) Objektets typ (semantisk modell, rapport osv.)
• displayName: (sträng) Objektets namn.
• description: (valfri sträng) Beskrivning av objektet.

Version 1

Om du använder version 1 har du två filer i varje objektkatalog:

• 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", 
} 

Metadatafil

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

Filen item.metadata.json innehåller följande attribut:

• type: (sträng) Objektets typ (semantisk modell, rapport osv.)
• displayName: (sträng) Namnet på objektet
• description: (valfri sträng) Beskrivning av objektet

Om du vill byta namn på ett objekt ändrar du displayName i filen "item.metadata.json". Om du ändrar namnet på mappen ändras inte visningsnamnet för objektet på arbetsytan.

Konfigurationsfil

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

Filen item.config.json innehåller följande attribut:

• version: Versionsnummer för systemfilerna. Det här talet används för att aktivera bakåtkompatibilitet. Versionsnumret för objektet kan vara annorlunda.
• logicalId: En automatiskt genererad identifierare för flera arbetsytor som representerar ett objekt och dess källkontrollrepresentation.

LogicalId ansluter ett objekt i en arbetsyta med motsvarande objekt i en Git-gren. Objekt med samma logicalId antas vara desamma. LogicalId bevarar länken även om namnet eller katalogen ändras. Eftersom en gren kan synkroniseras till flera arbetsytor är det möjligt att ha objekt i olika arbetsytor med samma logicalId, men en enda arbetsyta kan inte ha två objekt med samma logicalId. LogicalId skapas när arbetsytan är ansluten till en Git-gren eller om ett nytt objekt synkroniseras. LogicalId är nödvändigt för att Git-integreringen ska fungera korrekt. Därför är det viktigt att inte ändra det på något sätt.

Kommentar

När du checkar in ändringar i Git i version 1 uppdateras systemfilerna automatiskt till version 2 tillsammans med ändringarna. Dessutom sparas alla nya filer som exporteras från Power BI Desktop-utvecklarläget i filformatet version 2.

Kommentar

• Typfältet är skiftlägeskänsligt. Ändra inte hur det genereras automatiskt eller så kan det misslyckas.
• Även om du vanligtvis inte bör ändra logiskaId eller visningsnamn för ett objekt, kan ett undantag vara om du skapar ett nytt objekt genom att kopiera en befintlig objektkatalog. I så fall måste du ändra logicalId och visningsnamnet till något unikt på lagringsplatsen.

Relaterat innehåll

Kom igång med Git-integrering.