A Power BI Desktop projektjelentési mappája

Ez a cikk a Microsoft Power BI Desktop-projekt Jelentés mappájában található fájlokat és almappákat ismerteti. Az itt található fájlok és almappák egy Power BI-jelentést jelölnek. A projekttől függően a jelentés mappája a következőket tartalmazhatja:

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

1 – Ez a fájl szükséges.
2 – Ez a fájl a PBIR-Legacy formátumba való mentéshez szükséges.
3 – Ez a fájl PBIR formátumba való mentéskor szükséges.

Nem minden projektjelentési mappa tartalmazza az itt leírt összes fájlt és almappát.

Jelentésfájlok

.pbi\localSettings.json

Olyan jelentésbeállításokat tartalmaz, amelyek csak az aktuális felhasználóra és a helyi számítógépre vonatkoznak. A gitIgnore-ban vagy más forrásvezérlési kizárásokban kell szerepelnie. Alapértelmezés szerint a Git figyelmen kívül hagyja ezt a fájlt.

További információ: localSettings.json sémadokumentum.

CustomVisuals\

A jelentés egyéni vizualizációinak metaadatait tartalmazó almappája. A Power BI háromféle egyéni vizualizációt támogat:

• Szervezeti tár vizualizációi – A szervezetek jóváhagyhatják és üzembe helyezhetik az egyéni vizualizációkat a Power BI-ban a szervezetük számára. További információ: Szervezeti tároló.
• AppSource Power BI-vizualizációk – Más néven "nyilvános egyéni vizualizációk". Ezek a vizualizációk a Microsoft AppSource-ból érhetők el. A jelentéskészítők közvetlenül a Power BI Desktopból telepíthetik ezeket a vizualizációkat.
• Egyéni vizualizációs fájlok – "Privát egyéni vizualizációk" néven is ismert. A fájlok egy pbiviz-csomag feltöltésével tölthetők be a jelentésbe.

A CustomVisuals mappába csak a privát egyéni vizualizációk vannak betöltve. Az AppSource- és szervezeti vizualizációkat a Power BI Desktop automatikusan betölti.

RegisteredResources\

Olyan almappák, amelyek a jelentéshez kapcsolódó és a felhasználó által betöltött erőforrásfájlokat, például egyéni témákat, képeket és egyéni vizualizációkat (pbiviz-fájlokat) tartalmaznak.

A fejlesztők felelősek az itt található fájlokért, és a módosítások támogatottak. Módosíthatja például a fájlokat, és a Power BI Desktop újraindítása után az új fájl betöltődik a jelentésbe. Ez a mappa feloldhat néhány hasznos forgatókönyvet, például:

• Egyéni témák készítése a Power BI Desktopon kívül a nyilvános sémával.
• Kötegmódosítások alkalmazása az erőforrásfájl több jelentésen való módosításával. Megváltoztathatja például a vállalati egyéni témát, módosíthatja a világos és sötét témákat, és módosíthatja az emblémaképeket.

Minden erőforrásfájlnak rendelkeznie kell egy megfelelő bejegyzéssel a report.json fájlban, amely az előzetes verzióban nem támogatja a szerkesztést. A RegisteredResources-fájlok szerkesztése csak olyan már betöltött erőforrások esetében támogatott, amelyek miatt a Power BI Desktop regisztrálja az erőforrást a report.json.

semanticModelDiagramLayout.json

A jelentéshez társított szemantikai modell szerkezetét leíró adatmodell-diagramokat tartalmaz. Az előzetes verzióban ez a fájl nem támogatja a külső szerkesztést.

definition.pbir

A jelentés és az alapvető beállítások általános definícióját tartalmazza. Ez a fájl a jelentés által használt szemantikai modellre is hivatkozik. A Power BI Desktop közvetlenül is megnyithat egy pbir-fájlt, ugyanúgy, mintha a jelentést egy pbip-fájlból nyitották volna meg. A pbir megnyitása a szemantikai modellt is megnyitja, ha relatív hivatkozás van a használatával byPath.

Példa definition.pbir:

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

A definíció tartalmazza a datasetReference tulajdonságot, amely a jelentésben használt szemantikai modellre hivatkozik. A hivatkozás a következő lehet:

byPath – A cél szemantikai modell mappájának relatív elérési útját adja meg. Az abszolút elérési utak nem támogatottak. Az előre perjel (/) mappaelválasztóként használatos. Használat esetén a Power BI Desktop teljes szerkesztési módban is megnyitja a szemantikai modellt.

byConnection– Egy távoli szemantikai modellt határoz meg a Power BI szolgáltatás egy kapcsolati sztring használatával. byConnection Hivatkozás használata esetén a Power BI Desktop nem nyitja meg a szemantikai modellt szerkesztési módban.

Hivatkozással byConnection a következő tulajdonságokat kell megadni:

Példa a következő használatával 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"
    }
  }
}

Ha a szemantikai modell és a jelentés ugyanazt a munkaterületet használja, a Fabric Git Integration mindig byPath hivatkozik a szemantikai modellre. Ha élő kapcsolaton keresztül szeretné megnyitni a jelentést (például jelentésszintű mértékekkel szeretne dolgozni), több definíciós*.pbir fájllal is rendelkezhet, például egy byPath-kapcsolattal, egy másikkal pedig byConnection-kapcsolattal. A Fabric Git Integration csak a definition.pbir fájlt dolgozza fel, és figyelmen kívül hagyja az összes többi *.pbir fájlt. Ezek a fájlok azonban ugyanabban az adattárban is létezhetnek.

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

Ez a fájl a támogatott jelentésdefiníciós formátumokat is megadja a "version" tulajdonságon keresztül.

További információ: definition.pbir sémadokumentum.

mobileState.json

Jelentésmegjelenítési és viselkedési beállításokat tartalmaz mobileszközön történő rendereléskor. Ez a fájl nem támogatja a külső szerkesztést.

report.json

Ez a fájl a jelentésdefiníciót power BI-jelentés örökölt formátumban (PBIR-Legacy) tartalmazza, és nem támogatja a külső szerkesztést.

definition\ folder

Ez a mappa csak akkor érhető el, ha a Power BI-projektet a Power BI továbbfejlesztett jelentésformátumával (PBIR) menti. Lecseréli a report.json fájlt.

.peron

Hálóplatform-fájl, amely a Fabric-elemek és a Git közötti kapcsolat létrehozásához és fenntartásához elengedhetetlen tulajdonságokat tartalmazza.

További információ: Git-integráció automatikusan létrehozott rendszerfájlok.

PBIR formátum

A Power BI Project-fájlok (PBIP) Power BI Továbbfejlesztett jelentésformátum (PBIR) használatával történő mentése jelentősen javítja a változások követését és az ütközések feloldását a megfelelően formázott JSON-fájlok használatával.

Minden lap, vizualizáció, könyvjelző stb. külön, különálló fájlba van rendezve egy mappastruktúrában. Ez a formátum ideális a közös fejlesztési ütközések feloldásához.

A PBIR-Legacy (report.json) ellentétben a PBIR egy nyilvánosan dokumentált formátum, amely támogatja a nem Power BI-alkalmazások módosításait. Minden fájl rendelkezik egy nyilvános JSON-sémával, amely nem csak a fájlt dokumentálja, hanem lehetővé teszi a Visual Studio Code-hoz hasonló kódszerkesztők számára a szintaxis érvényesítését szerkesztés közben.

A PBIR-ben elérhető lehetséges forgatókönyvek közé tartoznak a következők:

• Lapok/vizualizációk/könyvjelzők másolása jelentések között.
• A vizualizációk egy csoportjának konzisztenciájának biztosítása az összes oldalon a vizualizációfájlok másolásával és beillesztésével.
• Egyszerű keresés és csere több jelentésfájl között.
• Kötegszerkesztés alkalmazása minden vizualizációban szkripttel (például vizualizációszintű szűrők elrejtése)

PBIR formátum előzetes verziójú funkció engedélyezése

A PBIR használatával power BI-projektként történő mentés jelenleg előzetes verzióban érhető el. Használat előtt engedélyezze a Power BI Desktop előzetes verziójú funkcióiban:

Nyissa meg a Fájlbeállítások > és beállítások > – > Előzetes verziójú funkciók lehetőséget, és jelölje be a bővített metaadat-formátumot (PBIR) használó Jelentések tárolása melletti jelölőnégyzetet.

Mentés projektként a PBIR használatával

Ha engedélyezve van a PBIR Előzetes verziójú funkció, egy projekt mentésekor a jelentés egy \definition nevű mappába lesz mentve a jelentés mappájában:

További információ a PBIR-mappastruktúráról.

Meglévő PBIP átalakítása PBIR-vé

Ha már rendelkezik PBIR-Legacy formátumot használó PBIP-sel, az alábbiak szerint konvertálhatja PBIR-ra:

1. Nyissa meg a PBIP-t a Power BI Desktopban.

2. Győződjön meg arról, hogy az előnézeti funkció engedélyezve van.

3. Mentse a projektet. Megjelenik egy üzenet, amely arra kéri, hogy frissítsen a PBIR-re.

4. Válassza a Frissítés lehetőséget.

   

   Fontos

   A PBIR-re való frissítés után nem tud visszatérni a PBIR-Legacy-re. Ha úgy gondolja, hogy vissza szeretne térni a PBIR-Legacy-re, mentse először a PBIP-fájlok másolatát.

A meglévő PBIR-Legacy fájl (report.json) helyébe a jelentés PBIR-ábrázolását tartalmazó \definition mappa kerül.

Ha a Jelenlegi formátum megőrzése lehetőséget választja, az Asztal nem kéri újra a frissítést.

PBIR-jelentés közzététele a szolgáltatásban

Míg az előzetes verzió fázisában csak a Fabric Git Integration használatával tehet közzé egy PBIR formátumú jelentést. Ez magában foglalja a munkaterület git-adattárhoz való csatlakoztatását, és a PBIR-jelentés leküldését, amely később szinkronizálható a szolgáltatás-munkaterülettel.

Ha meglévő jelentést szeretne PBIR-vé alakítani a szolgáltatásban, kövesse az alábbi lépéseket:

1. Csatlakoztassa a munkaterületet a Githez.
2. Klónozza a Git-adattárat a helyi fájlrendszerbe.
3. Nyissa meg a jelentést a Power BI Desktopban a definition.pbir fájl megnyitásával.
4. Mentse a jelentést, és válassza a PBIR-re való frissítést.
5. Véglegesítse és szinkronizálja a módosításokat a Gitben.
6. Frissítse a munkaterületet a Git legújabb módosításaival.

PBIR mappa és fájlok

A jelentésdefiníció a definition\ következő struktúrával van tárolva a mappában:

├── 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 elnevezési konvenció

Az előző táblázat szögletes zárójeleiben ([]) szereplő nevek az alapértelmezett elnevezési konvenciók szerint, de felhasználóbarátabb nevekre nevezhetők át. Alapértelmezés szerint a lapok, vizualizációk és könyvjelzők a jelentésobjektum nevét használják fájl- vagy mappanévként. Ezek az objektumnevek kezdetben 20 karakteres egyedi azonosítók, például "90c2e07d8e84e7d5c026".

A "name" tulajdonság átnevezése minden JSON-fájlban támogatott, de a jelentésen belüli és kívüli külső hivatkozásokat is megszakíthatja. Az objektumnévnek és/vagy fájl-/mappanévnek egy vagy több szókarakterekből (betűkből, számjegyekből, aláhúzásjelekből) vagy kötőjelekből kell állnia.

A PBIR-fájlok vagy mappák átnevezése után újra kell indítania a Power BI Desktopot. Az újraindításkor a Power BI Desktop mentéskor megőrzi az eredeti fájl- vagy mappaneveket.

PBIR Json-sémák

Minden PBIR JSON-fájl tartalmaz egy JSON-sémadeklarációt a dokumentum tetején. Ez a séma URL-címe nyilvánosan elérhető, és az egyes fájlok elérhető tulajdonságaival és objektumaival kapcsolatos további információkhoz használható. Emellett beépített IntelliSense-t és ellenőrzést is biztosít, ha olyan kódszerkesztőkkel szerkeszt, mint a Visual Studio Code.

A séma URL-címe a dokumentum verzióját is meghatározza, amely a jelentésdefiníció fejlődésével várhatóan változni fog.

Az összes JSON-sémát itt tesszük közzé.

PBIR-széljegyzetek

A megjegyzéseket név-érték párként is felveheti a jelentésdefinícióba az egyes visualés pagereporta . Bár a Power BI Desktop figyelmen kívül hagyja ezeket a széljegyzeteket, hasznos lehet külső alkalmazások, például szkriptek számára.

Megadhatja például a fájlban report.json a jelentés alapértelmezett lapjának értékét, amelyet aztán egy üzembehelyezési szkript használhat.

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

A PBIR-fájlok külső módosításai

A PBIR JSON-fájlokat egy kódszerkesztő, például a Visual Studio Code vagy egy külső eszköz használatával szerkesztheti, ha a fájl betartja a JSON-sémát. Helytelen tulajdonságnév vagy -típus használata könnyen észlelhető közvetlenül a Visual Studio Code-ban:

A PBIR-tartalom külső módosítása hibákhoz vezethet a fájlok Power BI Desktopban való újbóli megnyitásakor. Ezek a hibák két típusúak lehetnek:

A blokkolási hibák megakadályozzák , hogy a Power BI Desktop megnyissa a jelentést. Ezek a hibák segítenek azonosítani a problémát és a jogsértő fájlt, amelyet az újranyitás előtt ki kell javítani:

Az olyan hibák, mint például az érvénytelen séma vagy a hiányzó szükséges tulajdonságok blokkolási hibáknak minősülnek. Ezek a hibák könnyen azonosíthatók a fájl Visual Studio Code-ban való megnyitásával és a sémahibák vizsgálatával.

A nem blokkoló hibák nem akadályozzák meg a Power BI Desktopot a jelentés megnyitásában, és automatikusan megoldódnak.

Az olyan hibák, mint például az érvénytelen activePageName-konfiguráció , példák az automatikusan kijavított blokkolási hibákra. A figyelmeztetésre azért van szükség, hogy elkerülhesse a jelentés automatikus javítóval való mentését azáltal, hogy megakadályozza a munka esetleges elvesztését.

Gyakori PBIR-hibák

Forgatókönyv:A vizualizáció vagy a lap mappanevének átnevezése után a vizualizáció vagy a lap már nem jelenik meg a jelentés megnyitásakor.

Megoldás: Ellenőrizze, hogy a név megfelel-e az elnevezési konvenciónak. Ha nem, a Power BI Desktop figyelmen kívül hagyja a fájlt vagy mappát, és magánfelhasználói fájlokként kezeli.

Forgatókönyv:Az új jelentésobjektumok elnevezése eltér másoktól. A legtöbb lapmappának például a "ReportSection0e71dafbc949c0853608" a neve, míg néhány neve "1b3c2ab12b603618070b".

Megoldás: A PBIR minden objektumhoz új elnevezési konvenciót fogadott el, de csak az új objektumokra vonatkozik. Ha pbIP-ként ment egy meglévő jelentést, az aktuális neveket meg kell őrizni a kompatibilitástörő hivatkozások elkerülése érdekében. Ha konzisztenciát szeretne, a parancsfájlok átnevezése kötegként engedélyezett.

Forgatókönyv:Átmásoltam egy könyvjelzőfájlt, és mentéskor a könyvjelzőkonfiguráció nagy része törölve lett.

Megoldás: Ez a viselkedés szándékos, a jelentés könyvjelzői az összes vizualizációval együtt rögzítik a jelentésoldal állapotát. Mivel a rögzített állapot egy másik, különböző vizualizációkkal rendelkező jelentésoldalról származik, az érvénytelen vizualizációk törlődnek a könyvjelző konfigurációjából. Ha a függő vizualizációkat és lapokat is átmásolja, a könyvjelző megtartja annak konfigurációját.

Forgatókönyv:Átmásoltam egy lapmappát egy másik jelentésből, és hibát észleltem, amely szerint a "pageBinding.name" tulajdonság értékeinek egyedinek kell lenniük.

Megoldás: A pageBinding objektum szükséges a részletezés és az oldal elemleírásainak támogatásához. Mivel más oldalak hivatkozhatnak rájuk, a névnek egyedinek kell lennie a jelentésben. Az újonnan másolt lapon rendeljen hozzá egy egyedi értéket a hiba megoldásához. 2024 júniusa után ez a helyzet már nem jelent problémát, mivel a pageBinding név alapértelmezés szerint GUID.

A PBIR szempontjai és korlátozásai

A PBIR jelenleg előzetes verzióban érhető el. Tartsa szem előtt a következőket:

• Szolgáltatáskorlátozások/hibák
  • Üzembe helyezési folyamatokkal nem telepíthető.
  • Nem menthető másolatként.
  • Nem használhatók a Power BI jelentés API-k: Jelentés klónozása, Jelentéstartalom frissítése
• Az 500-nál több fájllal rendelkező nagyméretű jelentések szerzői teljesítményproblémákat tapasztalnak (a jelentésmegtekintést nem érinti), beleértve a következőket:
  • Mentés a Power BI Desktopban
  • Szinkronizálás a Fabric Git-integrációban
• Miután egy jelentést PBIR-legacy-ról PBIR-re konvertált, nem lehet visszagörgetni.
• A PBIP-fájlok PBIX-fájllá konvertálása a "Mentés másként" funkcióval beágyazza a PBIR-jelentést a PBIX-fájlba, és az összes PBIR-korlátozást a PBIX-re alakítja át.

A szolgáltatás által kikényszerített PBIR-méretkorlátozások:

• Jelentésenként 1000 oldal.
• Oldalanként legfeljebb 300 vizualizáció.
• Minden könyvjelzőfájlhoz legfeljebb 5 mb lehet.
• Fájlonként legfeljebb 1 mb.
• Jelentésenként legfeljebb 1000 erőforráscsomag-fájl.
• Az erőforráscsomag-fájlok maximális mérete 300 mb.
• Az összes jelentésfájl maximális mérete 20 mb.

A nyilvános előzetes verzióban a Fabric Git Integration és a Fabric REST API-k továbbra is a PBIR-Legacy (report.json) függvényt használják a jelentésdefiníciók exportálása során. Ha azonban a jelentést PBIR formátummal importálja a Fabricbe, akkor mindkét funkció PBIR formátummal kezdi exportálni a jelentésdefiníciót.

Kapcsolódó tartalom

• A Power BI Desktop projekt szemantikai modellmappája
• Power BI Desktop-projektek