Del via

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.

Navn på mappe

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:
  • 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):

Skærmbillede af liste over elementer i et Fabric-arbejdsområde.

Følgende mapper oprettes i Git-lageret:

Skærmbillede af navnene på Git-mapperne, der indeholder Fabric-elementerne.

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

Indhold i vejvisere

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:

Spejlede databaser

Spejlede databasemapper indeholder en .jsonfil, der definerer den spejlede database.

Du kan finde oplysninger om brug af Git-integration med spejlede databaser under CI/CD for spejlede databaser.

Notesbøger filer

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

Rapportér filer

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.pbism
  • \definition mappe med TMDL-filer

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.

Note

Din mappe skal indeholde enten og-filerne item.metadata.jsonitem.config.jsoneller.platform filen. Du kan ikke have alle tre filer.

Platform fil

I version 2 kombinerer .platform-filen alle oplysninger i én fil sammen med en $schema egenskab i stedet for at have to kildefiler i hver elementmappe. 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: (streng) Et automatisk genereret id på tværs af arbejdsområder, der repræsenterer et element og dets versionsstyringsrepræsentation.
  • type: (streng) Elementets type (semantisk model, rapport osv.)
  • displayName: (streng) Navnet på elementet.
  • description: (valgfri streng) Beskrivelse af elementet.

Hvis du omdøber artefaktet i arbejdsområdet, og artefaktmappen i Git har suffikset '.', vil mappenavnet og i Git matche efter displayName bekræftelsen.

LogicalId forbinder et element i et arbejdsområde med dets tilsvarende element i en Git-forgrening. Elementer med de samme logicalId'er antages at være de samme. LogicalId bevarer kæden, selvom navnet eller mappen ændres. Da en forgrening kan synkroniseres til flere arbejdsområder, er det muligt at have elementer i forskellige arbejdsområder med det samme logicalId, men et enkelt arbejdsområde kan ikke have to elementer med det samme logicalId. LogicalId oprettes, når arbejdsområdet er forbundet til en Git-forgrening, eller når et nyt element synkroniseres. LogicalId er nødvendig, for at Git-integration kan fungere korrekt. Derfor er det vigtigt ikke at ændre det på nogen måde.

Note

Når du bekræfter ændringer i Git i version 1, opdateres systemfilerne automatisk til version 2 sammen med ændringerne. Alle nye filer, der eksporteres fra Udviklertilstand i Power BI Desktop, gemmes også i filformatet version 2.

Note

  • Der skelnes mellem 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 bør ændre logicalId eller visningsnavnet på 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 visningsnavnet til noget unikt i lageret.

Relateret indhold

Kom i gang med Git-integration.

  • Last updated on