Rapportmappe for Power BI Desktop-prosjekt
Viktig
Power BI Desktop-prosjekter er for øyeblikket i forhåndsversjon.
Denne artikkelen beskriver filene og undermappene i rapportmappen for et Microsoft Power BI Desktop-prosjekt. Filene og undermappene her representerer en Power BI-rapport. Rapportmappen kan omfatte følgende, avhengig av prosjektet:
- .pbi\
- CustomVisuals\
- StaticResources\
- semanticModelDiagramLayout.json
- definition.pbir1
- mobileState.json
- report.json 2
- definisjon\ mappe3
- .plattform
1 – Denne filen kreves.
2 – Denne filen kreves når du lagrer i PBIR-eldre format.
3 – Denne filen kreves når du lagrer til PBIR-format.
Ikke alle prosjektrapportmapper inneholder alle filene og undermappene som er beskrevet her.
Rapportfiler
.pbi\localSettings.json
Inneholder rapportinnstillinger som bare gjelder for gjeldende bruker og lokal datamaskin. Den bør inkluderes i gitIgnore eller andre utelukkelser for kildekontroll. Som standard ignorerer Git denne filen.
Hvis du vil ha mer informasjon, kan du se localSettings.json skjemadokument.
CustomVisuals\
En undermappe som inneholder metadata for egendefinerte visualobjekter i rapporten. Power BI støtter tre typer egendefinerte visualobjekter:
- Visualobjekter for organisasjonslager – Organisasjoner kan godkjenne og distribuere egendefinerte visualobjekter til Power BI for organisasjonen. Hvis du vil ha mer informasjon, kan du se Organisasjonslager.
- AppSource Power BI-visualobjekter – også kjent som «Offentlige egendefinerte visualobjekter». Disse visualobjektene er tilgjengelige fra Microsoft AppSource. Rapportutviklere kan installere disse visualobjektene direkte fra Power BI Desktop.
- Egendefinerte visualobjektfiler – også kalt «Private egendefinerte visualobjekter». Filene kan lastes inn i rapporten ved å laste opp en pbiviz-pakke.
Bare private egendefinerte visualobjekter lastes inn i CustomVisuals-mappen. AppSource- og Organisasjonsvisualobjekter lastes automatisk inn av Power BI Desktop.
RegisteredResources\
En undermappe som inneholder ressursfiler som er spesifikke for rapporten og lastet inn av brukeren, for eksempel egendefinerte temaer, bilder og egendefinerte visualobjekter (pbiviz-filer).
Utviklere er ansvarlige for filene her, og endringene støttes. Du kan for eksempel endre en fil, og etter en omstart av Power BI Desktop lastes den nye filen inn i rapporten. Denne mappen kan oppheve blokkeringen av noen nyttige scenarioer, for eksempel:
- Redigere egendefinerte temaer utenfor Power BI Desktop ved hjelp av det offentlige skjemaet.
- Bruk av satsvise endringer ved å endre ressursfilen på flere rapporter. Du kan for eksempel bytte det egendefinerte temaet for firmaet, endre mellom lyse og mørke temaer og endre logobilder.
Hver ressursfil må ha en tilsvarende oppføring i report.json-filen, som ikke støtter redigering under forhåndsvisning . Endringer i RegisteredResources-filer støttes bare for allerede innlastede ressurser som fører til at Power BI Desktop registrerer ressursen i report.json.
semanticModelDiagramLayout.json
Inneholder datamodelldiagrammer som beskriver strukturen til den semantiske modellen som er knyttet til rapporten. Under forhåndsvisningen støtter ikke denne filen ekstern redigering.
definition.pbir
Inneholder den generelle definisjonen av en rapport og kjerneinnstillinger. Denne filen inneholder også referansen til den semantiske modellen som brukes av rapporten. Power BI Desktop kan åpne en pbir-fil direkte, akkurat det samme som om rapporten ble åpnet fra en pbip-fil. Når du åpner en pbir, åpnes også semantisk modell sammen med hvis det er en relativ referanse ved hjelp av byPath
.
Eksempeldefinisjon.pbir:
{
"version": "1.0",
"datasetReference": {
"byPath": {
"path": "../Sales.Dataset"
},
"byConnection": null
}
}
Definisjonen inkluderer egenskapen datasetReference
, som refererer til den semantiske modellen som brukes i rapporten. Referansen kan være enten:
byPath
– Angir en relativ bane til målmappen for semantisk modell. Absolutte baner støttes ikke. En skråstrek (/) brukes som mappeskilletegn. Når den brukes, åpner Power BI Desktop også den semantiske modellen i full redigeringsmodus.
byConnection
– Angir en ekstern semantisk modell i Power Bi-tjeneste ved hjelp av en tilkoblingsstreng. Når en byConnection
referanse brukes, åpner ikke Power BI Desktop den semantiske modellen i redigeringsmodus.
Følgende egenskaper må angis ved hjelp av en byConnection
referanse:
Egenskap | Beskrivelse |
---|---|
connectionString | Den tilkoblingsstreng som refererer til den eksterne semantiske modellen. |
pbiModelDatabaseName | Den eksterne semantiske modell-ID-en. |
connectionType | Type tilkobling. For tjeneste ekstern semantisk modell, bør denne verdien være pbiServiceXmlaStyleLive . |
pbiModelVirtualServerName | En intern egenskap som skal ha verdien. sobe_wowvirtualserver |
Eksempel ved hjelp av 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": "[Semantic Model Id]",
"connectionType": "pbiServiceXmlaStyleLive",
"name": "EntityDataSource"
}
}
}
Viktig
Når du distribuerer en rapport gjennom FABRIC REST API må du bruke byConnection
referanser.
Når den semantiske modellen og rapporten deler samme arbeidsområde, bruker Fabric Git Integration alltid en byPath
referanse til den semantiske modellen. Hvis du vil tvinge rapporten til å åpnes i live-tilkobling (for eksempel for å arbeide med mål på rapportnivå), kan du ha flere definisjon*.pbir-filer, for eksempel én med en byPath-tilkobling og en annen med en byConnection-tilkobling. Fabric Git Integration behandler bare definition.pbir-filen og ignorerer alle andre *.pbir-filer. Disse filene kan imidlertid eksistere samtidig i samme repositorium.
├── definition\
├── StaticResources\
├── .platform
├── definition-liveConnect.pbir
└── definition.pbir
Denne filen angir også de støttede rapportdefinisjonsformatene gjennom versjonsegenskapen.
Versjon | Støttede formater |
---|---|
1.0 | Rapportdefinisjonen må lagres som PBIR-Legacy i report.json-filen. |
4.0 eller nyere | Rapportdefinisjonen kan lagres som PBIR-Legacy (report.json-fil) eller PBIR (\definisjonsmappe). |
Hvis du vil ha mer informasjon, kan du se xml-skjemadokumentet definition.pbir.
mobileState.json
Inneholder innstillinger for rapportutseende og virkemåte når du gjengir på en mobil enhet. Denne filen støtter ikke ekstern redigering.
report.json
Denne filen inneholder rapportdefinisjonen i Power BI Report Legacy-formatet (PBIR-Legacy) og støtter ikke ekstern redigering.
definisjon\ mappe
Denne mappen er bare tilgjengelig hvis Power BI-prosjektet lagres ved hjelp av det utvidede rapportformatet for Power BI (PBIR). Den erstatter report.json filen.
.plattform
Stoffplattformfil som inneholder egenskaper som er avgjørende for å etablere og vedlikeholde forbindelsen mellom Stoffelementer og Git.
Hvis du vil ha mer informasjon, kan du se Git-integrering automatisk genererte systemfiler.
PBIR-format
Hvis du lagrer Power BI-prosjektfilene (PBIP) ved hjelp av Power BI Enhanced Report Format (PBIR), forbedres endringssporing og sammenslåing av konfliktløsning ved hjelp av riktig formaterte JSON-filer.
Hver side, visualobjekt, bokmerke osv., er organisert i en separat, individuell fil i en mappestruktur. Dette formatet er ideelt for konfliktløsning med samtidig utvikling.
I motsetning til PBIR-Legacy (report.json) er PBIR et offentlig dokumentert format som støtter endringer fra ikke-Power BI-programmer. Hver fil har et offentlig JSON-skjema, som ikke bare dokumenterer filen, men lar også koderedigeringsprogrammene som Visual Studio Code utføre syntaksvalidering under redigering.
Noen av de mulige scenariene som nå er tilgjengelige med PBIR inkluderer:
- Kopier sider/visualobjekter/bokmerker mellom rapporter.
- Sikre konsekvens for et sett med visualobjekter på tvers av alle sider, ved å kopiere og lime inn de visuelle filene.
- Enkel søk og erstatt på tvers av flere rapportfiler.
- Bruke en satsvis redigering på tvers av alle visualobjekter ved hjelp av et skript (for eksempel skjule filtre for visuelt nivå)
Aktiver forhåndsvisningsfunksjon for PBIR-format
Lagring som et Power BI-prosjekt ved hjelp av PBIR er for øyeblikket i forhåndsversjon. Før du bruker den, kan du aktivere den i forhåndsvisningsfunksjonene i Power BI Desktop:
Gå til filalternativer > og innstillinger > Alternativer > Forhåndsvisningsfunksjoner , og merk av i boksen ved siden av Store-rapporter ved hjelp av utvidet metadataformat (PBIR).
Lagre som et prosjekt ved hjelp av PBIR
Når PBIR Preview-funksjonen er aktivert, lagres rapporten i en mappe med navnet \definition i rapportmappen når du lagrer et prosjekt:
Mer informasjon om PBIR-mappestruktur.
Konverter eksisterende PBIP til PBIR
Hvis du allerede har en PBIP ved hjelp av PBIR-eldre format, kan du konvertere den til PBIR på følgende måte:
Åpne PBIP i Power BI Desktop.
Kontroller at forhåndsvisningsfunksjonen er aktivert.
Lagre prosjektet. En melding vises der du blir bedt om å oppgradere til PBIR.
Velg Oppgrader.
Viktig
Når du oppgraderer til PBIR, kan du ikke gå tilbake til PBIR-Legacy. Hvis du tror du vil gå tilbake til PBIR-Legacy, lagrer du en kopi av PBIP-filene først.
Den eksisterende PBIR-eldre filen (report.json) erstattes med en \definition-mappe som inneholder PBIR-representasjonen av rapporten.
Hvis du velger å beholde gjeldende format, blir ikke skrivebordsversjonen bedt om å oppgradere på nytt.
Publisere en PBIR-rapport til tjeneste
Mens du er i forhåndsvisningsfasen, er den eneste måten å publisere en rapport med PBIR-formatet på, gjennom Fabric Git Integration. Dette innebærer å koble arbeidsområdet til et Git-repositorium og skyve PBIR-rapporten til den, som deretter kan synkroniseres med tjenestearbeidsområdet på et senere tidspunkt.
Hvis du vil konvertere en eksisterende rapport til PBIR i tjenesten, følger du disse trinnene:
- Koble arbeidsområdet til Git.
- Klon Git-repositoriet til det lokale filsystemet.
- Åpne rapporten i Power BI Desktop ved å åpne
definition.pbir
filen. - Lagre rapporten, og velg å oppgradere til PBIR.
- Utfør og synkroniser endringene til Git.
- Oppdater arbeidsområdet med de siste endringene fra Git.
PBIR-mappe og -filer
Rapportdefinisjonen definition\
lagres i 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 | Kreves | Beskrivelse |
---|---|---|
Bokmerker\ | No | Mappe som inneholder alle bokmerkefilene i rapporten. |
── [bookmarkName].bookmark.json | No | Bokmerkemetadata, for eksempel målvisualobjekter og filtre. Mer informasjon i skjemaet. |
── bookmarks.json | No | Metadata for bokmerker, for eksempel bokmerkerekkefølge og grupper. Mer informasjon i skjemaet. |
Sider\ | Ja | Mappe som holder alle sidene i rapporten. |
── [pageName]\ | Ja | Én mappe per side. |
──── visualobjekter\ | No | Mappe som holder alle visualobjekter på siden. |
────── [visualName]\ | No | Én mappe per visualobjekt. |
──────── mobile.json | No | Metadata for visuelt mobiloppsett, for eksempel mobil posisjon og formatering. Mer informasjon i skjemaet. |
──────── visual.json | Ja | Visuelle metadata, for eksempel posisjon og formatering, spørring. Mer informasjon i skjemaet. |
──── page.json | Ja | Sidemetadata, for eksempel filtre og formatering på sidenivå. Mer informasjon i skjemaet. |
── pages.json | No | Sider metadata, for eksempel siderekkefølge og aktiv side. Mer informasjon i skjemaet. |
version.json | Ja | PBIR-filversjon bestemmer blant annet de nødvendige filene som skal lastes inn. Mer informasjon på skjema |
reportExtensions.json | No | Rapportutvidelser, for eksempel mål på rapportnivå. Mer informasjon på skjema |
report.json | Ja | Rapportmetadata, for eksempel filtre og formatering på rapportnivå. Mer informasjon på skjema |
Viktig
Noen rapportmetadatafiler, for eksempel visual.json eller bookmarks.json, kan lagres med dataverdier fra den semantiske modellen. Hvis du for eksempel bruker et filter på et visualobjekt for feltet Firma = Contoso, beholdes verdien Contoso som en del av metadataene. Dette gjelder også for andre konfigurasjoner som slicervalg, bredde på egendefinerte matriser og formatering for bestemte serier.
PBIR-navnekonvensjon
Alle navn i hakeparentesene ([]) i den forrige tabellen følger en standard navnekonvensjon, men kan gis nytt navn til mer brukervennlige navn. Som standard bruker sider, visualobjekter og bokmerker navnet på rapportobjektet som fil- eller mappenavn. Disse objektnavnene er i utgangspunktet en unik identifikator på 20 tegn, for eksempel 90c2e07d8e84e7d5c026.
Navneegenskapen i hver JSON-fil støttes, men kan bryte eksterne referanser både i og utenfor rapporten. Objektnavnet og/eller navnet på filen/mappen må bestå av ett eller flere ordtegn (bokstaver, sifre, understrekingstegn) eller bindestreker.
Når du har gi nytt navn til PBIR-filer eller -mapper, må du starte Power BI Desktop på nytt. Når du starter på nytt, beholder Power BI Desktop de opprinnelige fil- eller mappenavnene når du lagrer.
PBIR Json-skjemaer
Hver PBIR JSON-fil inneholder en JSON-skjemadeklarasjon øverst i dokumentet. Denne URL-adressen for skjema er offentlig tilgjengelig og kan brukes til å lære mer om de tilgjengelige egenskapene og objektene for hver fil. I tillegg gir den innebygd IntelliSense og validering når du redigerer med koderedigeringsprogram som Visual Studio Code.
SKJEMA-URL-adressen definerer også versjonen av dokumentet, som forventes å endres etter hvert som rapportdefinisjonen utvikler seg.
Alle JSON-skjemaene er publisert her.
PBIR-merknader
Du kan inkludere merknader som navneverdipar i rapportdefinisjonen for hver visual
, page
og report
. Selv om Power BI Desktop ignorerer disse merknadene, kan de være verdifulle for eksterne programmer som skript.
Du kan for eksempel angi standardsiden for rapporten i report.json
filen, som deretter kan brukes av et distribusjonsskript.
{
"$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 endringer i PBIR-filer
Du kan redigere PBIR JSON-filene ved hjelp av et koderedigeringsprogram som Visual Studio Code eller et eksternt verktøy, så lenge filen følger JSON-skjemaet. Bruk av feil egenskapsnavn eller -type kan enkelt oppdages direkte i Visual Studio Code:
Eksterne endringer i PBIR-innhold kan føre til feil ved gjenåpning av filene i Power BI Desktop. Disse feilene kan være av to typer:
Blokkeringsfeil hindrer Power BI Desktop i å åpne rapporten. Disse feilene bidrar til å identifisere problemet og den fornærmende filen som må løses før du åpner på nytt:
Feil, for eksempel et ugyldig skjema eller manglende nødvendige egenskaper, anses som blokkeringsfeil. Disse feilene kan enkelt identifiseres ved å åpne filen i Visual Studio Code og undersøke skjemafeilene.
Feil som ikke blokkerer , hindrer ikke Power BI Desktop i å åpne rapporten og løses automatisk.
Feil som en ugyldig activePageName-konfigurasjon er eksempler på feil som ikke blokkeres automatisk. Advarselen er nødvendig for å gi deg muligheten til å unngå å lagre rapporten med autofikset, ved å forhindre potensielt tap av arbeid.
Vanlige PBIR-feil
Scenario:Når du har gitt navn til visualobjekt- eller sidemappenavn, vises ikke lenger visualobjektet eller siden når du åpner rapporten.
Løsning: Kontroller om navnet er i samsvar med navnekonvensjonen. Hvis den ikke gjør det, ignorerer Power BI Desktop filen eller mappen og behandler den som private brukerfiler.
Scenario:Nye rapportobjekter navngis annerledes enn andre. De fleste sidemapper heter for eksempel ReportSection0e71dafbc949c0853608, mens noen heter '1b3c2ab12b603618070b'.
Løsning: PBIR har vedtatt en ny navnekonvensjon for hvert objekt, men gjelder bare for nye objekter. Når du lagrer en eksisterende rapport som PBIP, må gjeldende navn bevares for å hindre brudd på referanser. Hvis du vil ha konsekvens, tillates et skript et gruppenavn.
Scenario:Jeg kopierte en bokmerkefil, og ved lagring ble mesteparten av bokmerkekonfigurasjonen slettet.
Løsning: Denne virkemåten er tilsiktet, rapportbokmerker fanger opp tilstanden til en rapportside sammen med alle visualobjektene. Siden den registrerte tilstanden stammer fra en annen rapportside med forskjellige visualobjekter, fjernes eventuelle ugyldige visualobjekter fra bokmerkekonfigurasjonen. Hvis du også kopierer de avhengige visualobjektene og siden, opprettholder bokmerket konfigurasjonen.
Scenario:Jeg kopierte en sidemappe fra en annen rapport og oppdaget en feil som sier: «Verdier for egenskapen pageBinding.name må være unike.»
Løsning: PageBinding-objektet er nødvendig for å støtte ekstrahering og sideverktøytips. Siden de kan refereres til av andre sider, må navnet være unikt i rapporten. Tilordne en unik verdi for å løse feilen på den nylig kopierte siden. Etter juni 2024 er ikke denne situasjonen lenger et problem fordi pageBinding-navnet er en GUID som standard.
PBIR-vurderinger og begrensninger
PBIR er for øyeblikket i forhåndsversjon. Husk følgende:
- Tjenestebegrensninger/feil
- Kan ikke distribueres med utrullingssamlebånd.
- Kan ikke lagres som en kopi.
- Kan ikke bruke rapport-API-er for Power BI: Klon rapport, oppdatere rapportinnhold
- Store rapporter med mer enn 500 filer opplever problemer med redigering av ytelse (rapportvisning påvirkes ikke), inkludert:
- Lagre i Power BI Desktop
- Synkronisering i Git-integrering av stoff
- Når en rapport er konvertert fra PBIR-Legacy til PBIR, er det ikke mulig å rulle den tilbake.
- Hvis du konverterer en PBIP-fil til en PBIX-fil ved hjelp av «Lagre som»-funksjonen, bygges PBIR-rapporten inn i PBIX-filen og overfører alle PBIR-begrensninger til PBIX.
Begrensninger for PBIR-størrelse håndheves av tjenesten:
- 1000 maksimale sider per rapport.
- 300 maksimale visualobjekter per side.
- 5 mb maks for hver bokmerkefil.
- 1 mb maks for hver fil.
- 1000 maksimale ressurspakkefiler per rapport.
- Maksimal størrelse på 300 mb for alle ressurspakkefiler.
- 20 mb maksimal størrelse på alle rapportfiler.
Under den offentlige forhåndsvisningen fortsetter Fabric Git Integration og Fabric REST API-er å bruke PBIR-Legacy (report.json) når de eksporterer rapportdefinisjonene. Hvis rapporten imidlertid importeres til Fabric ved hjelp av PBIR-format, begynner begge funksjonene å eksportere rapportdefinisjonen ved hjelp av PBIR-format.