Power BI Desktop-Projektberichtsordner

In diesem Artikel werden die Dateien und Unterordner im Berichtsordner eines Microsoft Power BI Desktop-Projekts beschrieben. Die hier aufgeführten Dateien und Unterordner stellen einen Power BI-Bericht dar. Abhängig von Ihrem Projekt kann der Berichtsordner Folgendes umfassen:

1 – Diese Datei ist erforderlich.
2 – Diese Datei ist für PBIR-Legacy Format erforderlich.
3 – Diese Datei ist für das PBIR-Format erforderlich.

Nicht jeder Projektberichtsordner enthält alle hier beschriebenen Dateien und Unterordner.

Berichtsdateien

.pbi\localSettings.jsauf

Enthält Berichtseinstellungen, die nur für den aktuellen Benutzer und den lokalen Computer gelten. Sie sollte in gitIgnore oder anderen Quellcodeverwaltungsausschlüssen enthalten sein. Standardmäßig ignoriert Git diese Datei.

Weitere Informationen finden Sie im localSettings.json Schemadokument.

CustomVisuals\

Ein Unterordner, der Metadaten für benutzerdefinierte Visuals im Bericht enthält. Power BI unterstützt drei Arten von benutzerdefinierten Visuals:

  • Visuals im Organisationsspeicher: Organisationen können benutzerdefinierte Visuals für ihre Organisation genehmigen und in Power BI bereitstellen. Weitere Informationen finden Sie im Organisationsstore.
  • AppSource Power BI-Visuals: Auch bekannt als „Öffentliche benutzerdefinierte Visuals“. Diese Visuals sind über Microsoft AppSource verfügbar. Berichtsentwickler können diese Visuals direkt über Power BI Desktop installieren.
  • Benutzerdefinierte visuelle Dateien: Auch bekannt als „Private benutzerdefinierte Visuals“. Die Dateien können durch Hochladen eines pbiviz-Pakets in den Bericht geladen werden.

Nur private benutzerdefinierte Visuals werden in den CustomVisuals-Ordner geladen. AppSource- und Organisationsvisuals werden automatisch von Power BI Desktop geladen.

RegisteredResources\

Ein Unterordner, der für den Bericht spezifische und vom Benutzer geladene Ressourcendateien enthält, z. B. benutzerdefinierte Designs, Bilder und benutzerdefinierte Visuals (pbiviz-Dateien).

Entwickler sind hier für die Dateien verantwortlich, und Änderungen werden unterstützt. Beispielsweise können Sie eine Datei ändern, und nach einem Neustart von Power BI Desktop wird die neue Datei in den Bericht geladen. Dieser Ordner kann die Blockierung einiger nützlicher Szenarien aufheben, z. B.:

  • Erstellen benutzerdefinierter Themen außerhalb von Power BI Desktop mithilfe des öffentlichen Schemas.
  • Anwenden von Batchänderungen durch Ändern der Ressourcendatei für mehrere Berichte. Beispielsweise können Sie das benutzerdefinierte Thema des Unternehmens wechseln, zwischen hellen und dunklen Themen wechseln und Logobilder ändern.

Jede Ressourcendatei muss über einen entsprechenden Eintrag in der datei report.json verfügen. Bearbeitungen an RegisteredResources-Dateien werden nur für bereits geladene Ressourcen unterstützt, die dazu führen, dass Power BI Desktop die Ressource in report.json registrieren.

semanticModelDiagramLayout.json

Enthält Datenmodelldiagramme, die die Struktur des dem Bericht zugeordneten Semantikmodells beschreiben. Diese Datei unterstützt keine externe Bearbeitung.

definition.pbir

Enthält die Gesamtdefinition eines Berichts und die Kerneinstellungen. Diese Datei enthält auch den Verweis auf das vom Bericht verwendete Semantikmodell. Power BI Desktop kann eine PBIR-Datei direkt öffnen, genauso wie wenn der Bericht aus einer PBIP-Datei geöffnet wurde. Beim Öffnen einer PBIR-Datei wird auch das semantische Modell geöffnet, wenn ein relativer Verweis mit byPath verwendet wird.

Beispiel: definition.pbir:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    }    
  }
}

Die Definition enthält die datasetReference-Eigenschaft, die auf das im Bericht verwendete Semantikmodell verweist. Der Verweis kann Folgendes sein:

byPath – Gibt einen relativen Pfad zum Ordner des Zielsemantikmodells an. Absolute Pfade werden nicht unterstützt. Ein Schrägstrich (/) wird als Ordnertrennzeichen verwendet. Bei Verwendung öffnet Power BI Desktop das Semantikmodell auch im vollständigen Bearbeitungsmodus.

byConnection - Gibt die Verbindung mit einem semantischen Modell in einem Fabric-Arbeitsbereich mithilfe einer Verbindungszeichenfolge an. Wenn ein byConnection-Verweis verwendet wird, öffnet Power BI Desktop das Semantikmodell nicht im Bearbeitungsmodus.

Bei Verwendung eines byConnection-Verweises müssen die folgenden Eigenschaften angegeben werden:

Eigenschaft Beschreibung
Verbindungszeichenfolge Die Verbindungszeichenfolge, die auf das semantische Modell in einem Fabric-Arbeitsbereich verweist.

Beispiel für die Verwendung von byConnection:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "Data Source=\"powerbi://api.powerbi.com/v1.0/myorg/[WorkpaceName]\";initial catalog=[SemanticModelName];access mode=readonly;integrated security=ClaimsToken;semanticmodelid=[SemanticModelId]"
    }
  }
}

Beim Bereitstellen eines Berichts über die Fabric-REST-API müssen Sie nur die semanticmodelid Eigenschaft angeben. Beispiel:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "semanticmodelid=[SemanticModelId]"
    }
  }
}

Wichtig

Beim Bereitstellen eines Berichts über die Fabric-REST-API müssen Sie Verweise verwenden byConnection . Dies sollte nicht mit dem Speichermodus eines semantischen Modells wie DirectQuery verwechselt werden. Im datasetReference Bericht wird nur angegeben, mit welchem semantischen Modell der Bericht eine Verbindung herstellt, es wird nicht definiert, wie das Modell seine Daten speichert oder darauf zugreift.

Mehrere *.pbir-Dateien

Wenn das semantische Modell und der Bericht denselben Arbeitsbereich gemeinsam nutzen, exportiert Fabric Git Integration immer Definitionen mit einem byPath Verweis auf das Semantikmodell. Wenn Sie erzwingen möchten, dass der Bericht in Live Connect geöffnet wird (z. B. zum Arbeiten mit Measures auf Berichtsebene), können Sie mehrere *.pbir Dateien haben, z. B. eine datei mit einer ByPath-Verbindung und eine andere mit einer byConnection-Verbindung. Fabric Git Integration verarbeitet nur die Datei definition.pbir und ignoriert alle anderen *.pbir-Dateien. Diese Dateien können jedoch im selben Repository koexistieren.

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

Die definition.pbir Datei gibt auch die unterstützten Berichtsdefinitionsformate über die Eigenschaft "version" an.

Version Unterstützte Formate
1,0 Die Berichtsdefinition muss im PBIR-Legacy-Format in der Datei report.json gespeichert werden.
4.0 oder höher Die Berichtsdefinition kann als PBIR-Legacy (report.json Datei) oder PBIR (\Definition-Ordner) gespeichert werden.

Weitere Informationen finden Sie im Schemadokument definition.pbir.

mobileState.json

Enthält Einstellungen für Berichtsdarstellung und -verhalten beim Rendern auf einem mobilen Gerät. Diese Datei unterstützt keine externe Bearbeitung.

report.json

Diese Datei enthält die Berichtsdefinition im Legacyformat für Power BI-Berichte (PBIR-Legacy) und unterstützt keine externe Bearbeitung.

definition\ folder

Dieser Ordner ist nur verfügbar, wenn das Power BI-Projekt mithilfe des erweiterten Power BI-Berichtsformats (PBIR) gespeichert wird. Sie ersetzt die report.json Datei.

.Plattform

Fabric-Plattformdatei, die Eigenschaften enthält, die für das Herstellen und Verwalten der Verbindung zwischen Fabric-Elementen und Git unerlässlich sind.

Weitere Informationen finden Sie unter Git-Integration automatisch generierte Systemdateien.

PBIR-Format

Durch das Speichern Ihrer Power BI-Projektdateien (PBIP) mit dem erweiterten Power BI-Berichtsformat (PBIR) werden die Änderungsnachverfolgung und die Lösung von Mergekonflikten erheblich verbessert, indem ordnungsgemäß formatierte JSON-Dateien verwendet werden.

Screenshot: Benutzerfreundliche PBIR-Diffs

Jede Seite, jedes Visual, jede Textmarke usw. befindet sich in einer separaten einzelnen Datei innerhalb einer Ordnerstruktur. Dieses Format eignet sich ideal für die Konfliktlösung bei der Koentwicklung.

Screenshot des benutzerfreundlichen PBIR-Ordners.

Im Gegensatz zum PBIR-Legacy-Format (report.json) ist PBIR ein öffentlich dokumentiertes Format, das Änderungen von Anwendungen außerhalb von Power BI unterstützt. Jede Datei verfügt über ein öffentliches JSON-Schema, mit dem nicht nur die Datei dokumentiert, sondern auch ermöglicht wird, dass Code-Editoren wie Visual Studio Code während der Bearbeitung eine Syntaxüberprüfung durchführen.

Einige der mit dem PBIR-Format jetzt möglichen Szenarios sind:

  • Kopieren von Seiten, Visuals und Textmarken zwischen Berichten
  • Sicherstellen von Konsistenz bei einer Gruppe von Visuals auf allen Seiten durch Kopieren und Einfügen der Visualdateien
  • Einfaches Suchen und Ersetzen in mehreren Berichtsdateien gleichzeitig
  • Anwenden einer Batchbearbeitung auf alle Visuals mithilfe eines Skripts (z. B. Ausblenden von Filtern auf Visualebene)

Speichern als Projekt im PBIR-Format

Wenn Sie ein Projekt mithilfe von PBIR speichern, wird ihr Bericht in einem Ordner mit dem Namen \definition innerhalb des Berichtsordners gespeichert:

Screenshot des Definitionsordners innerhalb eines PbIP-Berichtsordners.

Erfahren Sie mehr über die PBIR-Ordnerstruktur.

PBIR-Ordner und -Dateien

Die Berichtsdefinition wird im Ordner definition\ mit der folgenden Struktur gespeichert:

├── bookmarks\
│   ├── [bookmarkName].bookmark.json
|   └── bookmarks.json
├── pages\
│   ├── [pageName]\
│   |   ├── \visuals
|   │   |   ├── [visualName]\
|   |   │   │   |── mobile.json
|   |   |   └   └── visual.json
|   |   └── page.json
|   └── pages.json
├── version.json
├── reportExtensions.json
└── report.json
Datei/Ordner Erforderlich Beschreibung
Lesezeichen\ Nein Ordner mit allen Textmarkendateien des Berichts
—- [bookmarkName].bookmark.json Nein Metadaten zu Textmarken, z. B. Zielvisuals und Filter.
Weitere Informationen finden Sie im Schema.
—- bookmarks.json Nein Metadaten zu Textmarken, z. B. Reihenfolge der Textmarken und Gruppen.
Weitere Informationen finden Sie im Schema.
Seiten\ Ja Ordner mit allen Seiten des Berichts
—- [pageName]\ Ja Ein Ordner pro Seite
──── Bilder\ Nein Ordner mit allen visuellen Elementen der Seite
────── [visualName]\ Nein Ein Ordner pro Visual
──────── mobile.json Nein Metadaten zum mobilen Layout von Visuals, z. B. Position und Formatierung auf mobilen Geräten.
Weitere Informationen finden Sie im Schema.
─────── visual.json Ja Metadaten zum Visual, z. B. Position und Formatierung sowie Abfragen.
Weitere Informationen finden Sie im Schema.
––– page.json Ja Metadaten zur Seite, z. B. Filter und Formatierung auf Seitenebene.
Weitere Informationen finden Sie im Schema.
—- pages.json Nein Metadaten zu Seiten, z. B. Reihenfolge der Seiten und aktive Seite.
Weitere Informationen finden Sie im Schema.
version.json Ja Neben anderen Faktoren ist die PBIR-Dateiversion entscheidend dafür, welche erforderlichen Dateien geladen werden.
Weitere Informationen finden Sie im Schema.
reportExtensions.json Nein Berichtserweiterungen, z. B. Measures auf Berichtsebene.
Weitere Informationen finden Sie im Schema.
report.json Ja Metadaten zum Bericht, z. B. Filter und Formatierung auf Berichtsebene.
Weitere Informationen finden Sie im Schema.

Wichtig

Einige Berichtsmetadatendateien, z. B. visual.json oder bookmarks.json, können mit Datenwerten aus Dem semantischen Modell gespeichert werden. Wenn Sie beispielsweise einen Filter auf ein visuelles Element für das Feld "Unternehmen" = "Contoso" anwenden, wird der Wert "Contoso" als Teil der Metadaten beibehalten. Dies gilt auch für andere Konfigurationen wie Slicerauswahl, Matrizen mit benutzerdefinierter Spaltengruppe und Formatierungen für bestimmte Datenreihen.

PBIR-Namenskonvention

Alle Namen innerhalb der eckigen Klammern ([]) in der vorherigen Tabelle folgen einer Standardbenennungskonvention, können jedoch in benutzerfreundlichere Namen umbenannt werden. Standardmäßig verwenden Seiten, visuelle Elemente und Lesezeichen ihren Berichtsobjektnamen als Datei- oder Ordnernamen. Diese Objektnamen sind anfänglich ein eindeutiger Bezeichner mit 20 Zeichen, z. B. "90c2e07d8e84e7d5c026".

Screenshot: PBIR-Namenseigenschaft

Das Umbenennen der Eigenschaft "name" in jeder JSON-Datei wird unterstützt, kann aber externe Verweise sowohl innerhalb als auch außerhalb des Berichts unterbrechen. Der Objektname und/oder Datei-/Ordnername muss aus mindestens einem Wortzeichen (Buchstaben, Ziffern, Unterstrichen) oder Bindestrichen bestehen.

Nach dem Umbenennen von PBIR-Dateien oder -Ordnern müssen Sie Power BI Desktop neu starten. Beim Neustart behält Power BI Desktop beim Speichern die ursprünglichen Datei- oder Ordnernamen bei.

Name des Berichtsobjekts kopieren

Jedes Objekt im Bericht wird in einem separaten Ordner oder in einer separaten Datei gespeichert, der Name des Ordners ist jedoch nicht immer offensichtlich. Um dies zu vereinfachen, können Sie den Namen eines berichtsobjektnamens (einschließlich Seiten, visueller Elemente, Lesezeichen und Filter) direkt aus Power BI in Ihre Zwischenablage kopieren.

Screenshot eines Berichts mit einem Pfeil, der von einem der visuellen Elemente auf den Namen der entsprechenden Datei zeigt.

  1. Wechseln Sie zu Datei > Optionen und Einstellungen > Berichtseinstellungen > Berichtsobjekte und aktivieren Sie die Einstellung Objektnamen kopieren bei Rechtsklick auf Berichtsobjekte. Dies muss nur einmal erfolgen.

    Screenshot: Einstellungen der Berichtsobjekte

  2. Klicken Sie mit der rechten Maustaste auf ein beliebiges Berichtsobjekt, und wählen Sie "Objektnamen kopieren" aus.

    Screenshot eines Desktopberichts, bei dem die Option zum Kopieren des Objektnamens ausgewählt ist.

Wenn der Objektname in die Zwischenablage kopiert wurde, können Sie ihn ganz einfach in die Suchleiste von Windows Explorer oder Visual Studio Code eingeben, um den Objektnamen im PBIR-Ordner zu suchen oder zu identifizieren.

Screenshot der Suchleiste mit dem Namen des Objekts.

PBIR-JSON-Schemas

Jede PBIR JSON-Datei enthält eine JSON-Schemadeklaration am Anfang des Dokuments. Diese Schema-URL ist öffentlich zugänglich und kann verwendet werden, um mehr über die verfügbaren Eigenschaften und Objekte für jede Datei zu erfahren. Darüber hinaus bietet es integrierte IntelliSense und Validierung beim Bearbeiten mit Code-Editoren wie Visual Studio Code.

Screenshot: QuickInfo zum PBIR-JSON-Schema in der Eingabeaufforderung

Mit der Schema-URL wird auch die Version des Dokuments definiert. Es wird erwartet, dass diese sich mit der Weiterentwicklung der Berichtsdefinition ändert.

Alle JSON-Schemas werden hier veröffentlicht.

PBIR-Anmerkungen

Sie können Anmerkungen als Name-Wert-Paare in die Berichtsdefinition für jedes visual, page und report aufnehmen. Während Power BI Desktop diese Anmerkungen ignoriert, können sie für externe Anwendungen wie Skripts nützlich sein.

So könnten Sie beispielsweise die defaultPage für den Bericht in der report.json Datei angeben, die dann von einem Bereitstellungsskript verwendet werden kann.

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

Externe Änderungen an PBIR-Dateien

Sie können unterstützte PBIR-JSON-Dateien in einem Code-Editor wie Visual Studio Code oder einem anderen externen Tool bearbeiten, während das Projekt in Power BI Desktop geöffnet bleibt. Wenn Sie die Dateien speichern, erkennt Power BI Desktop die Änderungen und zeigt das Banner "Externe Änderungen anwenden" an. Wählen Sie "Externe Änderungen anwenden" aus, um die Berichtsdefinition neu zu laden, ohne das Projekt zu schließen und erneut zu öffnen.

Bevor Sie PBIR-Dateien extern bearbeiten, speichern Sie alle Änderungen in Power BI Desktop. Wenn in Power BI Desktop ungespeicherte Änderungen vorliegen, wenn Sie die externen Änderungen anwenden, warnt es Sie, dass die ungespeicherten Änderungen überschrieben werden. Die vollständigen Workflows und Einschränkungen finden Sie unter "Bearbeiten von PBIP-Dateien außerhalb Power BI Desktops".

PBIR-Dateien müssen ihren JSON-Schemas entsprechen. VS Code identifiziert Probleme wie einen nicht unterstützten Eigenschaftennamen oder einen falschen Eigenschaftstyp:

Screenshot: QuickInfo zur PBIR-JSON-Schemaüberprüfung in der Eingabeaufforderung

Externe Änderungen an PBIR-Inhalten können zu Fehlern führen, wenn Sie die Änderungen anwenden oder die Dateien in Power BI Desktop öffnen. Es kann sich dabei um zwei Arten von Fehlern handeln:

Das Blockieren von Fehlern verhindert, dass Power BI Desktop die Berichtsänderungen lädt. Diese Fehler identifizieren das Problem und die Datei, die Sie beheben müssen, bevor Sie die Änderungen erneut anwenden:

Screenshot: Eingabeaufforderung bei blockierendem Fehler in PBIR-Inhalten

Fehler wie ein ungültiges Schema oder fehlende erforderliche Eigenschaften blockieren Fehler. Um diese Fehler zu identifizieren, öffnen Sie die Datei in VS Code, und überprüfen Sie die Schemaüberprüfungsmeldungen.

Nicht blockierende Fehler verhindern nicht, dass Power BI Desktop den Bericht öffnet und automatisch aufgelöst wird.

Screenshot: Eingabeaufforderung bei nicht blockierendem Fehler in PBIR-Inhalten

Eine ungültige activePageName Konfiguration ist ein Beispiel für einen nichtblockierenden Fehler, den Power BI Desktop automatisch behebt. Die Warnung bietet Ihnen die Möglichkeit, die Korrektur zu überprüfen, bevor Sie den Bericht speichern und die externe Definition überschreiben.

Häufige PBIR-Fehler

Szenario:Nach dem Umbenennen visueller oder Seitenordnernamen wird meine visuelle oder Seite beim Öffnen des Berichts nicht mehr angezeigt.

Lösung: Überprüfen Sie, ob der Name der Benennungskonvention entspricht. Wenn nicht, ignoriert Power BI Desktop die Datei oder den Ordner und behandelt die Dateien als private Benutzerdateien.

Szenario:Neue Berichtobjekte werden anders als andere benannt. Die meisten Seitenordner heißen beispielsweise "ReportSection0e71dafbc949c0853608", während einige den Namen "1b3c2ab12b603618070b" tragen.

Lösung: PBIR hat für jedes Objekt eine neue Benennungskonvention eingeführt, gilt jedoch nur für neue Objekte. Wenn Sie einen bereits vorhandenen Bericht als PBIP speichern, müssen die aktuellen Namen beibehalten werden, um zu verhindern, dass Verweise nicht mehr funktionieren. Wenn eine konsistente Benennung gewünscht ist, ist eine Umbenennung in Batches mithilfe eines Skripts zulässig.

Szenario:Ich habe eine Lesezeichen-Datei kopiert, und beim Speichern wurden die meisten der Lesezeichen-Konfigurationen gelöscht.

Lösung: Dieses Verhalten ist beabsichtigt, Berichtsmarken erfassen den Status einer Berichtsseite zusammen mit allen visuellen Elementen. Da der erfasste Zustand von einer anderen Berichtsseite mit anderen Visuals stammt, werden alle ungültigen Visuals aus der Textmarkenkonfiguration entfernt. Wenn Sie auch die abhängigen Visuals und Seiten kopieren, wird die Konfiguration der Textmarke beibehalten.

Szenario:Ich habe einen Seitenordner aus einem anderen Bericht kopiert und einen Fehler festgestellt, der besagt: "Werte für die Eigenschaft 'pageBinding.name' müssen eindeutig sein."

Lösung: Das pageBinding-Objekt ist erforderlich, um Drillthrough- und Seiten-Tooltips zu unterstützen. Da auf diese Objekte möglicherweise von anderen Seiten verwiesen wird, muss ihr Name innerhalb des Berichts eindeutig sein. Weisen Sie auf der neu kopierten Seite einen eindeutigen Wert zu, um den Fehler zu beheben. Nach Juni 2024 stellt diese Situation kein Problem mehr dar, da die Namen von pageBinding-Objekten standardmäßig GUIDs sind.

Konvertieren eines vorhandenen Berichts in PBIR

PBIR ist allgemein verfügbar und ist das Standardberichtsformat. Sie können weiterhin Berichte, die PBIR-Legacy verwenden, in Power BI Desktop und im Power BI-Dienst öffnen. Wenn Sie einen PBIR-Legacy-Bericht bearbeiten und speichern, konvertiert Power BI ihn stillschweigend und automatisch in PBIR.

Vor der Konvertierung erstellt Power BI eine Sicherung des Berichts:

  • Power BI Desktop behält die Sicherung 30 Tage lang an einem der folgenden Speicherorte bei:
    • Microsoft Store-Version: %USERPROFILE%\Microsoft\Power BI Desktop Store App\TempSaves\Backups
    • Ausführbare Installationsprogrammversion: %USERPROFILE%\AppData\Local\Microsoft\Power BI Desktop\TempSaves\Backups
  • Der Power BI-Dienst bewahrt die PBIR-Legacy-Sicherung 28 Tage lang auf. Um sie wiederherzustellen, öffnen Sie Berichtseinstellungen aus dem Arbeitsbereich, und wählen Sie "Als PBIR-Legacy wiederherstellen" aus. Diese Sicherung wird nur für Berichte erstellt, die direkt in der Power BI-Dienst konvertiert wurden.

Durch das Wiederherstellen einer PBIR-Legacy Sicherung wird keine andere Konvertierung verhindert. Um einen Bericht im PBIR-Legacy Format beizubehalten, bearbeiten Sie ihn nicht im Power BI-Dienst, oder verwenden Sie eine Version von Power BI Desktop, die vor September 2026 veröffentlicht wurde.

Überlegungen zum und Einschränkungen beim PBIR-Format

Beachten Sie die folgenden Überlegungen und Einschränkungen:

  • Visuelle automatische Filter werden nur dann in der PBIR-Datei visual.json beibehalten, nachdem der Filterbereich mindestens einmal beim Bearbeiten des Berichts erweitert wurde.
  • Wenn Power BI beim Bearbeiten und Speichern keinen PBIR-Legacy Bericht in PBIR konvertiert, ist ein Produktproblem aufgetreten. Erstellen Sie eine Supportanfrage , um das Problem zu melden.

Die folgenden PBIR-Größenbeschränkungen werden vom Dienst erzwungen:

  • Maximal 1.000 Seiten pro Bericht
  • Maximal 1000 visuelle Elemente pro Seite.
  • Maximal 1.000 Ressourcenpaketdateien pro Bericht
  • Max. Größe von 300 MB für alle Ressourcenpaketdateien.
  • Maximale Größe von 300 MB aller Berichtsdateien.

Wichtig

Wenn Sie die oben genannten Grenzwerte erreichen, sollten Sie den Bericht optimieren. Siehe das Power BI-Optimierungsdokument.

Fabric Git Integration und Fabric REST-APIs exportieren Berichtsdefinitionen mithilfe von PBIR.

Zugehöriger Inhalt

  • Last updated on