Freigeben über

Power BI Desktop-Projektberichtsordner

  • Artikel

Wichtig

Power BI Desktop-Projekte befinden sich derzeit in der Vorschau.

In diesem Artikel werden die Dateien und Unterordner im Ordner Bericht 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.

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

Berichtsdateien

.pbi\localSettings.json

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 Schemadokument zu localSettings.json.

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 unter Organisationsspeicher.
  • 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 einen entsprechenden Eintrag in der Datei report.json aufweisen, der während der Vorschau keine Bearbeitung unterstützt. 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. Während der Vorschau unterstützt diese Datei 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, genau so, als würde der Bericht aus einer pbip-Datei geöffnet. Beim Öffnen einer pbir-Datei wird auch das Semantikmodell geöffnet, wenn ein relativer Verweis mit byPath verwendet wird.

Beispiel: definition.pbir:

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

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 ein Remotesemantikmodell im Power BI-Dienst 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
connectionString Die Verbindungszeichenfolge, die auf das Remotesemantikmodell verweist.
pbiModelDatabaseName Die ID des Remotesemantikmodells.
connectionType Der Typ der Verbindung. Für das Remotesemantikmodell des Diensts sollte dieser Wert pbiServiceXmlaStyleLive sein.
pbiModelVirtualServerName Eine interne Eigenschaft, die den Wert sobe_wowvirtualserver haben sollte.

Beispiel für die Verwendung von 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
    }
  }
}

Wenn das semantische Modell und der Bericht denselben Arbeitsbereich gemeinsam nutzen, verwendet Fabric Git Integration immer einen byPath-Verweis auf das Semantikmodell.

Weitere Informationen finden Sie im Schemadokument zu 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

Definiert einen Bericht mit Visuals, Seitenlayout und beabsichtigten Interaktionen. Während der Vorschau unterstützt diese Datei keine externe Bearbeitung.

Warnungsplattform beizubehalten.

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.

Zugehöriger Inhalt