Share via

Rapportmapp för Power BI Desktop-projekt

  • Artikel

Viktigt!

Power BI Desktop-projekt är för närvarande i förhandsversion.

Den här artikeln beskriver filerna och undermapparna i ett Microsoft Power BI Desktop-projekts rapportmapp . Filerna och undermapparna här representerar en Power BI-rapport. Beroende på ditt projekt kan rapportmappen innehålla:

1 – Den här filen krävs.

Alla projektrapportmappar innehåller inte alla filer och undermappar som beskrivs här.

Rapportfiler

.pbi\local Inställningar.json

Innehåller rapportinställningar som endast gäller för den aktuella användaren och den lokala datorn. Det bör ingå i gitIgnore eller andra undantag för källkontroll. Som standard ignorerar Git den här filen.

Mer information finns i det lokala Inställningar.json schemadokumentet.

CustomVisuals\

En undermapp som innehåller metadata för anpassade visuella objekt i rapporten. Power BI stöder tre typer av anpassade visuella objekt:

  • Visuella objekt för organisationsarkiv – Organisationer kan godkänna och distribuera anpassade visuella objekt till Power BI för sin organisation. Mer information finns i Organisationsarkiv.
  • Visuella Power BI-objekt i AppSource – kallas även "Offentliga anpassade visuella objekt". Dessa visuella objekt är tillgängliga från Microsoft AppSource. Rapportutvecklare kan installera dessa visuella objekt direkt från Power BI Desktop.
  • Anpassade visuella filer – kallas även "Privata anpassade visuella objekt". Filerna kan läsas in i rapporten genom att ladda upp ett pbiviz-paket.

Endast privata anpassade visuella objekt läses in i mappen CustomVisuals. Visuella appkällor och organisationsobjekt läses in automatiskt av Power BI Desktop.

RegisteredResources\

En undermapp som innehåller resursfiler som är specifika för rapporten och som läses in av användaren, till exempel anpassade teman, bilder och anpassade visuella objekt (pbiviz-filer).

Utvecklare ansvarar för filerna här och ändringar stöds. Du kan till exempel ändra en fil och efter en omstart av Power BI Desktop läses den nya filen in i rapporten. Den här mappen kan avblockera några användbara scenarier, till exempel:

  • Redigera anpassade teman utanför Power BI Desktop med hjälp av det offentliga schemat.
  • Tillämpa batchändringar genom att ändra resursfilen i flera rapporter. Du kan till exempel växla företagets anpassade tema, ändra mellan ljusa och mörka teman och ändra logotypbilder.

Varje resursfil måste ha en motsvarande post i report.json-filen, som under förhandsversionen inte stöder redigering. Ändringar i RegisteredResources-filer stöds endast för redan inlästa resurser som gör att Power BI Desktop registrerar resursen i report.json.

semanticModelDiagramLayout.json

Innehåller datamodelldiagram som beskriver strukturen för den semantiska modell som är associerad med rapporten. Under förhandsversionen stöder den här filen inte extern redigering.

definition.pbir

Innehåller den övergripande definitionen av en rapport och grundläggande inställningar. Den här filen innehåller också referensen till den semantiska modell som används av rapporten. Power BI Desktop kan öppna en pbir-fil direkt, precis som om rapporten öppnades från en pbip-fil. Om du öppnar en pbir öppnas även semantikmodellen tillsammans med om det finns en relativ referens med .byPath

Exempeldefinition.pbir:

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

Definitionen innehåller egenskapen datasetReference som refererar till den semantiska modell som används i rapporten. Referensen kan vara antingen:

byPath – Anger en relativ sökväg till målsemantikmodellmappen. Absoluta sökvägar stöds inte. Ett snedstreck (/) används som mappavgränsare. När den används öppnar Power BI Desktop även den semantiska modellen i fullständigt redigeringsläge.

byConnection– Anger en fjärrsemantisk modell i Power BI-tjänst med hjälp av en anslutningssträng. När en byConnection referens används öppnar Inte Power BI Desktop semantikmodellen i redigeringsläge.

När du använder en byConnection referens måste följande egenskaper anges:

Property Beskrivning
Connectionstring Den anslutningssträng som refererar till fjärrsemantikmodellen.
pbiModelDatabaseName Fjärr-semantisk modell-ID.
connectionType Typ av anslutning. För tjänstens fjärrsemantiska modell ska det här värdet vara pbiServiceXmlaStyleLive.
pbiModelVirtualServerName En intern egenskap som ska ha värdet , sobe_wowvirtualserver.

Exempel med :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 semantiska modellen och rapporten delar samma arbetsyta använder Fabric Git Integration alltid en byPath referens till den semantiska modellen.

Mer information finns i schemadokumentet definition.pbir.

mobileState.json

Innehåller inställningar för rapportutseende och beteende vid återgivning på en mobil enhet. Den här filen stöder inte extern redigering.

report.json

Definierar en rapport, inklusive visuella objekt, sidlayout och avsedda interaktioner. Under förhandsversionen stöder den här filen inte extern redigering.

.Plattform

Infrastrukturplattformsfil som innehåller egenskaper som är viktiga för att upprätta och underhålla anslutningen mellan Fabric-objekt och Git.

Mer information finns i Git-integrering automatiskt genererade systemfiler.

Relaterat innehåll