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.

De mapnaam

Wanneer u een nieuw item opslaat in Git, maakt Git-integratie automatisch een map voor dat item.

De mapnaam van het item is gebaseerd op de volgende regels:

• Het patroon voor de naam is {display name}.{public facing type}.
• Indien nodig worden de volgende wijzigingen in de weergavenaam aangebracht:
  • Ongeldige tekens worden vervangen door het HTML-nummer.
  • Voorloopruimte wordt vervangen door het HTML-nummer.
  • Volgruimte of punt wordt vervangen door het HTML-nummer.
• Als deze mapnaam niet beschikbaar is, wordt de naam van de logicalID (GUID) van het item gebruikt in plaats van de weergavenaam.

Als u bijvoorbeeld de volgende items in een werkruimte hebt (houd er rekening mee dat de eerste en derde items respectievelijk een onzichtbare voorloop- en volgruimte hebben):

De volgende mappen worden gemaakt in de Git-opslagplaats:

• Zodra de git-integratie is gemaakt, wordt de naam van een map nooit gewijzigd. Zelfs als u de naam van het item wijzigt, blijft de mapnaam hetzelfde.
• Als u de naam van een itemmap handmatig wijzigt, moet u rekening houden met de afhankelijkheden van het item. Als u bijvoorbeeld de map van een semantisch model wijzigt, moet u ervoor zorgen dat u het pad van het semantische model in het afhankelijkheidsbestand van het rapport bijwerkt. Houd er rekening mee dat afhankelijkheidslocaties verschillen tussen verschillende Fabric-ervaringen. Als u de mapnaam wijzigt, wordt er geen binnenkomende wijziging in de werkruimte veroorzaakt.

Mapinhoud

Elke itemmap bevat de itemdefinitiebestanden en automatisch gegenereerde systeembestanden.

Itemdefinitiebestanden

De map van elk item bevat specifieke, vereiste 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. Met V1 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 of item.config.json het .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, heeft elke itemmap twee bestanden:

• 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.