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

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, å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

Eksempel på brug af byConnection:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": null,
    "byConnection": {
      "connectionString": "Data Source=powerbi://api.powerbi.com/v1.0/myorg/[Workspace Name];Initial Catalog=[Semantic Model Name];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. Det er dog kun filen definition.pbir, der ignoreres, når definitionen importeres via Fabric Git.

  ├── 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 nyere 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 PBIP 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. Hvis du mener, at du måske vil vende tilbage til PBIR-Legacy, skal du først gemme en kopi af dine PBIP-filer.

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.

Publicer en PBIR-rapport til tjeneste

Mens du er i prøveversionsfasen , er den eneste måde at publicere en rapport med PBIR-formatet på via Fabric Git Integration. Dette omfatter oprettelse af forbindelse mellem arbejdsområdet og et Git-lager og pushning af PBIR-rapporten til det, som derefter kan synkroniseres med tjenestearbejdsområdet på et senere tidspunkt.

Hvis du vil konvertere en eksisterende rapport til PBIR i tjenesten, skal du følge disse trin:

  1. Opret forbindelse mellem dit arbejdsområde og Git.
  2. Klon Git-lageret til dit lokale filsystem.
  3. Åbn rapporten i Power BI Desktop ved at åbne definition.pbir filen.
  4. Gem rapporten, og vælg at opgradere til PBIR.
  5. Bekræft og synkroniser ændringerne i Git.
  6. Opdater arbejdsområdet med de seneste ændringer fra Git.

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.

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 punkter:

  • Tjenestebegrænsninger/fejl
    • Mobilvisninger vises ikke i Power BI-apps.
    • Skjulte sider vises i Navigation i Power BI Apps.
    • Kan ikke installeres med udrulningspipelines.
    • Kan ikke gemmes som en kopi.
    • Power BI-rapport-API'er kan ikke bruges: Klon rapportOpdater rapportindhold
  • 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.
  • 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.

I den offentlige prøveversion bruger Fabric Git Integration og Fabric REST API'er fortsat PBIR-Legacy (report.json), når rapportdefinitionerne eksporteres. Men hvis rapporten importeres til Fabric ved hjælp af PBIR-format, begynder begge funktioner at eksportere rapportdefinitionen ved hjælp af PBIR-format.

Relateret indhold