Del via

Git-integrasjonskildekodeformat

  • Artikkel

Elementer i Microsoft Fabric lagres i en mappe. Mappen som inneholder elementet, kan enten være i rotkatalogen eller en undermappe. Når du kobler arbeidsområdet til git, kobler du til mappen som inneholder elementene. Hvert element i mappen er representert i sin egen underkatalog.

Katalognavn

Når du lagrer et nytt element i Git, oppretter Git-integrering automatisk en katalog for elementet.

Navnet på elementkatalogen er basert på følgende regler:

  • Mønsteret for navnet er {display name}.{public facing type}.
  • Hvis det er nødvendig, gjøres følgende endringer i visningsnavnet:
  • Hvis mappenavnet ikke er tilgjengelig, brukes navnet på elementets logiske ID (GUID) i stedet for visningsnavnet.

Hvis du for eksempel har følgende elementer i et arbeidsområde (vær oppmerksom på at de første og tredje elementene har henholdsvis en usynlig innledende og etterfølgende plass):

Skjermbilde av listen over elementer i et stoffarbeidsområde.

Følgende kataloger opprettes i Git-repositoriet:

Skjermbilde av navnene på Git-katalogene som inneholder Fabric-elementene.

  • Når den er opprettet, endrer git-integreringen aldri navnet på en katalog. Selv om du endrer navnet på elementet, forblir katalognavnet det samme.
  • Hvis du endrer navnet på en elementkatalog manuelt, må du ta hensyn til elementets avhengigheter. Hvis du for eksempel endrer katalogen for en semantisk modell, bør du passe på å oppdatere banen til den semantiske modellen i rapportens avhengighetsfil. Husk at avhengighetssteder varierer mellom ulike stoffopplevelser. Endring av katalognavnet fører ikke til innkommende endringer i arbeidsområdet.

Kataloginnhold

Hver elementkatalog inneholder elementdefinisjonsfilene og automatisk genererte systemfiler.

Elementdefinisjonsfiler

Hver elementkatalog har spesifikke, obligatoriske filer som definerer elementet.

Følgende elementer støttes for øyeblikket i Microsoft Fabric:

Notatblokkfiler

Notatblokkmapper inneholder en .py fil:

Hvis du vil ha instruksjoner om hvordan du bruker Git-integrering med notatblokker, kan du se Kildekontroll og distribusjon av notatblokker.

Paginerte rapportfiler

Paginerte rapportmapper inneholder en RDL-fil som definerer den paginerte rapporten. RDL (rapportdefinisjonsspråk) er en XML-representasjon av en paginert rapportdefinisjon.

Hvis du vil ha mer informasjon om RDL, kan du se Rapportdefinisjonsspråk (RDL). Hvis du vil ha instruksjoner om hvordan du bruker Git-integrasjon med paginerte rapporter, kan du se Git-integrasjon med paginerte rapporter.

Rapportfiler

Rapportmapper inneholder følgende filer:

  • definition.pbir
  • report.json

Hvis du vil ha mer informasjon om rapportmapper og en fullstendig liste over innholdet, kan du se rapportmappen for Power BI Desktop-prosjektet.

Semantiske modellfiler

Semantiske modellmapper inneholder følgende filer:

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

Hvis du vil ha mer informasjon om semantiske modellmapper og en fullstendig liste over innholdet, kan du se semantisk modellmappe for Power BI Desktop-prosjektet.

Automatisk genererte systemfiler

I tillegg til elementdefinisjonsfilene inneholder hver elementkatalog én eller to automatisk genererte systemfiler, avhengig av hvilken versjon du bruker:

  • En versjon 1-katalog inneholder item.metadata.json og item.config.json. Med V1 må begge filene være i katalogen.
  • En versjon 2-katalog inneholder .platform. Denne filen inneholder innholdet i både item.metadata.json og item.config.json filer. Hvis du har denne filen, kan du ikke ha de to andre filene. Hvis du bruker versjon 1 og utfører endringer, oppdateres systemfilene automatisk til denne versjonen.

Merk

Katalogen må inneholde enten item.metadata.json filene og item.config.json eller .platform filen. Du kan ikke ha alle tre filene.

Plattformfil

I versjon 2, i stedet for å ha to kildefiler i hver elementkatalog, kombinerer .platform-filen all informasjon i én fil sammen med en $schema egenskap. Hvis du har denne filen, kan du ikke ha de to andre filene.

{
    "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 inneholder følgende attributter:

  • version: Versjonsnummer for systemfilene. Dette tallet brukes til å aktivere bakoverkompatibilitet. Versjonsnummeret for elementet kan være annerledes.
  • logicalId: En automatisk generert identifikator på tvers av arbeidsområder som representerer et element og kildekontrollrepresentasjonen.
  • type: (streng) Elementets type (semantisk modell, rapport osv.)
  • displayName: (streng) Navnet på elementet.
  • description: (valgfri streng) Beskrivelse av elementet.

Merk

  • Typefeltet skiller mellom store og små bokstaver. Ikke endre måten den genereres automatisk på, eller den kan mislykkes.
  • Selv om du vanligvis ikke bør endre logiskId eller visningsnavn for et element, kan ett unntak være hvis du oppretter et nytt element ved å kopiere en eksisterende elementkatalog. I så fall må du endre logisk ID og visningsnavnet til noe unikt i repositoriet.

Relatert innhold

Kom i gang med Git-integrering.