Složka sestavy projektu Power BI Desktopu

Tento článek popisuje soubory a podsložky ve složce Sestava projektu Microsoft Power BI Desktopu. Zde uvedené soubory a podsložky představují sestavu Power BI. V závislosti na projektu může složka sestavy obsahovat:

• .pbi\
  • localSettings.json
• CustomVisuals\
• StaticResources\
  • RegisteredResources\
• semanticModelDiagramLayout.json
• definition.pbir¹
• mobileState.json
• ^{report.json 2}
• definition\ folder³
• .nástupiště

1 – Tento soubor je povinný.
2 – Tento soubor se vyžaduje při ukládání do formátu PBIR-Legacy.
3 – Tento soubor je vyžadován při ukládání do formátu PBIR.

Ne každá složka sestavy projektu obsahuje všechny soubory a podsložky popsané tady.

Soubory sestav

.pbi\localSettings.json

Obsahuje nastavení sestavy, která platí jenom pro aktuálního uživatele a místní počítač. Měla by být zahrnuta v gitIgnore nebo jiných vyloučeních správy zdrojového kódu. Git ve výchozím nastavení tento soubor ignoruje.

Další informace najdete v dokumentu schématu localSettings.json.

CustomVisuals\

Podsložka, která obsahuje metadata pro vlastní vizuály v sestavě. Power BI podporuje tři druhy vlastních vizuálů:

• Vizuály organizačního úložiště – Organizace můžou schválit a nasadit vlastní vizuály do Power BI pro svou organizaci. Další informace najdete v úložišti organizace.
• Vizuály Power BI v AppSource – označované také jako "Veřejné vlastní vizuály". Tyto vizuály jsou k dispozici v Microsoft AppSource. Vývojáři sestav mohou tyto vizuály nainstalovat přímo z Power BI Desktopu.
• Soubory vlastních vizuálů – označuje se také jako "Soukromé vlastní vizuály". Soubory lze do sestavy načíst tak, že nahrajete balíček pbiviz.

Do složky CustomVisuals se načtou jenom soukromé vlastní vizuály. Power BI Desktop automaticky načte vizuály AppSource a Organizace.

RegisteredResources\

Podsložka, která obsahuje soubory prostředků specifické pro sestavu a načtené uživatelem, jako jsou vlastní motivy, obrázky a vlastní vizuály (soubory pbiviz).

Vývojáři zodpovídají za zde uvedené soubory a podporují se změny. Můžete například změnit soubor a po restartování Power BI Desktopu se nový soubor načte do sestavy. Tato složka může odblokovat některé užitečné scénáře, například:

• Vytváření vlastních motivů mimo Power BI Desktop pomocí veřejného schématu
• Použití dávkových změn změnou souboru prostředků na více sestavách Můžete například přepínat firemní vlastní motiv, měnit mezi světlými a tmavými motivy a měnit obrázky loga.

Každý soubor prostředků musí mít odpovídající položku v souboru report.json, který v náhledu nepodporuje úpravy. Úpravy souborů RegisteredResources jsou podporovány pouze pro již načtené prostředky, které způsobují, že Power BI Desktop zaregistruje prostředek v report.json.

semanticModelDiagramLayout.json

Obsahuje diagramy datového modelu popisující strukturu sémantického modelu přidruženého k sestavě. Ve verzi Preview tento soubor nepodporuje externí úpravy.

definition.pbir

Obsahuje celkovou definici sestavy a základního nastavení. Tento soubor obsahuje také odkaz na sémantický model používaný sestavou. Power BI Desktop může otevřít přímo soubor pbir, stejně jako kdyby byla sestava otevřena ze souboru pbip. Otevření pobočkové ústředny také otevře sémantický model společně s použitím relativního odkazu byPath.

Příklad definition.pbir:

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

Definice obsahuje datasetReference vlastnost, která odkazuje na sémantický model použitý v sestavě. Odkaz může být následující:

byPath – Určuje relativní cestu ke sémantické sémantické sémantické složce modelu. Absolutní cesty nejsou podporovány. Lomítko (/) se používá jako oddělovač složek. Při použití power BI Desktop také otevře sémantický model v režimu úplného úprav.

byConnection– Určuje vzdálený sémantický model v služba Power BI pomocí připojovací řetězec. Když použijete byConnection odkaz, Power BI Desktop neotevře sémantický model v režimu úprav.

byConnection Pomocí odkazu musí být zadány následující vlastnosti:

Příklad použití 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
    }
  }
}

Když sémantický model a sestava sdílejí stejný pracovní prostor, integrace Gitu infrastruktury vždy používá byPath odkaz na sémantický model.

Tento soubor také určuje podporované formáty definic sestavy prostřednictvím vlastnosti version.

Další informace naleznete v dokumentu schématu definition.pbir.

mobileState.json

Obsahuje nastavení vzhledu a chování sestavy při vykreslování na mobilním zařízení. Tento soubor nepodporuje externí úpravy.

report.json

Tento soubor obsahuje definici sestavy ve formátu Starší verze sestavy Power BI (PBIR-Legacy) a nepodporuje externí úpravy.

definition\ folder

Tato složka je dostupná jenom v případě, že je projekt Power BI uložený pomocí rozšířeného formátu sestavy Power BI (PBIR). Nahradí soubor report.json.

.nástupiště

Soubor platformy Fabric, který obsahuje vlastnosti nezbytné pro vytvoření a údržbu propojení mezi položkami Infrastruktury a Gitem.

Další informace najdete v tématu Integrace Gitu automaticky generovaných systémových souborů.

Formát PBIR

Ukládání souborů projektu Power BI (PBIP) pomocí rozšířeného formátu sestav Power BI (PBIR) výrazně zlepšuje sledování změn a řešení konfliktů při slučování pomocí správně formátovaných souborů JSON.

Každá stránka, vizuál, záložka atd., je uspořádaná do samostatného jednotlivého souboru ve struktuře složek. Tento formát je ideální pro řešení konfliktů ve společném vývoji.

Na rozdíl od PBIR-Legacy (report.json) je PBIR veřejně zdokumentovaný formát, který podporuje úpravy z aplikací mimo Power BI. Každý soubor má veřejné schéma JSON, které nejen dokumentuje soubor, ale také umožňuje editorům kódu, jako je Visual Studio Code, provádět ověřování syntaxe při úpravách.

Mezi možné scénáře, které jsou teď dostupné v PBIR, patří:

• Zkopírujte stránky, vizuály nebo záložky mezi sestavami.
• Zajistěte konzistenci sady vizuálů na všech stránkách zkopírováním a vložením souborů vizuálu.
• Snadné vyhledání a nahrazení napříč několika soubory sestav.
• Použití dávkové úpravy ve všech vizuálech pomocí skriptu (například skrytí filtrů na úrovni vizuálů)

Povolení funkce náhledu formátu PBIR

Uložení jako projektu Power BI pomocí PBIR je aktuálně ve verzi Preview. Než ho začnete používat, povolte ho v funkcích Power BI Desktopu ve verzi Preview:

Přejděte na Možnosti souborů > a nastavení > Možnosti > náhledu funkcí a zaškrtněte políčko vedle Možnosti ukládání sestav pomocí rozšířeného formátu metadat (PBIR).

Uložení jako projektu pomocí PBIR

Když máte povolenou funkci PBIR Preview, při uložení projektu se sestava uloží do složky s názvem \definition uvnitř složky sestavy:

Přečtěte si další informace o struktuře složek PBIR.

Převod existujícího PBIP na PBIR

Pokud už máte PBIP ve formátu PBIR-Legacy, můžete ho převést na PBIR následujícím způsobem:

1. Otevřete PBIP v Power BI Desktopu.

2. Ujistěte se, že je povolená funkce Preview.

3. Uložte projekt. Zobrazí se výzva s žádostí o upgrade na PBIR.

4. Vyberte Upgrade.

   

   Důležité

   Po upgradu na PBIR se nemůžete vrátit zpět na PBIR-Legacy. Pokud si myslíte, že se možná budete chtít vrátit zpět na PBIR-Legacy, uložte nejdřív kopii souborů PBIP.

Existující soubor PBIR-Legacy (report.json) se nahradí složkou \definition obsahující reprezentaci PBIR sestavy.

Pokud vyberete možnost Zachovat aktuální formát, desktop znovu nezobrazí výzvu k upgradu.

Publikování sestavy PBIR do služby

Ve fázi Preview je jediným způsobem, jak publikovat sestavu s formátem PBIR, prostřednictvím integrace Gitu s prostředky infrastruktury. To zahrnuje připojení pracovního prostoru k úložišti Git a nasdílením sestavy PBIR, která se pak dá synchronizovat s pracovním prostorem služby v pozdější fázi.

Pokud chcete převést existující sestavu na PBIR ve službě, postupujte takto:

1. Připojte svůj pracovní prostor k Gitu.
2. Naklonujte úložiště Git do místního systému souborů.
3. Otevřete sestavu v Power BI Desktopu tak, že definition.pbir soubor otevřete.
4. Uložte sestavu a zvolte upgrade na PBIR.
5. Potvrďte a synchronizujte změny do Gitu.
6. Aktualizujte pracovní prostor nejnovějšími změnami z Gitu.

Složka a soubory PBIR

Definice sestavy se uloží do definition\ složky s následující strukturou:

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

Zásady vytváření názvů PBIR

Všechny názvy uvnitř hranatých závorek ([]) v předchozí tabulce se řídí výchozími konvencemi pojmenování, ale dají se přejmenovat na uživatelsky přívětivější názvy. Ve výchozím nastavení používají stránky, vizuály a záložky název objektu sestavy jako název souboru nebo složky. Tyto názvy objektů jsou zpočátku jedinečný identifikátor 20 znaků, například 90c2e07d8e84e7d5c026.

Přejmenování vlastnosti name v rámci každého souboru JSON se podporuje, ale může narušit externí odkazy uvnitř i mimo sestavu. Název objektu nebo název souboru nebo složky musí obsahovat jeden nebo více znaků slova (písmena, číslice, podtržítka) nebo pomlčky.

Po přejmenování souborů nebo složek PBIR je nutné restartovat Power BI Desktop. Po restartování zachová Power BI Desktop při ukládání původní názvy souborů nebo složek.

Schémata JSON PBIR

Každý soubor JSON PBIR obsahuje deklaraci schématu JSON v horní části dokumentu. Tato adresa URL schématu je veřejně přístupná a dá se použít k získání dalších informací o dostupných vlastnostech a objektech pro každý soubor. Kromě toho poskytuje integrovanou technologii IntelliSense a ověřování při úpravách pomocí editorů kódu, jako je Visual Studio Code.

Adresa URL schématu také definuje verzi dokumentu, která se má při vývoji definice sestavy změnit.

Tady jsou publikována všechna schémata JSON.

Poznámky PBIR

Poznámky můžete zahrnout jako páry název-hodnota v definici sestavy pro každou visualpage a report. I když Power BI Desktop tyto poznámky ignoruje, mohou být cenné pro externí aplikace, jako jsou skripty.

Můžete například zadat výchozí stránku pro sestavu v report.json souboru, kterou pak může využít skript nasazení.

{
  "$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í změny souborů PBIR

Soubory JSON PBIR můžete upravovat pomocí editoru kódu, jako je Visual Studio Code nebo externí nástroj, pokud soubor dodržuje schéma JSON. Pomocí nesprávného názvu nebo typu vlastnosti lze snadno rozpoznat přímo v editoru Visual Studio Code:

Externí změny obsahu PBIR můžou mít za následek chyby při opětovném otevření souborů v Power BI Desktopu. Tyto chyby můžou mít dva typy:

Blokování chyb brání otevření sestavy v Power BI Desktopu. Tyto chyby pomáhají identifikovat problém a chybný soubor, který je potřeba před opětovnou otevřením opravit:

Chyby, jako je neplatné schéma nebo chybějící požadované vlastnosti, se považují za blokující chyby. Tyto chyby lze snadno identifikovat otevřením souboru v editoru Visual Studio Code a kontrolou chyb schématu.

Neblokující chyby nezabrání Power BI Desktopu v otevření sestavy a automaticky se vyřeší.

Chyby, jako je neplatná konfigurace activePageName , jsou příklady chyb, které se automaticky opravují. Upozornění je nezbytné, abyste se vyhnuli uložení sestavy pomocí automatického opravy tím, že brání případné ztrátě práce.

Běžné chyby PBIR

Scénář: Po přejmenování názvů vizuálů nebo složek stránek se při otevření sestavy už můj vizuál nebo stránka nezobrazí.

Řešení: Ověřte, jestli název splňuje zásady vytváření názvů. Pokud ne, Power BI Desktop soubor nebo složku ignoruje a považuje ho za soukromé uživatelské soubory.

Scénář: Nové objekty sestavy se nazývají jinak než ostatní. Například většina složek stránek má název ReportSection0e71dafbc949c0853608, zatímco několik z nich má název 1b3c2ab12b603618070b.

Řešení: PBIR přijala novou konvenci pojmenování pro každý objekt, ale vztahuje se pouze na nové objekty. Když uložíte existující sestavu jako PBIP, aktuální názvy se musí zachovat, aby se zabránilo přerušení odkazů. Pokud chcete mít konzistenci, skript, který dávkové přejmenování povolíte.

Scénář: Zkopíroval(a) jsem soubor záložky a po uložení se většina konfigurace záložky odstranila.

Řešení: Toto chování je záměrné, záložky sestavy zachycují stav stránky sestavy spolu se všemi jeho vizuály. Vzhledem k tomu, že zachycený stav pochází z jiné stránky sestavy s různými vizuály, všechny neplatné vizuály se z konfigurace záložek odeberou. Pokud také zkopírujete závislé vizuály a stránku, záložka zachová svou konfiguraci.

Scénář: Zkopíroval(a) jsem složku stránky z jiné sestavy a narazil(a) na chybu s informací, že hodnota vlastnosti pageBinding.name musí být jedinečná.

Řešení: Objekt pageBinding je nezbytný pro podporu podrobné analýzy a popisů stránek. Vzhledem k tomu, že na tyto stránky můžou odkazovat jiné stránky, musí být název v rámci sestavy jedinečný. Na nově zkopírované stránce přiřaďte jedinečnou hodnotu k vyřešení chyby. Po červnu 2024 už tato situace není problém, protože název pageBinding je ve výchozím nastavení IDENTIFIKÁTOR GUID.

Aspekty a omezení PBIR

PBIR je aktuálně ve verzi Preview. Mějte na paměti následující skutečnosti:

• Omezení služeb
  • Mobilní zobrazení se nezobrazují v aplikacích Power BI.
  • Nejde nasadit s kanály nasazení.
  • Nelze uložit jako kopii.
• Velké sestavy s více než 500 soubory mají problémy s výkonem vytváření (zobrazení sestav není ovlivněno), včetně:
  • Ukládání v Power BI Desktopu
  • Synchronizace v integraci Gitu s prostředky infrastruktury
• Jakmile se sestava převede ze starší verze PBIR na PBIR, není možné ji vrátit zpět.
• Převod souboru PBIP na soubor PBIX pomocí funkce Uložit jako vloží sestavu PBIR do souboru PBIX a přenese všechna omezení PBIR na PBIX.

Omezení velikosti PBIR vynucená službou:

• Maximálně 1 000 stránek na sestavu
• Maximálně 300 vizuálů na stránku
• Maximálně 5 MB pro každý soubor záložky.
• Maximálně 1 MB pro každý soubor.
• Maximálně 1 000 souborů balíčků prostředků na sestavu
• Maximální velikost 300 mb pro všechny soubory balíčku prostředků.
• Maximální velikost všech souborů sestavy je 20 mb.

Během verze Public Preview při exportu definic sestavy budou integrace Infrastruktury Gitu a rozhraní REST API prostředků infrastruktury nadále používat pbIR-Legacy (report.json). Pokud je však sestava importována do prostředků infrastruktury pomocí formátu PBIR, začnou obě funkce exportovat definici sestavy pomocí formátu PBIR.

Související obsah

• Složka sémantického modelu projektu Power BI Desktopu
• Projekty Power BI Desktopu