Ein Power BI-Visual verpacken

Bevor Sie Ihr benutzerdefiniertes Visuelles in Power BI Desktop laden oder mit der Community im Power BI Visual Gallery teilen können, müssen Sie es packen. In diesem Tutorial werden Sie:

• Stellen Sie Eigenschaftswerte und Metadaten für das visuelle Element bereit.
• Aktualisieren Sie das Symbol.
• Packen Sie das benutzerdefinierte visuelle Element.

Eigenschaftswerte eingeben

1. Beenden Sie die Visualisierung in PowerShell, wenn sie ausgeführt wird.

2. Navigieren Sie in VS Code zum Stammordner Ihres visuellen Projekts, und öffnen Sie die pbiviz.json Datei.

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

   

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

4. Füllen Sie die folgenden Felder in der dateipbiviz.json aus, oder ändern Sie sie:

   • visualClassName
   • description

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

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

   Der folgende Code zeigt supportUrl und gitHubUrl Beispiele:

   {
       "supportUrl": "https://community.powerbi.com",
       "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
   }
   

6. Geben Sie Ihren Namen und Ihre E-Mail in das author Objekt ein.

7. Speichern Sie die pbiviz.json Datei.

Aktualisieren des Symbols (optional)

1. Beachten Sie in der pbiviz.json-Datei, dass das Dokument einen Pfad zu einem Symbol in dem assets-Objekt definiert. Das Symbol ist das Bild, das im Bereich "Visualisierungen " in Power BI angezeigt wird. Es muss eine PNG-Formatdatei und 20 x 20 Pixel sein.

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

3. Erweitern Sie im Explorer-Bereich in VS Code den Ressourcenordner , und wählen Sie dann die icon.png Datei aus.

4. Überprüfen Sie das Symbol.

   

Verpacken des Visuellen

1. Stellen Sie in VS Code sicher, dass alle Dateien 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/" des visuellen Projekts erstellt und jede vorherige pbiviz-Datei überschrieben, die möglicherweise vorhanden ist.

   

Das Paket wird in den Ordner "/dist/" des Projekts ausgegeben. Das Paket enthält alles, was zum Importieren des benutzerdefinierten visuellen Elements in den Power BI-Dienst oder einen Power BI Desktop-Bericht erforderlich ist. Sie haben das benutzerdefinierte visuelle Element gepackt, und es ist einsatzbereit.

Verwandte Inhalte

• Veröffentlichen von Power BI-Visualisierungen im Partner Center
• Importieren eines benutzerdefinierten visuellen Elements