Freigeben über


Packen eines Power BI-Visuals

Damit Sie Ihr benutzerdefiniertes visuelles Element in Power BI Desktop laden oder über den Power BI-Visualkatalog mit anderen Benutzern teilen können, müssen Sie ein Paket erstellen. In diesem Tutorial erhalten Sie Informationen zu den folgenden Vorgängen:

Eigenschaftswerte eingeben

  1. Beenden Sie das visuelle Element in PowerShell, wenn es ausgeführt wird.

  2. Navigieren Sie in VS Code zum Stammordner Ihres Visualprojekts, und öffnen Sie die pbiviz.js-Datei.

  3. Legen Sie im visual-Objekt den Wert displayName auf den gewünschten Anzeigenamen Ihres visuellen Elements fest.

    Screenshot of VS Code, which shows the display name value is set to Circle Card.

    Der Anzeigename des visuellen Elements wird im Bereich Visualisierungen von Power BI angezeigt, wenn Sie mit dem Cursor auf das Symbol des visuellen Elements zeigen.

  4. Füllen Sie die folgenden Felder in der Datei pbiviz.json aus, oder bearbeiten Sie sie ggf.:

    • visualClassName
    • description

    visualClassName ist optional, description muss jedoch ausgefüllt werden, damit der Paketbefehl ausgeführt werden kann.

  5. Füllen Sie supportUrl und gitHubUrl mit den URLs aus, die ein Benutzer aufrufen kann, um Support zu erhalten und das GitHub-Projekt Ihres visuellen Elements anzuzeigen.

    Der folgende Code zeigt Beispiele für supportUrl und gitHubUrl:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. Geben Sie Ihren Namen und Ihre E-Mail-Adresse in das author-Objekt ein.

  7. Speichern Sie die Datei pbiviz.json.

Aktualisieren des Symbols (optional)

  1. Achten Sie in der Datei pbiviz.json darauf, dass das Dokument einen Pfad zu einem Symbol im Objekt assets definiert. Das Symbol ist das Bild, das im Bereich Visualisierungen in Power BI angezeigt wird. Es muss sich um eine Datei im PNG-Format handeln, die 20 x 20 Pixel groß ist.

  2. Kopieren Sie im Windows-Explorer die Datei icon.png, die Sie verwenden möchten, und fügen Sie sie ein, um die Standarddatei icon.png im Ordner assets zu ersetzen.

  3. Erweitern Sie den Ordner assets im Bereich „Explorer“ in Visual Studio Code, und wählen Sie dann die Datei icon.png aus.

  4. Überprüfen Sie das Symbol.

Packen des Visuals

  1. Stellen Sie sicher, dass alle Dateien in VS Code gespeichert werden.

  2. Geben Sie in PowerShell den folgenden Befehl ein, um eine PBIVIZ-Datei zu generieren:

    pbiviz package
    

    Mit diesem Befehl wird eine PBIVIZ-Datei im Verzeichnis dist/ Ihres Visualisierungsprojekts erstellt. Bereits vorhandene PBIVIZ-Dateien werden hierbei überschrieben.

    Screenshot of Windows Explorer, which shows the folder hierarchy of the Power BI visual project. The dist folder is highlighted.

Das Paket wird in den Projektordner /dist/ ausgegeben. Das Paket erfüllt alle Voraussetzungen, damit das benutzerdefinierte Visual in den Power BI-Dienst oder in einen Power BI Desktop-Bericht importiert werden kann. Sie haben ein Paket für das benutzerdefinierte visuelle Element erstellt, und es kann verwendet werden.

Nächste Schritte