Power BI Desktop projekt rapportmapp

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

• .pbi\
  • localSettings.json
• CustomVisuals\
• StaticResources\
  • RegisteredResources\
• semanticModelDiagramLayout.json
• definition.pbir¹
• mobileState.json
• report.json²
• definitionmapp³
• .plattform

1 – Den här filen krävs.
2 – Den här filen krävs när du sparar till PBIR-Legacy format.
3 – Den här filen krävs när du sparar till PBIR-format.

Det är inte varje projektmapp som inkluderar alla filer och undermappar som beskrivs här.

Rapportfiler

.pbi\localSettings.jspå

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 versionskontroll. Som standard ignorerar Git den här filen.

Mer information finns i schemadokumentet förlocalSettings.json.

CustomVisuals\

En undermapp som innehåller metadata för anpassade grafiska element i rapporten. Power BI stödjer tre typer av anpassade bilder:

• Organisatoriska butiksvyer - Organisationer kan godkänna och distribuera anpassade visuella element till Power BI för deras organisation. Mer information finns i Organisationsarkiv.
• AppSource Power BI visuals - Även kända som "Offentliga anpassade visualiseringar". Dessa visualiseringar finns tillgängliga från Microsoft AppSource. Rapportutvecklare kan installera dessa visuella direkt från Power BI Desktop.
• Anpassade visuella filer - Även kända som "Privata anpassade visuella". Filerna kan laddas in i rapporten genom att ladda upp ett pbiviz-paket.

Endast privata anpassade bilder läses in i mappen CustomVisuals. AppSource och organisationsvisualiseringar laddas automatiskt av Power BI Desktop.

RegisteredResources\

En undermapp som innehåller resursfiler specifika för rapporten och laddade av användaren, som anpassade teman, bilder och anpassade visuella element (pbiviz-filer).

Utvecklare ansvarar för filerna här och ändringar stöds. Till exempel kan du ändra en fil och efter en omstart av Power BI Desktop laddas den nya filen in i rapporten. Den här mappen kan låsa upp några användbara scenarier, såsom:

• Författande av anpassade teman utanför Power BI Desktop genom att använda den offentliga schemat.
• Tillämpa batchändringar genom att ändra resursfilen på flera rapporter. Till exempel kan du byta företagsanpassat tema, ändra mellan ljusa och mörka teman, och ändra logobilder.

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 datamodell diagram som beskriver strukturen av den semantiska modellen som är kopplad till rapporten. Under förhandsversionen stöder den här filen inte extern redigering.

definition.pbir

Innehåller den övergripande definitionen av en rapport och grundinställningar. Denna fil 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. När du öppnar en PBIR-fil öppnas den semantiska modellen också samtidigt om det finns en relativ referens som använder byPath.

Exempelddefinition.pbir

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    }    
  }
}

Definitionen inkluderar egenskapen datasetReference, som hänvisar till den semantiska modellen som används i rapporten. Referensen kan vara antingen:

byPath - Anger en relativ sökväg till mappen för den semantiska modellen. Absoluta sökvägar stöds inte. Ett snedstreck (/) används som en mapavskiljare. När det används öppnar Power BI Desktop också den semantiska modellen i fullt redigeringsläge.

byConnection – Specificerar anslutningen till en semantisk modell i en Fabric-arbetsyta med hjälp av en anslutningssträng. När en byConnection-referens används öppnar Power BI Desktop inte den semantiska modellen i redigeringsläge.

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "Data Source=\"powerbi://api.powerbi.com/v1.0/myorg/[WorkpaceName]\";initial catalog=[SemanticModelName];access mode=readonly;integrated security=ClaimsToken;semanticmodelid=[SemanticModelId]"
    }
  }
}

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "semanticmodelid=[SemanticModelId]"
    }
  }
}

{
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/1.0.0/schema.json",
    "version": "4.0",
    "datasetReference": {  
      "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"
      }
  }
}

Flera *.pbir-filer

När den semantiska modellen och rapporten delar samma arbetsyta exporterar Fabric Git Integration alltid definitioner med en byPath referens till semantikmodellen. Om du vill tvinga rapporten att öppnas i live-anslutning (till exempel för att arbeta med mått på rapportnivå) kan du ha flera definitionsfiler*.pbir,till exempel en med en byPath-anslutning och en annan med en byConnection-anslutning. Fabric Git-integrering bearbetar endast filen definition.pbir och ignorerar alla andra *.pbir-filer. Dessa filer kan dock samexistera på samma lagringsplats.

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

Filen definition.pbir anger också de rapportdefinitionsformat som stöds via egenskapen "version".

Mer information finns i schemadokumentet definition.pbir.

mobileState.json

Innehåller inställningar för rapportens utseende och beteende när den visas på en mobil enhet. Den här filen stöder inte extern redigering.

report.json

Denna fil innehåller rapportdefinitionen i Power BI Report Legacy-formatet (PBIR-Legacy) och stöder inte extern redigering.

definition\ mapp

Den här mappen är endast tillgänglig om Power BI-projektet sparas med hjälp av Power BI:s förbättrade rapportformat (PBIR). Den ersätter filenreport.json .

.plattform

Fil för Fabric-plattformen som innehåller egenskaper som är avgörande för att etablera och upprätthålla anslutningen mellan Fabric-objekt och Git.

Mer information finns i Git-integrering automatiskt genererade systemfiler.

PBIR-format

Att spara dina Power BI-projektfiler (PBIP) med hjälp av Power BI Enhanced Report Format (PBIR) förbättrar avsevärt spårningen av ändringar och lösningen av konfliktvid hopslagning genom att använda korrekt formaterade JSON-filer.

Varje sida, visuell, bokmärke, etc., är organiserad i en separat, individuell fil inom en mappstruktur. Det här formatet är idealiskt för konfliktlösning i samutveckling.

Till skillnad från PBIR-Legacy (report.json) är PBIR ett offentligt dokumenterat format som stöder ändringar från applikationer som inte är Power BI. Varje fil har ett offentligt JSON-schema som inte bara dokumenterar filen utan också låter kodredigerare som Visual Studio Code utföra syntaxvalidering under redigeringen.

Några av de möjliga scenarier som nu finns tillgängliga med PBIR inkluderar:

• Kopiera sidor/visualiseringar/bokmärken mellan rapporter.
• Säkerställ att en uppsättning visuella element är konsekventa över alla sidor genom att kopiera och klistra in de visuella filerna.
• Enkel sökning och ersättning över flera rapportfiler.
• Använd en batchredigering för alla visualiseringar med hjälp av ett skript (till exempel, dölj visuella nivåfilter)

Aktivera förhandsgranskningsfunktionen för PBIR-format

Spara som Power BI-rapporter med PBIR är för närvarande i förhandsversion. Innan du använder det, aktivera det i Power BI Desktops förhandsvisningsfunktioner.

För PBIP-filer (Power BI Project):

1. Gå till Arkiv > Alternativ och inställningar > Alternativ > Förhandsgranskningsfunktioner.
2. Markera kryssrutan Lagra rapporter med förbättrat metadataformat (PBIR).

För PBIX-filer:

1. Gå till Arkiv > Alternativ och inställningar > Alternativ > Förhandsgranskning funktioner.
2. Markera kryssrutan Store PBIR-rapporter med förbättrat metadataformat (PBIR).

Genom att aktivera PBIR för PBIX ser du till att PBIR-formatet också sparas i PBIX-filer, inte bara i Pbip-filer (Power BI Project).

Spara som ett projekt med PBIR

Med funktionen PBIR Preview aktiverad sparas rapporten i en mapp med namnet \definition i rapportmappen när du sparar ett projekt:

Läs mer om PBIR-mappstrukturen.

Konvertera befintlig rapport till PBIR

Om du redan har en PBIP som använder PBIR-Legacy-format, kan du konvertera den till PBIR enligt följande:

1. Öppna PBIP i Power BI Desktop.

2. Se till att förhandsgranskningsfunktionen är aktiverad.

3. Spara projektet. En uppmaning visas som ber dig att uppgradera till PBIR.

4. Välj Uppgradera.

   

   Viktigt

   När du har uppgraderat till PBIR kan du inte återgå till PBIR-Legacy från användargränssnittet. Om du vill återgå till PBIR-Legacy sparar du en kopia av PBIP-filerna.

   Power BI Desktop skapar automatiskt en säkerhetskopia av rapporten innan du uppgraderar till PBIR. Den här säkerhetskopian behålls i 30 dagar på någon av följande platser:

   • Microsoft Store-version: %USERPROFILE%\Microsoft\Power BI Desktop Store App\TempSaves\Backups
   • Körbar installationsprogramversion: %USERPROFILE%\AppData\Local\Microsoft\Power BI Desktop\TempSaves\Backups

Den befintliga PBIR-Legacy filen (report.json) ersätts med en \definitionsmapp som innehåller PBIR-representationen av rapporten.

Om du väljer Behåll aktuellt format uppmanas inte Desktop att uppgradera igen.

PBIR-mapp och filer

Rapportdefinitionen är lagrad i definition\-mappen med följande 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

PBIR-namngivningskonvention

Alla namn inom hakparenteserna ([]) i den föregående tabellen följer en standardnamngivningskonvention men kan bytas ut till mer användarvänliga namn. Som standard använder sidor, bilder och bokmärken sina rapportobjektsnamn som sina fil- eller mappnamn. Dessa objektnamn är ursprungligen en 20-tecken unik identifierare, såsom '90c2e07d8e84e7d5c026'.

Att byta namn på egenskapen 'name' i varje JSON-fil stöds, men det kan bryta externa referenser både inom och utanför rapporten. Objektets namn och/eller fil-/mappnamn måste bestå av ett eller flera ordtecken (bokstäver, siffror, understreck) eller bindestreck.

Efter att ha bytt namn på några PBIR-filer eller mappar måste du starta om Power BI Desktop. Vid omstart kommer Power BI Desktop att bevara de ursprungliga fil- eller mappnamnen vid sparning.

Kopiera rapportobjektnamnet

Varje objekt i rapporten sparas i en separat mapp eller fil, men namnet på mappen är inte alltid uppenbart. För att göra detta enklare kan du kopiera namnet på rapportobjektets namn (inklusive sidor, visuella objekt, bokmärken och filter) direkt från Power BI till Urklipp.

PBIR Json-scheman

Varje PBIR JSON-fil innehåller en JSON-schemadeklaration överst i dokumentet. Denna schemalänk är offentligt tillgänglig och kan användas för att lära sig mer om de tillgängliga egenskaperna och objekten för varje fil. Dessutom ger den inbyggd IntelliSense och validering när du redigerar med kodredigerare som Visual Studio Code.

Schemat URL definierar också dokumentets version, som förväntas ändras när rapportdefinitionen utvecklas.

Alla JSON-scheman publiceras här.

PBIR-anteckningar

Du kan inkludera annoteringar som namn-värdepar inom rapportdefinitionen för varje visual, page och report. Även om Power BI Desktop ignorerar dessa anteckningar kan de vara värdefulla för externa program som skript.

Till exempel kan du ange defaultPage för rapporten i report.json-filen, vilket sedan kan användas av ett distributionsskript.

{
  "$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"
    }
  ]
}

Externa ändringar av PBIR-filer

Du kan redigera PBIR JSON-filerna med hjälp av en kodredigerare som Visual Studio Code eller ett externt verktyg, så länge filen följer JSON-schemat. Att använda ett felaktigt egenskapsnamn eller en felaktig typ kan enkelt upptäckas direkt i Visual Studio Code.

Externa ändringar av PBIR-innehåll kan resultera i fel när filerna öppnas igen i Power BI Desktop. Dessa fel kan vara av två typer:

Blockeringsfel hindrar Power BI Desktop från att öppna rapporten. Dessa fel hjälper till att identifiera problemet och den felaktiga filen som måste åtgärdas innan den öppnas igen.

Fel som ett ogiltigt schema eller saknade obligatoriska egenskaper betraktas som blockerande fel. De där felen kan enkelt identifieras genom att öppna filen i Visual Studio Code och inspektera schemafelen.

Icke-blockerande fel hindrar inte Power BI Desktop från att öppna rapporten och löses automatiskt.

Fel som en ogiltig activePageName-konfiguration är exempel på icke-blockeringsfel som korrigeras automatiskt. Varningen är nödvändig för att ge dig möjligheten att undvika att spara rapporten med autofix, och därmed förhindra eventuell förlust av arbete.

Vanliga PBIR-fel

Scenario:När du har bytt namn på namn på visuella objekt eller sidmappar visas inte längre mitt visuella objekt eller min sida när rapporten öppnas.

Lösning: Kontrollera om namnet uppfyller namngivningskonventionen. Om det inte gör det, ignorerar Power BI Desktop filen eller mappen och behandlar den som privata användarfiler.

Scenario:Nya rapportobjekt namnges på ett annat sätt än andra. De flesta sidmappar heter till exempel "ReportSection0e71dafbc949c0853608", medan några få heter "1b3c2ab12b603618070b".

Lösning: PBIR antog en ny namngivningskonvention för varje objekt, men den gäller bara för nya objekt. När du sparar en befintlig rapport som PBIP måste de nuvarande namnen bevaras för att förhindra att referenser bryts. Om du vill ha konsekvens är ett skript för batch-omdöpning tillåtet.

Scenario:Jag kopierade en bokmärkesfil och när jag sparade den togs merparten av bokmärkeskonfigurationen bort.

Lösning: Det här beteendet är avsiktligt, rapportbokmärken samlar in tillståndet för en rapportsida tillsammans med alla dess visuella objekt. Eftersom det fångade tillståndet härstammar från en annan rapportsida med olika visuella element, tas alla ogiltiga visuella element bort från bokmärkeskonfigurationen. Om du också kopierar de beroende bilderna och sidan, behåller bokmärket sin konfiguration.

Scenario:Jag kopierade en sidmapp från en annan rapport och påträffade ett fel med texten "Värden för egenskapen "pageBinding.name" måste vara unika.

Lösning: PageBinding-objektet är nödvändigt för att stödja drillthrough och sidverktygstips. Eftersom de kan hänvisas till av andra sidor måste namnet vara unikt inom rapporten. På den nytillkopierade sidan, tilldela ett unikt värde för att lösa felet. Efter juni 2024 är detta inte längre ett problem eftersom pageBinding-namnet är ett GUID som standard.

PBIR överväganden och begränsningar

PBIR är för närvarande i förhandsversion. Tänk på följande:

• Omfattande rapporter med mer än 500 filer kan uppleva prestandaproblem vid författande (rapportvisning påverkas inte).
• När en rapport har konverterats från PBIR-Legacy till PBIR går det inte att återställa den. Även om en säkerhetskopia skapas vid tidpunkten för konverteringen.
• Att konvertera en PBIP-fil till en PBIX-fil med funktionen "Spara som" bäddar in PBIR-rapporten i PBIX-filen, vilket innebär att alla PBIR-begränsningar följer med till PBIX.
• Automatiska visuella filter sparas endast i PBIR-filen visual.json när filterfönstret har expanderats minst en gång när rapporten redigeras.

Begränsningar av PBIR-storlek som verkställs av tjänsten:

• 1,000 maximalt antal sidor per rapport.
• 1 000 maximalt antal visuella objekt per sida.
• Maximalt 1 000 resurs paketfiler per rapport.
• Maxstorlek på 300 mb för alla resurspaketfiler.
• Maximal storlek på 300 mb för alla rapportfiler.

Fabric Git Integration och Fabric REST API:er exporterar rapporter med det format som för närvarande används i tjänsten. Om en rapport skapas eller importeras i Fabric med hjälp av PBIR-formatet, exporteras den i PBIR. På samma sätt exporteras den i PBIR-Legacy format om en rapport är PBIR-Legacy.

Relaterat innehåll

• Power BI Desktop-projektsemantisk modellmapp
• Power BI Desktop-projekt