Kodeformat for Git-integrationskildekode
Elementer i Microsoft Fabric gemmes i en mappe. Den mappe, der indeholder elementet, kan enten være i rodmappen eller i en undermappe. Når du opretter forbindelse mellem dit arbejdsområde og Git, skal du oprette forbindelse til den mappe, der indeholder elementerne. Hvert element i mappen vises i sin egen undermappe.
Mappenavn
Når du gemmer et nyt element i Git, opretter Git-integration automatisk en mappe til det pågældende element.
Navnet på elementmappen er baseret på følgende regler:
- Mønsteret for navnet er
{display name}.{public facing type}. - Hvis det er nødvendigt, foretages følgende ændringer af det viste navn:
- Ugyldige tegn erstattes med HTML-nummeret.
- Foranstillet mellemrum erstattes med HTML-nummeret.
- Efterstillet mellemrum eller prik erstattes med HTML-nummeret.
- Hvis mappenavnet ikke er tilgængeligt, bruges navnet på elementets logicalID (GUID) i stedet for det viste navn.
Hvis du f.eks. har følgende elementer i et arbejdsområde (bemærk, at det første og tredje element har henholdsvis et usynligt foranstillet og efterstillet område):
Følgende mapper oprettes i Git-lageret:
- Når Git-integration er oprettet, ændres navnet på en mappe aldrig. Selvom du ændrer navnet på elementet, forbliver mappenavnet det samme.
- Hvis du manuelt ændrer navnet på en elementmappe, skal du sørge for at tage højde for elementets afhængigheder. Hvis du f.eks. ændrer mappen for en semantisk model, skal du sørge for at opdatere stien til den semantiske model i rapportens afhængighedsfil. Husk, at afhængighedsplaceringer varierer mellem forskellige Fabric-oplevelser. Ændring af mappenavnet medfører ikke en indgående ændring i arbejdsområdet.
Mappeindhold
Hver elementmappe indeholder elementdefinitionsfilerne og automatisk genererede systemfiler.
Elementdefinitionsfiler
Hvert elements mappe har specifikke, påkrævede filer, der definerer det pågældende element.
Følgende elementer understøttes i øjeblikket i Microsoft Fabric:
Notesbogfiler
Notesbogmapper indeholder en .py fil:
Du kan finde oplysninger om brug af Git-integration med notesbøger under Styring og installation af notesbogkilde.
Sideinddelte rapportfiler
Sideinddelte rapportmapper indeholder en .rdl-fil , der definerer den sideinddelte rapport. RDL (Report Definition Language) er en XML-repræsentation af en sideinddelt rapportdefinition.
Du kan få flere oplysninger om RDL under RDL (Report Definition Language). Du kan finde oplysninger om brug af Git-integration med sideinddelte rapporter under Git-integration med sideinddelte rapporter.
Rapportfiler
Rapportmapper indeholder følgende filer:
- definition.pbir
- report.json
Du kan få flere oplysninger om rapportmapper og en komplet liste over deres indhold i Power BI Desktop-projektrapportmappen.
Semantiske modelfiler
Semantiske modelmapper indeholder følgende filer:
- definition.pbidataset
- model.bim-fil (TMSL-format) ELLER \definitionsmappe (TMDL-format)
Du kan få flere oplysninger om semantiske modelmapper og en komplet liste over deres indhold i power BI Desktop-projektmappen med semantiske modeller.
Automatisk genererede systemfiler
Ud over elementdefinitionsfilerne indeholder hver elementmappe en eller to automatisk genererede systemfiler, afhængigt af hvilken version du bruger:
- En version 1-mappe indeholder item.metadata.json og item.config.json. Med V1 skal begge filer være i mappen.
- En version 2-mappe indeholder .platform. Denne fil indeholder indholdet af både item.metadata.json- og item.config.json-filer. Hvis du har denne fil, kan du ikke have de to andre filer. Hvis du bruger version 1, og du bekræfter ændringer, opdateres systemfilerne automatisk til denne version.
Bemærk
Mappen skal enten item.metadata.json indeholde filerne og item.config.json eller .platform filen. Du kan ikke have alle tre filer.
Platformfil
I version 2 kombinerer .platform-filen i stedet for at have to kildefiler i hver elementmappe alle oplysningerne i én fil sammen med en $schema egenskab. Hvis du har denne fil, kan du ikke have de to andre filer.
{
"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 indeholder følgende attributter:
version: Systemfilernes versionsnummer. Dette tal bruges til at aktivere bagudkompatibilitet. Elementets versionsnummer kan være anderledes.logicalId: Et automatisk genereret id på tværs af arbejdsområder, der repræsenterer et element og dets versionsstyring.type: (streng) Elementets type (semantisk model, rapport osv.)displayName: (streng) Navnet på elementet.description: (valgfri streng) Beskrivelse af elementet.
Bemærk
- Der er forskel på store og små bogstaver i typefeltet . Du må ikke ændre den måde, det genereres automatisk på, eller det kan mislykkes.
- Selvom du generelt ikke skal ændre det logiske id eller det viste navn for et element, kan en undtagelse være, hvis du opretter et nyt element ved at kopiere en eksisterende elementmappe. I så fald skal du ændre logicalId og det viste navn til noget entydigt i lageret.