Share via


Power BI Desktop-projektrapportmappe

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.

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

Rapportfiler

.pbi\local Indstillinger.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 finde flere oplysninger i det lokale Indstillinger.json skemadokument.

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.

Når du bruger 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/WorkpaceName;Initial Catalog=SemanticModelName;Integrated Security=ClaimsToken",
      "pbiServiceModelId": null,
      "pbiModelVirtualServerName": "sobe_wowvirtualserver",
      "pbiModelDatabaseName": "e244efd3-e253-4390-be28-6be45d9da47e",
      "connectionType": "pbiServiceXmlaStyleLive",
      "name": null
    }
  }
}

Når den semantiske model og rapport deler det samme arbejdsområde, bruger Fabric Git Integration altid en byPath reference til den semantiske model.

Du kan finde 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

Definerer en rapport, herunder visualiseringer, sidelayout og tilsigtede interaktioner. Denne fil understøtter ikke ekstern redigering under prøveversionen.

.Platform

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.