Priečinok zostavy projektu aplikácie Power BI Desktop

Tento článok popisuje súbory a podpriečinky v priečinku zostáv projektu aplikácie Microsoft Power BI Desktop. Súbory a podpriečinky v tomto priečinku predstavujú zostavu Power BI. V závislosti od projektu môže priečinok zostavy obsahovať položky:

• .pbi\
  • localSettings.json
• CustomVisuals\
• StaticResources\
  • RegisteredResources\
• semanticModelDiagramLayout.json
• definition.pbir¹
• mobileState.json
• ^{report.json 2}
• definition\ priečinok³
• .nástupište

1 – Tento súbor je povinný.
2 – Tento súbor sa vyžaduje pri ukladaní do formátu PBIR-Legacy.
3 – Tento súbor sa vyžaduje pri ukladaní do formátu PBIR.

Nie každý priečinok zostavy projektu obsahuje všetky súbory a podpriečinky popísané tu.

Súbory zostáv

.pbi\localSettings.json

Obsahuje nastavenia zostavy, ktoré sa vzťahujú len na aktuálneho používateľa a lokálny počítač. Mala by sa zahrnúť do vylúčenia gitIgnore alebo iného vylúčenia správy zdrojov. Predvolene Git tento súbor ignoruje.

Ďalšie informácie nájdete v dokumente localSettings.json schému.

CustomVisuals\

Podpriečinok, ktorý obsahuje metaúdaje pre vlastné vizuály v zostave. Služba Power BI podporuje tri druhy vlastných vizuálov:

• Vizuály ukladacieho priestoru organizácie – organizácie môžu schvaľovať a nasadzovať vlastné vizuály do služby Power BI pre svoju organizáciu. Ďalšie informácie nájdete v téme Obchod organizácie.
• Vizuály Power BI z lokality AppSource – známe aj ako "Verejné vlastné vizuály". Tieto vizuály sú k dispozícii v službe Microsoft AppSource. Vývojári zostáv môžu tieto vizuály nainštalovať priamo z aplikácie Power BI Desktop.
• Súbory vlastných vizuálov – známe aj ako "Súkromné vlastné vizuály". Súbory je možné načítať do zostavy nahratím balíka pbiviz.

Do priečinka CustomVisuals sa načítajú iba súkromné vlastné vizuály. Vizuály AppSource a Organization sa automaticky načítavajú pomocou aplikácie Power BI Desktop.

RegisteredResources\

Podpriečinok, ktorý obsahuje súbory prostriedkov špecifické pre danú zostavu a načítaný používateľom, ako sú napríklad vlastné motívy, obrázky a vlastné vizuály (súbory pbiviz).

Vývojári sú zodpovední za súbory v tomto článku a zmeny sú podporované. Môžete napríklad zmeniť súbor a po reštarte aplikácie Power BI Desktop sa nový súbor načíta do zostavy. Tento priečinok môže odblokovať niektoré užitočné scenáre, ako napríklad:

• Vytváranie vlastných motívov mimo aplikácie Power BI Desktop pomocou verejnej schémy.
• Použitie dávkových zmien zmenou súboru prostriedkov vo viacerých zostavách. Môžete napríklad prepnúť podnikový vlastný motív, zmeniť svetlý a tmavý motív a zmeniť obrázky loga.

Každý súbor prostriedkov musí mať zodpovedajúcu položku v súbore report.json, ktorá počas používania ukážky nepodporuje úpravy. Úpravy súborov RegisteredResources sú podporované len pre už načítané prostriedky, čo spôsobí, že aplikácia Power BI Desktop zaregistruje prostriedok v report.json.

semanticModelDiagramLayout.json

Obsahuje diagramy dátového modelu popisujúce štruktúru sémantického modelu priradeného k zostave. Počas používania verzie Preview tento súbor nepodporuje externé úpravy.

definition.pbir

Obsahuje celkovú definíciu zostavy a jej základných nastavení. Tento súbor obsahuje aj odkaz na sémantický model, ktorý používa zostava. Aplikácia Power BI Desktop môže otvoriť súbor v pbir priamo, rovnako ako keby bola zostava otvorená zo súboru pbip. Otvorením pbir sa okrem toho otvorí aj sémantický model, ak existuje relatívny odkaz pomocou funkcie byPath.

Príklad definition.pbir:

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

Definícia obsahuje datasetReference vlastnosť , ktorá odkazuje na sémantický model použitý v zostave. Odkazom môže byť buď:

byPath – Určuje relatívnu cestu k cieľovému priečinku sémantického modelu. Absolútne cesty nie sú podporované. Lomka (/) sa používa ako oddeľovač priečinkov. Pri použití sa v aplikácii Power BI Desktop otvorí aj sémantický model v režime úplných úprav.

byConnection– určuje vzdialený sémantický model v služba Power BI pomocou reťazec pripojenia. Pri použití odkazu byConnection power BI Desktop neotvorí sémantický model v režime úprav.

Pomocou odkazu byConnection je potrebné zadať nasledujúce vlastnosti:

Príklad použitia 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"
    }
  }
}

Keď sémantický model a zostava zdieľajú rovnaký pracovný priestor, integrácia Git služby Fabric vždy používa byPath odkaz na sémantický model. Ak chcete vynútiť otvorenie zostavy pomocou dynamického pripojenia (napríklad na prácu s mierkami na úrovni zostavy), môžete mať viacero súborov definition*.pbir, napríklad jeden s pripojením byPath a druhý s pripojením podľa pripojenia byConnection. Fabric Git Integration spracováva iba súbor definition.pbir a ignoruje všetky ostatné súbory *.pbir. Tieto súbory však môžu existovať súčasne v tom istom odkladacom priestore.

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

Tento súbor tiež špecifikuje podporované formáty definícií zostavy prostredníctvom vlastnosti "verzia".

Ďalšie informácie nájdete v dokumente definition.pbir schema.

mobileState.json

Obsahuje nastavenia vzhľadu a správania zostavy pri vykresľovaní v mobilnom zariadení. Tento súbor nepodporuje externé úpravy.

report.json

Tento súbor obsahuje definíciu zostavy vo formáte Staršej verzie zostavy Power BI (PBIR-Legacy) a nepodporuje externé úpravy.

folder\

Tento priečinok je k dispozícii len v prípade, že je projekt Power BI uložený pomocou formátu vylepšenej zostavy služby Power BI (PBIR). Nahradí súbor report.json .

.nástupište

Súbor platformy fabric, ktorý obsahuje vlastnosti dôležité pre vytvorenie a zachovanie prepojenia medzi položkami služby Fabric a službou Git.

Ďalšie informácie nájdete v téme Integrácia systému Git automaticky generované systémové súbory.

Formát PBIR

Uložením súborov projektu Power BI (PBIP) pomocou formátu vylepšenej zostavy služby Power BI (PBIR) sa výrazne zlepší sledovanie zmien a zlúčenie riešenia konfliktov pomocou správne naformátovaných súborov JSON.

Každá strana, vizuál, záložka atď. je rozdelená do samostatného, individuálneho súboru v rámci štruktúry priečinkov. Tento formát je ideálny pre spolurozvojové riešenie konfliktov.

Na rozdiel od PBIR-Legacy (report.json), PBIR je verejne zdokumentovaný formát, ktorý podporuje úpravy z aplikácií mimo služby Power BI. Každý súbor má verejnú schému JSON, ktorá súbor nielen dokumentuje, ale tiež umožňuje editorom kódu, ako je napríklad Visual Studio Code, vykonávať overenie syntaxe počas úprav.

Niektoré z možných scenárov, ktoré sú teraz k dispozícii v PBIR, zahŕňajú:

• Kopírovanie strán,vizuálov/záložiek medzi zostavami.
• Skopírujte a prilepte súbory vizuálov naprieč všetkými stranami a zabezpečte konzistenciu množiny vizuálov na všetkých stranách.
• Jednoduché vyhľadanie a nahradenie medzi viacerými súbormi zostáv.
• Použitie dávkovej úpravy vo všetkých vizuáloch pomocou skriptu (napríklad skrytie filtrov na úrovni vizuálu)

Povolenie funkcie ukážky formátu PBIR

Ukladanie ako projekt Power BI pomocou PBIR je momentálne v režime ukážky. Pred použitím ju povoľte v aplikácii Power BI Desktop vo verzii Preview:

Prejdite na položky Súbor > Možnosti a nastavenia > Možnosti > Funkcie ukážky a začiarknite políčko vedľa položky Ukladanie zostáv pomocou rozšíreného formátu metaúdajov (PBIR).

Uložiť ako projekt pomocou PBIR

Keď je povolená funkcia PBIR Preview, po uložení projektu sa vaša zostava uloží do priečinka s názvom \definition v rámci priečinka zostavy:

Ďalšie informácie o štruktúre priečinkov PBIR.

Konverzia existujúceho súboru PBIP na PBIR

Ak už máte PBIP pomocou formátu PBIR-Legacy, môžete ho previesť na PBIR takto:

1. Otvorte súbor PBIP v aplikácii Power BI Desktop.

2. Uistite sa, že funkcia vo verzii ukážky je povolená.

3. Uložte projekt. Zobrazí sa výzva so žiadosťou o inováciu na PBIR.

4. Vyberte položku Inovovať.

   

   Dôležité

   Po inovácii na PBIR sa nemôžete vrátiť späť do funkcie PBIR-Legacy. Ak si myslíte, že sa budete chcieť vrátiť k súboru PBIR-Legacy, uložte si najprv kópiu súborov PBIP.

Existujúci súbor PBIR-Legacy (report.json) sa nahradí priečinkom \definition obsahujúcim reprezentáciu PBIR zostavy.

Ak vyberiete možnosť Zachovať aktuálny formát, aplikácia Desktop už nebude zobrazovať výzvu na inováciu.

Publikovanie zostavy PBIR do služby

Vo fáze ukážky je jediným spôsobom publikovania zostavy s formátom PBIR integrácia systému Fabric Git. To zahŕňa pripojenie pracovného priestoru k odkladaciemu priestoru Git a presunutie zostavy PBIR do odkladacieho priestoru, ktorý sa potom môže synchronizovať s pracovným priestorom služby v neskoršej fáze.

Ak chcete skonvertovať existujúcu zostavu na PBIR v službe, postupujte podľa týchto krokov:

1. Pripojte pracovný priestor k systému Git.
2. Naklonujte odkladací priestor Git do lokálneho systému súborov.
3. Otvorte zostavu v aplikácii Power BI Desktop otvorením definition.pbir súboru.
4. Uložte zostavu a vyberte možnosť inovácie na PBIR.
5. Potvrdiť a synchronizovať zmeny v Git.
6. Aktualizujte pracovný priestor najnovšími zmenami zo systému Git.

Priečinok a súbory PBIR

Definícia zostavy je uložená v priečinku definition\ s nasledujúcou štruktúrou:

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

Konvencia pomenovania PBIR

Všetky názvy v hranatých zátvorkách ([]) v predchádzajúcej tabuľke sa riadia predvolenou konvenciou pomenovania, ale možno ich premenovať na používateľsky prívetivejšie názvy. Strany, vizuály a záložky predvolene používajú ako názov objektu zostavy názov svojho súboru alebo priečinka. Tieto názvy objektov sú pôvodne 20-znakovým jedinečným identifikátorom, ako napríklad 90c2e07d8e84e7d5c026.

Premenovanie vlastnosti name v rámci každého súboru JSON je podporované, môže však poškodiť externé odkazy v rámci zostavy aj mimo ňou. Názov objektu a/alebo názov súboru/priečinka musí pozostávať z jedného alebo viacerých znakov slova (písmená, číslice, znaky podčiarknutia) alebo spojovníky.

Po premenovaní všetkých súborov alebo priečinkov PBIR musíte reštartovať aplikáciu Power BI Desktop. Po reštartovaní power BI Desktop pri ukladaní zachová pôvodné názvy súborov alebo priečinkov.

Schémy PBIR Json

Každý súbor PBIR JSON obsahuje deklaráciu schémy JSON v hornej časti dokumentu. Táto URL adresa schémy je verejne prístupná a môže sa použiť na ďalšie informácie o dostupných vlastnostiach a objektoch každého súboru. Okrem toho poskytuje vstavanú funkciu IntelliSense a overenie pri úprave pomocou editorov kódu, ako je napríklad Visual Studio Code.

URL adresa schémy tiež definuje verziu dokumentu, ktorá sa má zmeniť, keď sa definícia zostavy bude vyvíjať.

Tu sú publikované všetky schémy JSON.

Anotácie v PBIR

Komentáre môžete pridať ako páry názov-hodnota v rámci definície zostavy pre každú visualpage položku a report. Hoci aplikácia Power BI Desktop bude tieto komentáre ignorovať, môže byť cenná pre externé aplikácie, ako sú napríklad skripty.

Môžete napríklad zadať predvolenú položkuPage pre zostavu report.json v súbore, ktorú potom môže využívať skript nasadenia.

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

Externé zmeny súborov PBIR

Súbory PBIR JSON môžete upraviť pomocou editora kódu, ako je napríklad Visual Studio Code alebo externého nástroja, ak súbor poslúchne schému JSON. Nesprávne názvy alebo typ vlastnosti možno jednoducho zistiť priamo v programe Visual Studio Code:

Externé zmeny obsahu PBIR môžu spôsobiť chyby pri opätovnom otvorení súborov v aplikácii Power BI Desktop. Tieto chyby môžu mať dva typy:

Zablokovanie chýb bráni aplikácii Power BI Desktop v otváraní zostavy. Tieto chyby pomáhajú identifikovať problém a priestupný súbor, ktoré je potrebné opraviť pred opätovním otvorením:

Chyby, ako je napríklad neplatná schéma alebo chýbajúce požadované vlastnosti, sa považujú za blokujúce chyby. Tieto chyby je možné jednoducho identifikovať otvorením súboru v programe Visual Studio Code a kontrolou chýb schémy.

Chyby, ktoré neblokujú blokovanie , nebránia aplikácii Power BI Desktop otvoriť zostavu a automaticky sa vyriešia.

Chyby, ako je napríklad neplatná konfigurácia vlastnosti activePageName , sú príklady neblokovania chýb, ktoré sa automaticky opravia. Upozornenie je potrebné, aby ste mali možnosť vyhnúť sa uloženiu zostavy pomocou automatickej opravy tým, že zabránite akejkoľvek potenciálnej strate práce.

Bežné chyby v PBIR

Scenár:Po premenovaní názvov vizuálov alebo priečinkov strany sa už môj vizuál alebo strana nezobrazujú pri otváraní zostavy.

Riešenie: Overte, či je názov v súlade s konvenciou pomenovania. Ak sa tak nestane, Aplikácia Power BI Desktop súbor alebo priečinok ignoruje a narába s ním ako so súbormi súkromného používateľa.

Scenár:Nové objekty zostavy majú názov inak než ostatné. Väčšina priečinkov strany má napríklad názov ReportSection0e71dafbc949c0853608, zatiaľ čo niektoré majú názov 1b3c2ab12b603618070b.

Riešenie: PBIR prijala novú konvenciu pomenovania pre každý objekt, ale vzťahuje sa len na nové objekty. Keď uložíte existujúcu zostavu ako PBIP, aktuálne názvy musia byť zachované, aby sa zabránilo porušeniu odkazov. Ak chcete dosiahnuť konzistentnosť, skript je povolený premenovaním dávky.

Scenár:Kopíroval som súbor záložky a pri uložení bola väčšina konfigurácie záložiek odstránená.

Riešenie: Toto správanie je zámerné, záložky zostavy zachytávajú stav strany zostavy spolu so všetkými jej vizuálmi. Keďže zaznamenaný stav pochádza z inej strany zostavy s rôznymi vizuálmi, všetky neplatné vizuály sa z konfigurácie záložiek odstránia. Ak tiež skopírujete závislé vizuály a stranu, záložka si zachová konfiguráciu.

Scenár:Skopíroval som priečinok strany z inej zostavy a vyskytla sa chyba s informáciou: Hodnoty pre vlastnosť pageBinding.name musia byť jedinečné.

Riešenie: Objekt pageBinding je potrebný na podporu podrobnej analýzy a popisov strany. Keďže na ne môžu odkazovať iné strany, názov musí byť v zostave jedinečný. Na novo skopírovanej stránke priraďte jedinečnú hodnotu, ktorá vyrieši chybu. Po júni 2024 sa s tým už problém nevyrieši, pretože názov pageBinding je predvolene identifikátor GUID.

Dôležité informácie a obmedzenia týkajúce sa PBIR

PBIR je aktuálne vo verzii Preview. Majte na pamäti:

• Obmedzenia služby alebo chyby
  • Nedá sa nasadiť s kanálmi nasadenia.
  • Nedá sa uložiť ako kópia.
  • Nie je možné použiť rozhrania API zostavy služby Power BI: klonovať zostavy, aktualizovať obsah zostavy
• Veľké zostavy s viac než 500 súbormi majú problémy s výkonom pri vytváraní (zobrazenie zostáv nie je ovplyvnené), čo zahŕňa:
  • Ukladanie v aplikácii Power BI Desktop
  • Synchronizácia v integrácii Git služby Fabric
• Po konvertovaní zostavy z PBIR-Legacy do PBIR nie je možné zostavu vrátiť.
• Konverziou súboru PBIP na súbor PBIX pomocou funkcie "Uložiť ako" sa vloží zostava PBIR v rámci súboru PBIX a prenesie všetky obmedzenia PBIR do PBIX súboru.

Obmedzenia veľkosti PBIR vynútené službou:

• max. 1 000 strán na zostavu.
• max. 300 vizuálov na stranu.
• Max. 5 mb pre každý súbor záložiek.
• Max. 1 mb pre každý súbor.
• max. 1 000 súborov balíkov prostriedkov na zostavu.
• Maximálna veľkosť pre všetky súbory balíkov prostriedkov: 300 mb.
• Maximálna veľkosť všetkých súborov zostáv: 20 mb.

Počas verzie Public Preview budú integrácia služby Fabric Git a rozhrania REST API služby Fabric naďalej používať pri exporte definícií zostáv položku PBIR-Legacy (report.json). Ak je však zostava importovaná do služby Fabric pomocou formátu PBIR, potom obe funkcie začnú exportovať definíciu zostavy pomocou formátu PBIR.

Súvisiaci obsah

• Priečinok sémantického modelu projektu v aplikácii Power BI Desktop
• Projekty aplikácie Power BI Desktop