Power BI Desktopin projektiraporttikansio

Tärkeä

Power BI Desktop -projektit ovat tällä hetkellä esikatseluvaiheessa.

Tässä artikkelissa kuvataan Microsoft Power BI Desktop -projektin Raportti-kansion tiedostot ja alikansiot. Tässä olevat tiedostot ja alikansiot edustavat Power BI -raporttia. Projektista riippuen raporttikansioon voivat kuulua seuraavat:

• .pbi\
  • localSettings.json
• CustomVisuals\
• StaticResources\
  • RegisteredResources\
• semanticModelDiagramLayout.json
• definition.pbir¹
• mobileState.json
• ^{report.json 2}
• definition\ folder³
• .lava

1 – Tämä tiedosto vaaditaan.
2 – Tämä tiedosto vaaditaan, kun tallennat PBIR-Legacy-muotoon.
3 – Tämä tiedosto vaaditaan, kun tallennat PBIR-muotoon.

Kaikki projektiraporttikansiot eivät sisällä kaikkia tässä kuvattuja tiedostoja ja alikansioita.

Raporttitiedostot

.pbi\localSettings.json

Sisältää raporttiasetukset, jotka koskevat vain nykyistä käyttäjää ja paikallista tietokonetta. Se tulee sisällyttää GitIgnoreen tai muihin lähdekoodin hallinnan ulkopuolelle. Git ohittaa tämän tiedoston oletusarvoisesti.

Lisätietoja on localSettings.json rakenneasiakirjassa.

CustomVisuals\

Alikansio, joka sisältää raportin mukautettujen visualisointien metatiedot. Power BI tukee kolmenlaisia mukautettuja visualisointeja:

• Organisaation säilön visualisoinnit: organisaatiot voivat hyväksyä ja ottaa käyttöön mukautettuja visualisointeja organisaatiossaan Power BI:ssä. Lisätietoja on kohdassa Organisaation säilö.
• AppSourcen Power BI -visualisoinnit – Tunnetaan myös nimellä "Julkiset mukautetut visualisoinnit". Nämä visualisoinnit ovat käytettävissä Microsoft AppSourcesta. Raporttien kehittäjät voivat asentaa nämä visualisoinnit suoraan Power BI Desktopista.
• Mukautetut visualisointitiedostot – Kutsutaan myös "yksityisiksi mukautetuiksi visualisoinneiksi". Tiedostot voidaan ladata raporttiin lataamalla pbiviz-paketti.

Vain yksityiset mukautetut visualisoinnit ladataan CustomVisuals-kansioon. Power BI Desktop lataa AppSourcen ja organisaation visualisoinnit automaattisesti.

RegisteredResources\

Alikansio, joka sisältää raporttiin liittyvät ja käyttäjän lataamat resurssitiedostot, kuten mukautetut teemat, kuvat ja mukautetut visualisoinnit (pbiviz-tiedostot).

Kehittäjät ovat vastuussa täällä tiedostoista ja muutoksia tuetaan. Voit esimerkiksi muuttaa tiedostoa, ja kun Power BI Desktop on käynnistetty uudelleen, uusi tiedosto ladataan raporttiin. Tämä kansio voi estoa joitakin hyödyllisiä skenaarioita, kuten:

• Mukautettujen teemojen luominen Power BI Desktopin ulkopuolella julkisen rakenteen avulla.
• Erämuutosten käyttö muuttamalla resurssitiedostoa useissa raporteissa. Voit esimerkiksi vaihtaa yrityksen mukautettua teemaa, vaihtaa vaalean ja tumman teeman välillä ja muuttaa logokuvia.

Jokaisessa resurssitiedostossa on oltava vastaava merkintä report.json-tiedostossa, mikä esikatselun aikana ei tue muokkaamista. RegisteredResources-tiedostojen muokkauksia tuetaan vain jo ladatuille resursseille, joiden vuoksi Power BI Desktop rekisteröi resurssin report.json.

semanticModelDiagramLayout.json

Sisältää tietomallikaavioita, jotka kuvaavat raporttiin liittyvän semanttisen mallin rakennetta. Esikatselun aikana tämä tiedosto ei tue ulkoista muokkaamista.

definition.pbir

Sisältää raportin yleisen määrityksen ja tärkeimmät asetukset. Tämä tiedosto sisältää myös viittauksen raportin käyttämään semanttiseen malliin. Power BI Desktop voi avata pbir-tiedoston suoraan samalla tavalla kuin jos raportti olisi avattu pbip-tiedostosta. Pbir:n avaaminen avaa myös semanttisen mallin, jos käytössä byPathon suhteellinen viittaus.

Esimerkki definition.pbir:

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

Määritys sisältää -ominaisuuden datasetReference , joka viittaa raportissa käytettyun semanttiseen malliin. Viittaus voi olla jokin seuraavista:

byPath - Määrittää suhteellisen polun semanttisen kohdemallin kansioon. Absoluuttisia polkuja ei tueta. Vinoviivaa (/) käytetään kansioerottimena. Käytettäessä Power BI Desktop avaa myös semanttisen mallin täydessä muokkaustilassa.

byConnection – Määrittää semanttisen etämallin Power BI -palvelussa yhteysmerkkijonon avulla. Kun viittausta byConnection käytetään, Power BI Desktop ei avaa semanttista mallia muokkaustilassa.

Viittauksen byConnection avulla on määritettävä seuraavat ominaisuudet:

Ominaisuus	Kuvaus
connectionString	Semanttiseen etämalliin viittaavä yhteysmerkkijono.
pbiModelDatabaseName	Semanttinen etämallitunnus.
connectionType	Yhteystyyppi. Palvelun semanttisen etämallin arvon tulee olla pbiServiceXmlaStyleLive.
pbiModelVirtualServerName	Sisäinen ominaisuus, jonka arvon sobe_wowvirtualserverpitäisi olla .

Esimerkki:n käytöstä byConnection:

{
  "version": "1.0",
  "datasetReference": {
    "byPath": null,
    "byConnection": {
      "connectionString": "Data Source=powerbi://api.powerbi.com/v1.0/myorg/[Workspace Name];Initial Catalog=[Semantic Model Name];Integrated Security=ClaimsToken",
      "pbiServiceModelId": null,
      "pbiModelVirtualServerName": "sobe_wowvirtualserver",
      "pbiModelDatabaseName": "[Semantic Model Id]",
      "connectionType": "pbiServiceXmlaStyleLive",
      "name": "EntityDataSource"
    }
  }
}

Tärkeä

Kun raportti otetaan käyttöön Fabric REST -ohjelmointirajapinnan sinun on käytettävä byConnection viittauksia.

Kun semanttinen malli ja raportti jakavat saman työtilan, Fabric Git -integrointi käyttää byPath aina viittausta semanttiseen malliin. Jos haluat pakottaa raportin avautumaan reaaliaikaisessa yhteydessä (esimerkiksi raporttitason mittareiden kanssa), sinulla voi olla useita definition*.pbir-tiedostoja, kuten yksi byPath-yhteydellä ja toinen Yhteys-yhteydellä. Kuitenkin vain definition.pbir-tiedostoa ei jätetä huomioimatta, kun määritys tuodaan Fabric Gitin kautta.

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

Tämä tiedosto määrittää myös tuetut raportin määritysmuodot version-ominaisuuden kautta.

Versio	Tuetut muodot
1.0	Raporttimääritelmä on tallennettava report.json tiedostoon muodossa PBIR-Legacy.
4.0 tai uudempi	Raportin määritelmä voidaan tallentaa muodossa PBIR-Legacy (report.json-tiedosto) tai PBIR (\definition folder).

Lisätietoja on definition.pbir-rakenneasiakirjassa.

mobileState.json

Sisältää raportin ulkoasun ja toiminta-asetukset, kun hahmonnettaessa mobiililaitteessa. Tämä tiedosto ei tue ulkoista muokkaamista.

report.json

Tämä tiedosto sisältää raportin määrityksen Power BI -raportin vanhassa muodossa (PBIR-Legacy), eikä se tue ulkoista muokkaamista.

definition\ kansio

Tämä kansio on käytettävissä vain, jos Power BI -projekti tallennetaan käyttämällä Power BI:n parannettua raporttimuotoa (PBIR). Se korvaa report.json tiedoston.

.lava

Fabric-alustatiedosto, joka sisältää Fabric-kohteiden ja Gitin välisen yhteyden muodostamisen ja ylläpitämisen kannalta olennaiset ominaisuudet.

Lisätietoja on artikkelissa Git-integrointi automaattisesti luodut järjestelmätiedostot.

PBIR-muoto

Tärkeä

Ota huomioon kaikki PBIR :n rajoitukset esikatseluvaiheessa.

Power BI -projektitiedostojen (PBIP) tallentaminen Käyttämällä Power BI:n parannettua raporttimuotoa (PBIR) parantaa merkittävästi muutosten seurantaa ja ristiriitojen ratkaisemisen yhdistämistä käyttämällä oikein muotoiltuja JSON-tiedostoja.

Jokainen sivu, visualisointi, kirjanmerkki jne. on järjestetty erilliseksi tiedostoksi kansiorakenteen sisällä. Tämä muoto sopii erinomaisesti rinnakkaiskehityksen ristiriitojen ratkaisuun.

Toisin kuin PBIR-Legacy (report.json), PBIR on julkisesti dokumentoitu muoto, joka tukee muiden kuin Power BI -sovellusten muutoksia. Jokaisella tiedostolla on julkinen JSON-rakenne, joka sisältää tiedoston asiakirjojen lisäksi myös koodieditorit, kuten Visual Studio Code, voivat suorittaa syntaksin tarkistuksen muokkaamisen aikana.

PBIR:n kanssa nyt käytettävissä olevia mahdollisia skenaarioita ovat esimerkiksi seuraavat:

• Kopioi sivuja, visualisointeja/kirjanmerkkejä raporttien välillä.
• Varmista visualisointien joukon yhdenmukaisuus kaikilla sivuilla kopioimalla ja liittämällä visualisointitiedostot.
• Helppo löytää ja korvata useiden raporttitiedostojen välillä.
• Erän muokkauksen käyttö kaikissa visualisoinneissa komentosarjan avulla (esimerkiksi visuaalisen tason suodattimien piilottaminen)

Ota PBIR-muodon esikatseluominaisuus käyttöön

Tallentaminen Power BI -projektina PBIR:tä käyttämällä on tällä hetkellä esikatseluvaiheessa. Ennen kuin käytät sitä, ota se käyttöön Power BI Desktopin esiversio-ominaisuuksissa:

Siirry >> ja valitse ruutu Kohdan Tallenna raportit käyttäen parannettua metatietomuotoa (PBIR)>.

Tallenna projektina PBIR:n avulla

Kun PBIR:n esikatseluominaisuus on käytössä, kun tallennat projektin, raportti tallennetaan kansioon nimeltä \definition raporttikansion sisällä:

Lue lisätietoja PBIR-kansiorakenteesta.

Muunna olemassa oleva PBIP PBIR:ksi

Jos sinulla on jo PBIP PBIR-vanhassa muodossa, voit muuntaa sen PBIR:ksi seuraavasti:

1. Avaa PBIP Power BI Desktopissa.

2. Varmista, että esikatseluominaisuus on käytössä.

3. Tallenna projekti. Näyttöön tulee kehote, jossa sinua pyydetään päivittämään PBIR:hen.

4. Valitse Päivitä.

   

   Tärkeä

   Kun päivität PBIR:iin, et voi palata takaisin PBIR-Legacy-versioon. Jos haluat ehkä palauttaa tiedoston PBIR-Legacy, tallenna ensin PBIP-tiedostojen kopio.

Olemassa oleva PBIR-vanha tiedosto (report.json) korvataan \definition-kansiolla, joka sisältää raportin PBIR-esityksen.

Jos valitset Säilytä nykyinen muoto, Desktop ei kehota päivittää uudelleen.

Julkaise PBIR-raportti palveluun

Esikatseluvaiheessa ainoa tapa julkaista PBIR-muotoinen raportti on Fabric Git -integrointi. Tähän kuuluu työtilan yhdistäminen Git-säilöön ja PBIR-raportin lähettäminen siihen, joka voidaan sitten synkronoida palvelutyötilan kanssa myöhemmässä vaiheessa.

Jos haluat muuntaa olemassa olevan raportin palvelussa PBIR:ksi, toimi seuraavasti:

1. Yhdistä työtila Gitiin.
2. Kloonaa Git-säilö paikalliseen tiedostojärjestelmään.
3. Avaa raportti Power BI Desktopissa avaamalla definition.pbir tiedosto.
4. Tallenna raportti ja päivitä PBIR-versioon.
5. Vahvista ja synkronoi git-muutokset.
6. Päivitä git-työtilan uusimmat muutokset.

PBIR-kansio ja tiedostot

Raportin määritys tallennetaan -kansioon definition\ käyttäen seuraavaa rakennetta:

├── bookmarks\
│   ├── [bookmarkName].bookmark.json
|   └── bookmarks.json
├── pages\
│   ├── [pageName]\
│   |   ├── \visuals
|   │   |   ├── [visualName]\
|   |   │   │   |── mobile.json
|   |   |   └   └── visual.json
|   |   └── page.json
|   └── pages.json
├── version.json
├── reportExtensions.json
└── report.json

Tiedosto/kansio	Pakollinen	Kuvaus
Kirjanmerkit\	En	Kansio, joka sisältää kaikki raportin kirjanmerkkitiedostot.
?= [kirjanmerkkinimi].bookmark.json	En	Kirjanmerkkien metatiedot, kuten kohdevisualisoinnit ja suodattimet. Lisätietoja rakenne sisältää lisätietoja.
?( bookmarks.json	En	Kirjanmerkkien metatiedot, kuten kirjanmerkkien järjestys ja ryhmät. Lisätietoja rakenne sisältää lisätietoja.
Sivut\	Kyllä	Kansio, joka sisältää raportin kaikki sivut.
?= [pageName]\	Kyllä	Yksi kansio sivua kohden.
??^( visualisoinnit\	En	Kansio, joka sisältää kaikki sivun visualisoinnit.
────── [visualName]\	En	Yksi kansio visualisointia kohden.
──────── mobile.json	En	Visualisoinnin mobiiliasettelun metatiedot, kuten mobiilisijainti ja muotoilu. Lisätietoja rakenne sisältää lisätietoja.
──────── visual.json	Kyllä	Visuaaliset metatiedot, kuten sijainti ja muotoilu, kysely. Lisätietoja rakenne sisältää lisätietoja.
???( page.json	Kyllä	Sivun metatiedot, kuten sivutason suodattimet ja muotoilu. Lisätietoja rakenne sisältää lisätietoja.
?( pages.json	En	Sivujen metatiedot, kuten sivujärjestys ja aktiivinen sivu. Lisätietoja rakenne sisältää lisätietoja.
version.json	Kyllä	Muun muassa PBIR-tiedoston versio määrittää ladattavat vaaditut tiedostot. Lisätietoja rakenteessa
reportExtensions.json	En	Raporttilaajennukset, kuten raporttitason mittarit. Lisätietoja rakenteessa
report.json	Kyllä	Raportin metatiedot, kuten raporttitason suodattimet ja muotoilu. Lisätietoja rakenteessa

Tärkeä

Joitakin raportin metatietotiedostoja, kuten visual.json tai bookmarks.json, voidaan tallentaa semanttisen mallisi tietoarvojen kanssa. Jos esimerkiksi käytät suodatinta visualisoinnissa kentälle "Yritys" = "Contoso", arvo "Contoso" säilyy osana metatietoja. Tämä koskee myös muita määrityksiä, kuten osittajavalintoja, matriisin mukautettujen sarakkeiden leveyttä ja tietyn sarjan muotoilua.

PBIR-nimeämiskäytäntö

Kaikkien hakasulkeiden sisällä olevien nimien ([]) nimet noudattavat oletusarvoista nimeämiskäytäntöä, mutta ne voidaan nimetä uudelleen helppokäyttöisempinä niminä. Sivut, visualisoinnit ja kirjanmerkit käyttävät oletusarvoisesti raporttiobjektin nimeä tiedostona tai kansionimenä. Nämä objektien nimet ovat aluksi 20-merkkinen yksilöivä tunniste, kuten '90c2e07d8e84e7d5c026'.

Kunkin JSON-tiedoston name-ominaisuuden nimeämistä uudelleen tuetaan, mutta se saattaa rikkoa ulkoiset viittaukset sekä raportin sisällä että sen ulkopuolella. Objektin nimessä ja/tai tiedoston/kansion nimessä on oltava vähintään yksi sanamerkki (kirjaimet, numerot, alaviivat) tai tavuviivat.

Kun olet uudelleennimennyt PBIR-tiedostot tai -kansiot, sinun on käynnistettävä Power BI Desktop uudelleen. Uudelleenkäynnistyksen jälkeen Power BI Desktop säilyttää alkuperäisen tiedoston tai kansion nimet tallennettaessa.

PBIR Json -rakenteet

Jokainen PBIR JSON -tiedosto sisältää JSON-rakenne-esittelyn asiakirjan yläosassa. Tämä rakenteen URL-osoite on julkisesti käytettävissä, ja sen avulla voit lukea lisätietoja kunkin tiedoston käytettävissä olevista ominaisuuksista ja objekteista. Lisäksi se tarjoaa sisäisen IntelliSense- ja vahvistustoiminnon, kun sitä muokataan koodieditoreissa, kuten Visual Studio Codessa.

Rakenteen URL-osoite määrittää myös tiedoston version, jonka odotetaan muuttuvan raportin määrityksen kehittyessä.

Kaikki JSON-rakenteet julkaistaan täällä.

PBIR-huomautukset

Voit sisällyttää merkintöjä nimi–arvo-pareina raporttimääritykseen kullekin visualpage kohteelle ja report. Vaikka Power BI Desktop jättää nämä huomautukset huomiotta, ne voivat olla arvokkaita ulkoisille sovelluksille, kuten komentosarjoilla.

Voit esimerkiksi määrittää raportin oletussivun report.json tiedostossa, jota voidaan sitten käyttää käyttöönottokomentosarjassa.

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

PBIR-tiedostojen ulkoiset muutokset

Voit muokata PBIR JSON -tiedostoja koodieditorissa, kuten Visual Studio Codessa tai ulkoisessa työkalussa, kunhan tiedosto noudattaa JSON-rakennetta. Väärän ominaisuuden nimen tai tyypin käyttö voidaan helposti tunnistaa suoraan Visual Studio Codessa:

PBIR-sisällön ulkoiset muutokset saattavat aiheuttaa virheitä, kun tiedostot avataan uudelleen Power BI Desktopissa. Nämä virheet voivat olla kahdenlaisia:

Virheiden estäminen estää Power BI Desktopia avaamasta raporttia. Nämä virheet auttavat tunnistamaan ongelman ja loukkaavan tiedoston, joka on korjattava ennen uudelleen avaamista:

Virheellisen rakenteen tai puuttuvien vaadittujen ominaisuuksien kaltaisia virheitä pidetään virheenä. Nämä virheet on helppo tunnistaa avaamalla tiedosto Visual Studio Codessa ja tarkistamalla rakennevirheet.

Estämättömät virheet eivät estä Power BI Desktopia avaamasta raporttia, ja ne ratkaistaan automaattisesti.

Virheet, kuten virheellinen activePageName-määritys , ovat esimerkkejä automaattisesti korjaamista virheistä, jotka eivät ole estovirheitä. Varoitus on tarpeen, jotta voit välttää raportin tallentamisen automaattisella korjauksella, sillä se estää mahdollisen työn menettämisen.

Yleiset PBIR-virheet

Skenaario:Visualisoinnin tai sivun kansioiden nimien uudelleennimeämisen jälkeen visualisointi tai sivu ei enää näy raportin avaamisen yhteydessä.

Ratkaisu: Tarkista, noudattaako nimi nimeämiskäytäntöä. Jos näin ei ole, Power BI Desktop ohittaa tiedoston tai kansion ja käsittelee sitä yksityisinä käyttäjätiedostoina.

Skenaario:Uudet raporttiobjektit nimetään eri tavalla kuin muut. Useimpien sivukansioiden nimi on esimerkiksi ReportSection0e71dafbc949c0853608, kun taas joidenkin nimi on "1b3c2ab12b603618070b".

Ratkaisu: PBIR hyväksyi uuden nimeämiskäytännön jokaiselle objektille, mutta se koskee vain uusia objekteja. Kun tallennat aiemmin luodun raportin PBIP-muodossa, nykyiset nimet on säilytettävä, jotta viittaukset eivät katkea. Jos haluat yhtenäisyyttä, komentosarjan erän uudelleennimeäminen sallitaan.

Skenaario:Kopioin kirjanmerkkitiedoston, ja tallentamisen yhteydessä suurin osa kirjanmerkkimäärityksistä poistettiin.

Ratkaisu: Tämä on tarkoituksellista. Raportin kirjanmerkit kuvaavat raporttisivun tilan yhdessä sen kaikkien visualisointien kanssa. Koska siepattu tila on peräisin toiselta raporttisivulta, jolla on eri visualisointeja, virheelliset visualisoinnit poistetaan kirjanmerkkimäärityksestä. Jos kopioit myös riippuvaiset visualisoinnit ja sivun, kirjanmerkki säilyttää määrityksensä.

Skenaario:Kopioin sivukansion toisesta raportista ja sain virheen, jossa todettiin, että pageBinding.name-ominaisuuden arvojen on oltava yksilöllisiä.

Ratkaisu: pageBinding-objekti on välttämätön porautumisen ja sivun työkaluvihjeiden tukemiseksi. Koska muut sivut saattavat viitata niihin, nimen on oltava yksilöllinen raportin sisällä. Määritä juuri kopioidulla sivulla yksilöivä arvo virheen ratkaisemiseksi. Kesäkuun 2024 jälkeen tämä tilanne ei ole enää ongelma, koska pageBinding-nimi on oletusarvoisesti GUID-tunnus.

PBIR:n huomioitavat asiat ja rajoitukset

PBIR on tällä hetkellä esikatseluvaiheessa. Muista seuraavat seikat:

• Palvelun rajoitukset/virheet
  • Mobiilinäkymiä ei näytetä Power BI -sovelluksissa.
  • Piilotetut sivut näkyvät Power BI -sovellusten siirtymistoiminnossa.
  • Käyttöönottoputkissa ei voi ottaa käyttöön.
  • Ei voi tallentaa kopiona.
  • Power BI -raportin ohjelmointirajapintoja ei voi käyttää: Kloonaa raportti, Päivitä raportin sisältö
• Suuret raportit, joissa on yli 500 tiedostoa, kokevat suorituskykyongelmia (raportin tarkastelu ei muutu), mukaan lukien:
  • Tallentaminen Power BI Desktopissa
  • Synkronointi Fabric Git -integroinnissa
• Kun raportti on muunnettu PBIR-Legacy-versiosta PBIR:ksi, sitä ei voi peruuttaa.
• PBIP-tiedoston muuntaminen PBIX-tiedostoksi "Tallenna nimellä" -toiminnon avulla upottaa PBIR-raportin PBIX-tiedostoon ja siirtää kaikki PBIR-rajoitukset PBIX:lle.

Palvelun asettamat PBIR:n kokorajoitukset:

• enintään 1 000 sivua raporttia kohden.
• enintään 300 visualisointia sivua kohden.
• enintään 5 mt jokaista kirjanmerkkitiedostoa kohden.
• enintään 1 mt kullekin tiedostolle.
• enintään 1 000 resurssipakettitiedostoa raporttia kohden.
• enimmäiskoko 300 mt kaikille resurssipakettitiedostoille.
• enintään 20 mt koko kaikille raporttitiedostoille.

Julkisen esikatselun aikana Fabric Git -integrointi ja Fabric REST -ohjelmointirajapinnat käyttävät edelleen PBIR-Legacya (report.json) raporttimääritysten viemiseen. Jos raportti kuitenkin tuodaan Fabriciin PBIR-muodossa, molemmat ominaisuudet alkavat viedä raportin määritystä PBIR-muodossa.

Liittyvä sisältö

• Semanttinen Power BI Desktop -projektin kansio
• Power BI Desktop -projektit