Broncode-indeling voor Git-integratie

Items in Microsoft Fabric worden opgeslagen in een map. De map met het item kan zich in de hoofdmap of in een submap bevinden. Wanneer u uw werkruimte verbindt met Git, maakt u verbinding met de map met de items. Elk item in de map wordt weergegeven in een eigen submap. Deze itemmappen hebben dezelfde naam als het item, gevolgd door het itemtype.

Belangrijk

Deze functie is beschikbaar als preview-versie.

Elke itemmap bevat de itemdefinitiebestanden en een of twee automatisch gegenereerde systeembestanden.

Itemdefinitiebestanden

De map van elk item bevat specifieke verplichte bestanden die dat item definiëren.

De volgende items worden momenteel ondersteund in Microsoft Fabric:

• Notebook
• Gepagineerd rapport
• Rapport
• Semantisch model

Notitieblokbestanden

Notitieblokmappen bevatten een .py-bestand:

Zie Broncodebeheer en implementatie van Notebook voor instructies over het gebruik van Git-integratie met notebooks.

Gepagineerde rapportbestanden

Gepagineerde rapportmappen bevatten een RDL-bestand dat het gepagineerde rapport definieert. RDL (Report Definition Language) is een XML-weergave van een gepagineerde rapportdefinitie.

Zie Report Definition Language (RDL) voor meer informatie over RDL. Zie Git-integratie met gepagineerde rapporten voor instructies over het gebruik van Git-integratie met gepagineerde rapporten.

Rapportbestanden

Rapportmappen bevatten de volgende bestanden:

• definition.pbir
• report.json

Zie de projectrapportmap van Power BI Desktop voor meer informatie over rapportmappen en een volledige lijst met inhoud.

Semantische modelbestanden

Semantische modelmappen bevatten de volgende bestanden:

• definition.pbidataset
• model.bim-bestand (TMSL-indeling) OF \definition-map (TMDL-indeling)

Zie de semantische modelmap van het Power BI Desktop-project voor meer informatie over semantische modelmappen en een volledige lijst met inhoud.

Automatisch gegenereerde systeembestanden

Naast de itemdefinitiebestanden bevat elke itemmap een of twee automatisch gegenereerde systeembestanden, afhankelijk van de versie die u gebruikt:

• Een map met versie 1 bevat item.metadata.json en item.config.json. Wanneer u V1 gebruikt, moeten beide bestanden zich in de map bevinden.
• Een map met versie 2 bevat .platform. Dit bestand bevat de inhoud van zowel item.metadata.json als item.config.json bestanden. Als u dit bestand hebt, kunt u de andere twee bestanden niet hebben. Als u versie 1 gebruikt en wijzigingen doorvoert, worden uw systeembestanden automatisch bijgewerkt naar deze versie.

Notitie

De map moet de item.metadata.json bestanden ofitem.config.jsonhet .platform bestand bevatten. U kunt niet alle drie de bestanden hebben.

Versie 2

Platformbestand

In versie 2, in plaats van twee bronbestanden in elke itemmap te hebben, combineert het platformbestand alle informatie in één bestand, samen met een eigenschap $schema . Als u dit bestand hebt, kunt u de andere twee bestanden niet hebben.

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

Het .platform bestand bevat de volgende kenmerken:

• version: versienummer van de systeembestanden. Dit getal wordt gebruikt om compatibiliteit met eerdere versies mogelijk te maken. Het versienummer van het item kan afwijken.
• logicalId: Een automatisch gegenereerde id voor meerdere werkruimten die een item en de bijbehorende bronbeheerweergave vertegenwoordigen.
• type: (tekenreeks) Het type van het item (semantisch model, rapport, enzovoort)
• displayName: (tekenreeks) De naam van het item.
• description: (optionele tekenreeks) Beschrijving van het item.

Versie 1

Als u versie 1 gebruikt, hebt u twee bestanden in elke itemmap:

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

Metagegevensbestand

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

Het bestand item.metadata.json bevat de volgende kenmerken:

• type: (tekenreeks) Het type van het item (semantisch model, rapport, enzovoort)
• displayName: (tekenreeks) De naam van het item
• description: (optionele tekenreeks) Beschrijving van het item

Als u de naam van een item wilt wijzigen, wijzigt u het displayName in het bestand 'item.metadata.json'. Als u de naam van de map wijzigt, wordt de weergavenaam van het item in de werkruimte niet gewijzigd.

Configuratiebestand

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

Het item.config.json bestand bevat de volgende kenmerken:

• version: versienummer van de systeembestanden. Dit getal wordt gebruikt om compatibiliteit met eerdere versies mogelijk te maken. Het versienummer van het item kan afwijken.
• logicalId: Een automatisch gegenereerde id voor meerdere werkruimten die een item en de bijbehorende bronbeheerweergave vertegenwoordigen.

De logicalId verbindt een item in een werkruimte met het bijbehorende item in een Git-vertakking. Items met dezelfde logicalIds worden verondersteld hetzelfde te zijn. De logicalId behoudt de koppeling, zelfs als de naam of map wordt gewijzigd. Omdat een vertakking kan worden gesynchroniseerd met meerdere werkruimten, is het mogelijk om items in verschillende werkruimten met dezelfde logicalId te hebben, maar één werkruimte kan geen twee items met dezelfde logicalId hebben. De logicalId wordt gemaakt wanneer de werkruimte is verbonden met een Git-vertakking of een nieuw item wordt gesynchroniseerd. De logicalId is nodig om Git-integratie goed te laten functioneren. Daarom is het essentieel om het op geen enkele manier te wijzigen.

Notitie

Wanneer u wijzigingen doorvoert in Git in versie 1, worden de systeembestanden automatisch bijgewerkt naar versie 2, samen met de wijzigingen. Ook worden alle nieuwe bestanden die worden geëxporteerd vanuit de ontwikkelaarsmodus van Power BI Desktop, opgeslagen in de bestandsindeling versie 2.

Notitie

• Het typeveld is hoofdlettergevoelig. Wijzig niet de manier waarop deze automatisch wordt gegenereerd of mislukt.
• Hoewel u in het algemeen niet de logicalId of weergavenaam van een item moet wijzigen, kan één uitzondering zijn als u een nieuw item maakt door een bestaande itemmap te kopiëren. In dat geval moet u de logicalId en de weergavenaam wijzigen in iets unieks in de opslagplaats.

Gerelateerde inhoud

Aan de slag met Git-integratie.