Struktur von Visualprojekten in Power BI
Der einfachste Weg, ein neues Power BI-Visual zu erstellen, ist die Verwendung des Tools pbiviz für Power BI-Visuals.
Um ein neues Power BI-Visual zu erstellen, navigieren Sie zu dem Verzeichnis, in dem Sie das Visual speichern möchten, und führen Sie den folgenden Befehl aus:
pbiviz new <visual project name>
Dieser Befehl erstellt einen Ordner für Power BI-Visuals, der die folgenden Dateien enthält:
project
├───.vscode
│ ├───launch.json
│ └───settings.json
├───assets
│ └───icon.png
├───node_modules
├───src
│ ├───settings.ts
│ └───visual.ts
├───style
│ └───visual.less
├───capabilities.json
├───package-lock.json
├───package.json
├───pbiviz.json
├───tsconfig.json
└───tslint.json
Beschreibung von Ordnern und Dateien
Diese Abschnitt stellt Informationen zu allen Ordnern und Dateien im Verzeichnis bereit, die vom pbiviz-Tool für Power BI-Visuals erstellt werden.
.vscode
Dieser Ordner enthält die Einstellungen für das VS-Codeprojekt.
Bearbeiten Sie die Datei .vscode/settings.json
, um Ihren Arbeitsbereich zu konfigurieren.
Weitere Informationen finden Sie unter Benutzer- und Arbeitsbereichseinstellungen.
Assets
Dieser Ordner enthält die Datei icon.png
.
Das Tool für Power BI-Visuals verwendet diese Datei als neues Power BI-Visualsymbol im Power BI-Visualisierungsbereich. Dieses Symbol muss eine PNG-Datei mit den Maßen 20 Pixel × 20 Pixel sein.
src
Dieser Ordner enthält den Quellcode des Visuals.
In diesem Ordner erstellt das Tool für Power BI-Visuals die folgenden Dateien:
visual.ts
: Dies ist der Hauptquellcode des Visuals. Erfahren Sie mehr über die visuelle API.settings.ts
: Dies ist der Code für die Einstellungen des Visuals. Die Klassen in der Datei stellen eine Schnittstelle für die Definition der Eigenschaften Ihres Visuals bereit.
Format
Dieser Ordner enthält die Datei visual.less
, in der sich die Formatvorlagen für das Visual befinden.
capabilities.json
Diese Datei enthält die wichtigsten Eigenschaften und Einstellungen (oder Funktionen) für das Visual. Damit kann das Visual unterstützte Features, Objekte, Eigenschaften und Zuordnungen von Datenansichten deklarieren.
package-lock.json
Diese Datei wird automatisch für Vorgänge generiert, in denen npm entweder die node_modules
-Struktur oder die Datei package.json
ändert.
Weitere Informationen zu dieser Datei finden Sie in der offiziellen Dokumentation zu npm-package-lock.json.
package.json
Diese Datei beschreibt das Projektpaket. Sie enthält Informationen zum Projekt, z. B. Autoren, Beschreibung und Abhängigkeiten des Projekts.
Weitere Informationen zu dieser Datei finden Sie in der offiziellen Dokumentation zu npm-package.json.
pbiviz.json
Diese Datei enthält die Metadaten des Visuals.
Eine pbiviz.json
-Beispieldatei mit Kommentaren, die die Metadateneinträge beschreiben, finden Sie im Abschnitt Metadateneinträge.
tsconfig.json
Eine Konfigurationsdatei für TypeScript.
Diese Datei muss den Pfad zur *.ts-Datei enthalten, in der sich die Hauptklasse des visuellen Elements befindet, wie in der visualClassName
-Eigenschaft der Datei pbiviz.json
angegeben.
tslint.json
Diese Datei enthält die TSLint-Konfiguration.
Metadateneinträge
Die Kommentare im folgenden Code aus der Datei pbiviz.json
beschreiben die Metadateneinträge. Bestimmte Metadaten (wie der Name und die E-Mail-Adresse des Autors) sind erforderlich, bevor das Visual gepackt werden kann.
Hinweis
- Ab Version 3.x.x des pbiviz-Tools wird
externalJS
nicht mehr unterstützt. - Versionsnummern sollten vier Ziffern im folgenden Format enthalten:
x.x.x.x
. - Um die Lokalisierung zu unterstützen, fügen Sie Ihrem Visual das Power BI-Gebietsschema hinzu.
{
"visual": {
// The visual's internal name.
"name": "<visual project name>",
// The visual's display name.
"displayName": "<visual project name>",
// The visual's unique ID.
"guid": "<visual project name>23D8B823CF134D3AA7CC0A5D63B20B7F",
// The name of the visual's main class. Power BI creates the instance of this class to start using the visual in a Power BI report.
"visualClassName": "Visual",
// The visual's version number.
"version": "1.0.0.0",
// The visual's description (optional)
"description": "",
// A URL linking to the visual's support page (optional).
"supportUrl": "",
// A link to the source code available from GitHub (optional).
"gitHubUrl": ""
},
// The version of the Power BI API the visual is using.
"apiVersion": "2.6.0",
// The name of the visual's author and email.
"author": { "name": "", "email": "" },
// 'icon' holds the path to the icon file in the assets folder; the visual's display icon.
"assets": { "icon": "assets/icon.png" },
// Contains the paths for JS libraries used in the visual.
// Note: externalJS' isn't used in the Power BI visuals tool version 3.x.x or higher.
"externalJS": null,
// The path to the 'visual.less' style file.
"style": "style/visual.less",
// The path to the `capabilities.json` file.
"capabilities": "capabilities.json",
// The path to the `dependencies.json` file which contains information about R packages used in R based visuals.
"dependencies": null,
// An array of paths to files with localizations.
"stringResources": []
}