Del via

Power BI Desktop-projektrapportmappe

  • Artikel

Vigtigt

Power BI Desktop-projekter er i øjeblikket en prøveversion.

I denne artikel beskrives filerne og undermapperne i rapportmappen for et Microsoft Power BI Desktop-projekt. Filerne og undermapperne her repræsenterer en Power BI-rapport. Afhængigt af dit projekt kan rapportmappen indeholde:

1 – Denne fil er påkrævet.
2 – Denne fil er påkrævet, når du gemmer i PBIR-Legacy-format.
3 – Denne fil er påkrævet, når du gemmer i PBIR-format.

Ikke alle projektrapportmapper indeholder alle de filer og undermapper, der er beskrevet her.

Rapportfiler

.pbi\localSettings.jspå

Indeholder rapportindstillinger, der kun gælder for den aktuelle bruger og lokale computer. Den skal inkluderes i gitIgnore eller andre udeladelser af kildekontrol. Som standard ignorerer Git denne fil.

Du kan få flere oplysninger i skemadokumentet localSettings.json.

CustomVisuals\

En undermappe, der indeholder metadata for brugerdefinerede visualiseringer i rapporten. Power BI understøtter tre typer brugerdefinerede visualiseringer:

  • Visualiseringer til organisationslager – organisationer kan godkende og udrulle brugerdefinerede visualiseringer i Power BI for deres organisation. Du kan få mere at vide under Organisationslager.
  • AppSource Power BI-visualiseringer – også kendt som "Offentlige brugerdefinerede visualiseringer". Disse visualiseringer er tilgængelige fra Microsoft AppSource. Rapportudviklere kan installere disse visualiseringer direkte fra Power BI Desktop.
  • Brugerdefinerede visualiseringsfiler – også kendt som "Private custom visuals". Filerne kan indlæses i rapporten ved at uploade en pbiviz-pakke.

Det er kun private brugerdefinerede visualiseringer, der indlæses i mappen CustomVisuals. AppSource- og Organisationsvisualiseringer indlæses automatisk af Power BI Desktop.

Registrerede ressourcer\

En undermappe, der indeholder ressourcefiler, der er specifikke for rapporten, og som indlæses af brugeren, f.eks. brugerdefinerede temaer, billeder og brugerdefinerede visualiseringer (pbiviz-filer).

Udviklere er ansvarlige for filerne her, og ændringer understøttes. Du kan f.eks. ændre en fil, og når en Power BI Desktop er genstartet, indlæses den nye fil i rapporten. Denne mappe kan fjerne blokeringen af nogle nyttige scenarier, f.eks.:

  • Oprettelse af brugerdefinerede temaer uden for Power BI Desktop ved hjælp af det offentlige skema.
  • Anvendelse af batchændringer ved at ændre ressourcefilen i flere rapporter. Du kan f.eks. skifte virksomhedens brugerdefinerede tema, skifte mellem lyse og mørke temaer og ændre logobilleder.

Alle ressourcefiler skal have en tilsvarende post i report.json-filen, som ikke understøtter redigering under prøveversionen . Redigeringer af registrerede ressourcer-filer understøttes kun for allerede indlæste ressourcer, der medfører, at Power BI Desktop registrerer ressourcen i report.json.

semanticModelDiagramLayout.json

Indeholder datamodeldiagrammer, der beskriver strukturen af den semantiske model, der er knyttet til rapporten. Denne fil understøtter ikke ekstern redigering under prøveversionen.

definition.pbir

Indeholder den overordnede definition af en rapport og kerneindstillinger. Denne fil indeholder også referencen til den semantiske model, der bruges af rapporten. Power BI Desktop kan åbne en PBIR-fil direkte på samme måde, som hvis rapporten blev åbnet fra en PBIP-fil. Når du åbner en PBIR-fil, åbnes den semantiske model også sammen med , hvis der er en relativ reference ved hjælp af byPath.

Eksempel på definition.pbir:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    },
    "byConnection": null
  }
}

Definitionen indeholder egenskaben datasetReference , som refererer til den semantiske model, der bruges i rapporten. Referencen kan være enten:

byPath – Angiver en relativ sti til den semantiske destinationsmodelmappe. Absolutte stier understøttes ikke. En skråstreg (/) bruges som mappeseparator. Når power BI Desktop bruges, åbnes den semantiske model også i fuld redigeringstilstand.

byConnection– Angiver en ekstern semantisk model i Power BI-tjeneste ved hjælp af en forbindelsesstreng. Når der bruges en byConnection reference, åbner Power BI Desktop ikke den semantiske model i redigeringstilstand.

Ved hjælp af en byConnection reference skal følgende egenskaber angives:

Egenskab Beskrivelse
connectionString Den forbindelsesstreng, der refererer til den eksterne semantiske model.
pbiModelDatabaseName Det eksterne semantiske model-id.
connectionType Forbindelsestype. For den semantiske tjenestemodel for fjernsemantik skal denne værdi være pbiServiceXmlaStyleLive.
pbiModelVirtualServerName En intern egenskab, der skal have værdien . sobe_wowvirtualserver
pbiServiceModelId En intern egenskab, der skal have værdien . null
Navn En intern egenskab, der skal have værdien . EntityDataSource

Eksempel på brug af byConnection:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": null,
    "byConnection": {
      "connectionString": "Data Source=powerbi://api.powerbi.com/v1.0/myorg/[WorkpaceName];Initial Catalog=[SemanticModelName];Integrated Security=ClaimsToken",
      "pbiServiceModelId": null,
      "pbiModelVirtualServerName": "sobe_wowvirtualserver",
      "pbiModelDatabaseName": "[Semantic Model Id]",
      "connectionType": "pbiServiceXmlaStyleLive",
      "name": "EntityDataSource"
    }
  }
}

Vigtigt

Når du udruller en rapport via Fabric REST API, skal du bruge byConnection referencer.

Når den semantiske model og rapport deler det samme arbejdsområde, bruger Fabric Git Integration altid en byPath reference til den semantiske model. Hvis du vil tvinge rapporten til at åbne i direkte forbindelse (f.eks. arbejde med målinger på rapportniveau), kan du have flere definitions-*.pbir-filer, f.eks. én med en byPath-forbindelse og en anden med en byConnection-forbindelse. Fabric Git Integration behandler kun filen definition.pbir og ignorerer alle andre *.pbir-filer. Disse filer kan dog eksistere i det samme lager.

  ├── definition\
  ├── StaticResources\
  ├── .platform
  ├── definition-liveConnect.pbir
  └── definition.pbir

Denne fil angiver også de understøttede rapportdefinitionsformater via egenskaben 'version'.

Version Understøttede formater
1.0 Rapportdefinitionen skal gemmes som PBIR-Legacy i report.json-filen.
4,0 eller højere Rapportdefinitionen kan gemmes som PBIR-Legacy (report.json-fil) eller PBIR (\definitionsmappe).

Du kan få flere oplysninger i skemadokumentet definition.pbir.

mobileState.json

Indeholder indstillinger for rapportudseende og -funktionsmåde, når der gengives på en mobilenhed. Denne fil understøtter ikke ekstern redigering.

report.json

Denne fil indeholder rapportdefinitionen i Power BI-rapportens ældre format (PBIR-Legacy) og understøtter ikke ekstern redigering.

definition\ mappe

Denne mappe er kun tilgængelig, hvis Power BI-projektet er gemt ved hjælp af Det udvidede rapportformat (PBIR) i Power BI. Den erstatter den report.json fil.

.perron

Fabric-platformfil, der indeholder egenskaber, der er vigtige for at etablere og vedligeholde forbindelsen mellem Fabric-elementer og Git.

Du kan få mere at vide under Automatisk genererede systemfiler til Git-integration.

PBIR-format

Vigtigt

Overvej alle PBIR-begrænsningerne i prøveversionsfasen.

Hvis du gemmer dine Power BI Project-filer (PBIP) ved hjælp af PBIR (Enhanced Report Format) i Power BI, forbedres ændringssporingen og konfliktløsningen betydeligt ved hjælp af korrekt formaterede JSON-filer.

Skærmbillede af brugervenlige PBIR-diffs.

Hver side, visualisering, bogmærke osv. er organiseret i en separat, individuel fil i en mappestruktur. Dette format er ideelt til konfliktløsning i forbindelse med udvikling.

Skærmbillede af brugervenlig PBIR-mappe.

I modsætning til PBIR-Legacy (report.json) er PBIR et offentligt dokumenteret format, der understøtter ændringer fra ikke-Power BI-programmer. Hver fil har et offentligt JSON-skema, som ikke kun dokumenterer filen, men også gør det muligt for kodeeditorer som Visual Studio Code at udføre syntaksvalidering under redigering.

Nogle af de mulige scenarier, der nu er tilgængelige med PBIR, omfatter:

  • Kopiér sider/visualiseringer/bogmærker mellem rapporter.
  • Sørg for ensartethed i et sæt visualiseringer på tværs af alle sider ved at kopiere og indsætte visualiseringsfilerne.
  • Nemt at finde og erstatte på tværs af flere rapportfiler.
  • Anvend en batchredigering på tværs af alle visualiseringer ved hjælp af et script (f.eks. skjul filtre på visualiseringsniveau)

Aktivér prøveversionsfunktion for PBIR-format

Lagring som et Power BI-projekt ved hjælp af PBIR er i øjeblikket en prøveversion. Før du bruger den, skal du aktivere den i prøveversionsfunktionerne i Power BI Desktop:

Gå til Filindstillinger >> Indstillinger > Funktioner til eksempelvisning, og markér afkrydsningsfeltet ud for Gem rapporter ved hjælp af forbedret metadataformat (PBIR).

Gem som et projekt ved hjælp af PBIR

Når PBIR-prøveversionsfunktionen er aktiveret, gemmes rapporten i en mappe med navnet \definition i rapportmappen, når du gemmer et projekt:

Skærmbillede af definitionsmappen i en rapport-PBIP-mappe.

Få mere at vide om PBIR-mappestrukturen.

Konvertér eksisterende rapport til PBIR

Hvis du allerede har et PBIP ved hjælp af PBIR-Legacy-format, kan du konvertere det til PBIR på følgende måde:

  1. Åbn PBIP i Power BI Desktop.

  2. Sørg for, at prøveversionsfunktionen er aktiveret.

  3. Gem projektet. Der vises en prompt, hvor du bliver bedt om at opgradere til PBIR.

  4. Vælg Opgrader.

    Skærmbillede af prompt om opgradering til PBIR.

    Vigtigt

    Når du opgraderer til PBIR, kan du ikke vende tilbage til PBIR-Legacy fra brugergrænsefladen. Hvis du vil vende tilbage til PBIR-Legacy, skal du gemme en kopi af dine PBIP-filer.

    Power BI Desktop opretter automatisk en sikkerhedskopi af rapporten, før du opgraderer til PBIR. Denne sikkerhedskopiering opbevares i 30 dage på en af følgende placeringer:

    • Microsoft Store-version: %USERPROFILE%\Microsoft\Power BI Desktop Store App\TempSaves\Backups
    • Eksekverbar installationsversion: %USERPROFILE%\AppData\Local\Microsoft\Power BI Desktop\TempSaves\Backups

Den eksisterende PBIR-Legacy-fil (report.json) erstattes af en \definition-mappe , der indeholder PBIR-repræsentationen af rapporten.

Hvis du vælger at beholde det aktuelle format, bliver desktop ikke bedt om at opgradere igen.

PBIR-mappe og -filer

Rapportdefinitionen gemmes i definition\ mappen med følgende struktur:

├── bookmarks\
│   ├── [bookmarkName].bookmark.json
|   └── bookmarks.json
├── pages\
│   ├── [pageName]\
│   |   ├── \visuals
|   │   |   ├── [visualName]\
|   |   │   │   |── mobile.json
|   |   |   └   └── visual.json
|   |   └── page.json
|   └── pages.json
├── version.json
├── reportExtensions.json
└── report.json
Fil/mappe Obligatorisk Beskrivelse
Bogmærker\ Nr. Mappe, der indeholder alle bogmærkefiler i rapporten.
── [bookmarkName].bookmark.json Nr. Bogmærkemetadata, f.eks. målvisualiseringer og filtre.
Flere oplysninger i skemaet.
── bookmarks.json Nr. Metadata for bogmærker, f.eks. bogmærkerækkefølge og -grupper.
Flere oplysninger i skemaet.
Sider\ Ja Mappe, der indeholder alle sider i rapporten.
── [pageName]\ Ja Én mappe pr. side.
──── visualiseringer\ Nr. Mappe, der indeholder alle visualiseringer på siden.
────── [visualName]\ Nr. Én mappe pr. visualisering.
──────── mobile.json Nr. Metadata for visuelt mobillayout, f.eks. mobilposition og formatering.
Flere oplysninger i skemaet.
──────── visual.json Ja Visualiseringsmetadata, f.eks. placering og formatering, forespørgsel.
Flere oplysninger i skemaet.
──── page.json Ja Sidemetadata, f.eks. filtre på sideniveau og formatering.
Flere oplysninger i skemaet.
── pages.json Nr. Metadata for sider, f.eks. siderækkefølge og aktiv side.
Flere oplysninger i skemaet.
version.json Ja PBIR-filversionen bestemmer blandt andet, hvilke filer der skal indlæses.
Flere oplysninger i skema
reportExtensions.json Nr. Rapportudvidelser, f.eks. målinger på rapportniveau.
Flere oplysninger i skema
report.json Ja Rapportmetadata, f.eks. filtre på rapportniveau og formatering.
Flere oplysninger i skema

Vigtigt

Nogle rapportmetadatafiler, f.eks. visual.json eller bookmarks.json, kan gemmes med dataværdier fra din semantiske model. Hvis du f.eks. anvender et filter på en visualisering for feltet 'Firma' = 'Contoso', bevares værdien 'Contoso' som en del af metadataene. Dette gælder også for andre konfigurationer, f.eks. valg af udsnit, matrixens brugerdefinerede kolonners bredde og formatering for bestemte serier.

PBIR-navngivningskonvention

Alle navne i kantede parenteser ([]) i den foregående tabel følger en standardkonvention for navngivning, men kan omdøbes til mere brugervenlige navne. Som standard bruger sider, visualiseringer og bogmærker navnet på deres rapportobjekt som fil- eller mappenavn. Disse objektnavne er indledningsvist et entydigt id på 20 tegn, f.eks. '90c2e07d84e7d5c026'.

Skærmbillede af egenskaben PBIR-navn.

Omdøbning af egenskaben 'name' i hver JSON-fil understøttes, men kan ødelægge eksterne referencer både i og uden for rapporten. Objektnavnet og/eller navnet på filen/mappen skal bestå af et eller flere ordtegn (bogstaver, cifre, understregningstegn) eller bindestreger.

Når du har omdøbt PBIR-filer eller -mapper, skal du genstarte Power BI Desktop. Ved genstart bevarer Power BI Desktop de oprindelige fil- eller mappenavne, når der gemmes.

Kopiér rapportobjektnavn

Hvert objekt i rapporten gemmes i en separat mappe eller fil, men navnet på mappen er ikke altid indlysende. For at gøre det nemmere kan du kopiere navnet på et hvilket som helst rapportobjektnavn (herunder sider, visualiseringer, bogmærker og filtre) direkte fra Power BI til udklipsholderen.

Skærmbillede af en rapport med en pil, der peger fra en af visualiseringerne til navnet på den tilsvarende fil.

  1. Gå til Filindstillinger >> Rapportindstillinger > Rapportobjekter, og aktivér indstillingen Kopiér objektnavne, når du højreklikker på rapportobjekter . Dette skal kun gøres én gang.

    Skærmbillede af rapportobjekternes rapportindstillinger.

  2. Højreklik på et rapportobjekt, og vælg Kopiér objektnavn.

    Skærmbillede af en skrivebordsrapport med kopiobjektnavnet valgt.

Når objektnavnet er kopieret til Udklipsholder, kan du nemt angive det i søgelinjen i Windows Stifinder eller Visual Studio Code for at finde eller identificere objektnavnet i PBIR-mappen.

Skærmbillede af søgelinjen med navnet på objektet.

PBIR Json-skemaer

Hver PBIR JSON-fil indeholder en JSON-skemaerklæring øverst i dokumentet. Denne SKEMA-URL-adresse er offentligt tilgængelig og kan bruges til at få mere at vide om de tilgængelige egenskaber og objekter for hver fil. Derudover giver den indbygget IntelliSense og validering, når du redigerer med kodeeditorer som Visual Studio Code.

Skærmbillede af værktøjstippet til PBIR JSON-skemaet.

Skema-URL-adressen definerer også dokumentets version, som forventes at blive ændret, efterhånden som rapportdefinitionen udvikler sig.

Alle JSON-skemaer publiceres her.

PBIR-anmærkninger

Du kan inkludere anmærkninger som navneværdipar i rapportdefinitionen for hver visualog pagereport. Selvom Power BI Desktop ignorerer disse anmærkninger, kan de være værdifulde for eksterne programmer, f.eks. scripts.

Du kan f.eks. angive standardsiden for rapporten i report.json filen, som derefter kan bruges af et installationsscript.

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/report/1.0.0/schema.json",
  "themeCollection": {
    "baseTheme": {
      "name": "CY24SU06",
      "reportVersionAtImport": "5.55",
      "type": "SharedResources"
    }
  },
  ...
  "annotations": [
    {
      "name": "defaultPage",
      "value": "c2d9b4b1487b2eb30e98"
    }
  ]
}

Eksterne ændringer af PBIR-filer

Du kan redigere PBIR JSON-filerne ved hjælp af en kodeeditor, f.eks . Visual Studio Code eller et eksternt værktøj, så længe filen overholder JSON-skemaet. Brug af et forkert egenskabsnavn eller en forkert type kan nemt registreres direkte i Visual Studio Code:

Skærmbillede af prompten PBIR JSON-skemavalidering.

Eksterne ændringer af PBIR-indhold kan medføre fejl, når filerne i Power BI Desktop åbnes igen. Disse fejl kan være af to typer:

Blokeringsfejl forhindrer Power BI Desktop i at åbne rapporten. Disse fejl hjælper med at identificere problemet og den fejlende fil, der skal rettes, før du åbner igen:

Skærmbillede af prompten om PBIR-blokeringsfejl.

Fejl som f.eks. et ugyldigt skema eller manglende påkrævede egenskaber anses for at være blokerende fejl. Disse fejl kan nemt identificeres ved at åbne filen i Visual Studio Code og undersøge skemafejlene.

Ikke-blokerende fejl forhindrer ikke Power BI Desktop i at åbne rapporten og løses automatisk.

Skærmbillede af prompten om, at PBIR ikke blokerer fejl.

Fejl som f.eks. en ugyldig activePageName-konfiguration er eksempler på fejl, der ikke blokeres, og som løses automatisk. Advarslen er nødvendig for at give dig mulighed for at undgå at gemme rapporten med autofix, ved at forhindre eventuelle tab af arbejde.

Almindelige PBIR-fejl

Scenarie:Når du har omdøbt navne på visualiseringer eller sidemapper, vises min visualisering eller side ikke længere, når rapporten åbnes.

Løsning: Kontrollér, om navnet overholder navngivningskonventionen. Hvis den ikke gør det, ignorerer Power BI Desktop filen eller mappen og behandler den som private brugerfiler.

Scenarie:Nye rapportobjekter navngives forskelligt fra andre. De fleste sidemapper kaldes f.eks. 'ReportSection0e71dafbc949c0853608', mens nogle få kaldes '1b3c2ab12b603618070b'.

Løsning: PBIR har vedtaget en ny navngivningskonvention for hvert objekt, men den gælder kun for nye objekter. Når du gemmer en eksisterende rapport som PBIP, skal de aktuelle navne bevares for at forhindre afbrydelse af referencer. Hvis du vil have ensartethed, tillades et script til en batch omdøbning.

Scenarie:Jeg kopierede en bogmærkefil, og da jeg gemte, blev det meste af bogmærkekonfigurationen slettet.

Løsning: Denne funktionsmåde er bevidst. Rapportbogmærker registrerer tilstanden for en rapportside sammen med alle dens visualiseringer. Da den hentede tilstand stammer fra en anden rapportside med forskellige visualiseringer, fjernes alle ugyldige visualiseringer fra bogmærkekonfigurationen. Hvis du også kopierer de afhængige visualiseringer og siden, bevarer bogmærket konfigurationen.

Scenarie:Jeg har kopieret en sidemappe fra en anden rapport og stødte på en fejl med teksten "Værdier for egenskaben 'pageBinding.name' skal være entydige."

Løsning: Objektet pageBinding er nødvendigt for at understøtte detaljeadgang og sideværktøjstip. Da der kan refereres til dem på andre sider, skal navnet være entydigt i rapporten. På den nyligt kopierede side skal du tildele en entydig værdi for at løse fejlen. Efter juni 2024 er denne situation ikke længere et problem, fordi pageBinding-navnet som standard er et GUID.

PBIR-overvejelser og -begrænsninger

PBIR er i øjeblikket en prøveversion. Vær opmærksom på følgende begrænsninger:

  • Tjenestebegrænsninger/fejl
  • Store rapporter med mere end 500 filer oplever problemer med oprettelse af ydeevne (rapportvisning påvirkes ikke), herunder:
    • Lagring i Power BI Desktop
    • Synkronisering i Fabric Git Integration
  • Når en rapport konverteres fra PBIR-Legacy til PBIR, er det ikke muligt at annullere den. Selvom der oprettes en sikkerhedskopi på konverteringstidspunktet.
  • Konvertering af en PBIP-fil til en PBIX-fil ved hjælp af funktionen "Gem som" integrerer PBIR-rapporten i PBIX-filen, så alle PBIR-begrænsninger overføres til PBIX.

Begrænsninger for PBIR-størrelse, der gennemtvinges af tjenesten:

  • Maks. 1.000 sider pr. rapport.
  • Maks. 300 visualiseringer pr. side.
  • Maks. 5 mb for hver bogmærkefil.
  • Maks. 1 mb for hver fil.
  • Maks. 1.000 ressourcepakkefiler pr. rapport.
  • Maksimal størrelse på 300 mb for alle ressourcepakkefiler.
  • Maks. 20 mb for alle rapportfiler.

Fabric Git Integration og Fabric REST API'er eksporterer rapporter ved hjælp af det format, der aktuelt anvendes i tjenesten. Hvis en rapport oprettes eller importeres til Fabric ved hjælp af PBIR-formatet, eksporteres den i PBIR. På samme måde eksporteres en rapport i formatet PBIR-Legacy, hvis den er PBIR-Legacy.

Relateret indhold