Úprava souborů PBIP mimo Power BI Desktop

Když svou práci uložíte jako projekt Power BI Desktop, Power BI Desktop ukládá definice sestavy a sémantického modelu jako jednotlivé textové soubory. Podporované soubory můžete upravovat pomocí Visual Studio Code (VS Code) nebo jiného externího nástroje, zatímco projekt zůstane otevřený v Power BI Desktopu. Power BI Desktop zjistí změny uloženého souboru a vyzve vás, abyste je použili, takže projekt nemusíte zavřít a znovu otevřít.

Important

Projekty Power BI Desktop (PBIP) a vylepšený formát sestav Power BI (PBIR) jsou nyní všeobecně dostupné. Detekce a opětovné načtení externích změn PBIP v Power BI Desktopu je aktuálně ve verzi Preview.

V tomto článku se dozvíte:

  • Jak otevřít Visual Studio Code přímo z aplikace Power BI Desktop jako pohodlný vstupní bod pro úpravy souborů projektu.
  • Jak použít podporované změny v souborech sestavy a sémantického modelu v otevřené relaci aplikace Power BI Desktop.
  • Jak Power BI Desktop zpracovává konflikty mezi neuložené změny v Power BI Desktopu a změnami v souborech projektu.

Požadavky pro externí úpravy souborů PBIP

  • Nainstalujte na počítač Windows verzi Power BI Desktop ze srpna 2026 nebo novější.
  • V Power BI Desktop vyberte Soubor>Možnosti a nastavení>Možnosti>Funkce ve verzi Preview, povolte Rozpoznat a znovu načíst externí změny PBIP a potom restartujte aplikaci Power BI Desktop.
  • Nainstalujte Visual Studio Code nebo jiný editor kódu nebo externí nástroj.
  • Uložte projekt Power BI Desktop ve formátu PBIP. Další informace najdete v tématu Power BI Desktopové projekty.
  • Uložte kořenovou složku PBIP do takového umístění, aby žádná cesta k souboru projektu nepřesáhla omezení délky cesty ve Windows na 260 znaků.

Otevření složky PBIP ve VS Code

Power BI Desktop poskytuje integrovaný vstupní bod do složky projektu. V záhlaví vyberte název projektu a pak vyberte Visual Studio Code. VS Code otevře složku projektu jako aktivní pracovní prostor, ve kterém můžete přistupovat k souborům definice sestavy a sémantického modelu.

Snímek obrazovky s použitím VS Code

Poznámka:

VS Code otevře složku obsahující soubor, který jste použili k otevření projektu, což může být .pbip soubor nebo .pbir soubor.

Úprava souborů projektu a použití změn

Pomocí následujícího pracovního postupu ponechte soubory projektu a otevřenou relaci Power BI Desktopu synchronizovanou:

  1. V Power BI Desktopu před zahájením externích úprav souborů projektu vyberte Uložit. Power BI Desktop nezapisuje do souborů projektu nejnovější změny, dokud je neuložíte.
  2. Upravte podporovaný soubor sestavy nebo sémantického modelu ve VS Code nebo jiném externím nástroji.
  3. Uložte soubor v externím nástroji.
  4. V Power BI Desktopu vyberte v zobrazeném banneru možnost Použít externí změny.
  5. Zkontrolujte aktualizovanou sestavu nebo sémantický model v Power BI Desktopu a uložte projekt, až budete připraveni zachovat všechny následné změny provedené v Power BI Desktopu.

Power BI Desktop znovu načte ovlivněnou sestavu, sémantický model nebo obojí ze souborů projektu. Nenačítá jednotlivé soubory ani vizuály.

Snímek obrazovky s bannerem „Použít externí změny“.

Řešení neuložených změn v Power BI Desktopu

Pokud Power BI Desktop obsahuje neuložené změny, po výběru možnosti Použít externí změny se zobrazí upozornění, že se tyto změny přepíšou.

  • Výběrem možnosti Použít externí změny zahodíte neuložené změny v Power BI Desktopu a znovu načtěte nejnovější soubory projektu.
  • Vyberte Zrušit, pokud chcete zachovat neuložené změny v aplikaci Power BI Desktop. Změny v externím souboru zůstanou na disku, ale nepromítnou se do otevřené relace.

Snímek obrazovky zprávy o přepsání.

Important

Power BI Desktop a externí nástroje můžou vzájemně přepsat změny. Před přepnutím mezi nimi uložte nebo použijte aktuální změny, aby oba nástroje používaly stejné definice projektu.

Pomocí nástroje Power BI Desktop Bridge použijte externí změny

Externí změny můžete použít také programově pomocí Power BI desktopového mostu.

Úvahy a omezení

  • Detekce a opětovné načítání externích změn PBIP a Power BI Desktop Bridge jsou momentálně ve verzi Preview. Funkce a chování se můžou před obecnou dostupností změnit.
  • Externí úpravy a opětovné načítání platí pro projekty PBIP, ne .pbix soubory.
  • Power BI Desktop se znovu nenačítá cache.abf.
  • Opětovné načtení resetuje filtry a některé prvky uživatelského rozhraní.
  • Ne všechny soubory projektu podporují externí úpravy. Během náhledu opětovného načtení externích změn nemůžete upravovat definition.pbir, report.json, mobileState.json ani semanticModelDiagramLayout.json mimo aplikaci Power BI Desktop.
  • Pokud projekt obsahuje unappliedChanges.json, použijte tyto změny před úpravou sémantických výrazů modelu externě. V opačném případě Power BI Desktop zruší externí změny výrazu při použití nevyřízených změn.