Rapportmapp för Power BI Desktop-projekt
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:
- .Pbi\
- CustomVisuals\
- StaticResources\
- semanticModelDiagramLayout.json
- definition.pbir1
- mobileState.json
- report.json 1
- .Plattform
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
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för