Sdílet prostřednictvím

Složka sestavy projektu Power BI Desktopu

  • Článek

Důležité

Projekty Power BI Desktopu jsou aktuálně ve verzi Preview.

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:

1 – Tento soubor je povinný.

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

Soubory sestav

.pbi\local Nastavení.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 místního Nastavení.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.

Při použití byConnection odkazu musí být zadány následující vlastnosti:

Vlastnost Popis
připojovací řetězec Připojovací řetězec odkazující na vzdálený sémantický model.
pbiModelDatabaseName ID vzdáleného sémantického modelu.
connectionType Typ připojení. Pro vzdálený sémantický model služby by tato hodnota měla být pbiServiceXmlaStyleLive.
pbiModelVirtualServerName Interní vlastnost, která by měla mít hodnotu, sobe_wowvirtualserver.

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.

Další informace najdete 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

Definuje sestavu včetně vizuálů, rozložení stránky a zamýšlených interakcí. Ve verzi Preview tento soubor nepodporuje externí úpravy.

.Platforma

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ů.

Související obsah