Creare un pacchetto di un oggetto visivo di Power BI

Prima di caricare l'oggetto visivo personalizzato in Power BI Desktop o condividerlo con la community in Power BI Visual Gallery, è necessario crearne il pacchetto. Usando questa esercitazione, si eseguiranno le seguenti attività:

• Specificare i valori e i metadati delle proprietà per l'oggetto visivo.
• Aggiornare l'icona.
• Creare un pacchetto dell'oggetto visivo personalizzato.

Immettere i valori delle proprietà

1. In PowerShell arrestare l'oggetto visivo se è in esecuzione.

2. In VS Code passare alla cartella radice del progetto visivo e aprire il file pbiviz.json .

3. Nell'oggetto visual impostare il displayName valore sul nome visualizzato dell'oggetto visivo.

   

   Il nome visualizzato dell'oggetto visivo viene visualizzato nel riquadro Visualizzazioni di Power BI quando si passa il cursore sull'icona dell'oggetto visivo.

4. Compilare o modificare i campi seguenti nel file pbiviz.json :

   • visualClassName
   • description

   visualClassName è facoltativo, ma description deve essere compilato per l'esecuzione del comando del pacchetto.

5. supportUrl Compilare e gitHubUrl con gli URL che un utente può visitare per ottenere supporto e visualizzare il progetto GitHub dell'oggetto visivo.

   Il codice seguente illustra supportUrl ed gitHubUrl esempi:

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

6. Immettere il nome e l'indirizzo di posta elettronica nell'oggetto author .

7. Salvare il file pbiviz.json .

Aggiornare l'icona (facoltativo)

1. Nel file pbiviz.json si noti che il documento definisce un percorso di un'icona nell'oggetto assets . L'icona è l'immagine visualizzata nel riquadro Visualizzazioni in Power BI. Deve essere un file di formato PNG e 20 x 20 pixel.

2. In Esplora risorse copiare il file icon.png da usare e incollarlo per sostituire il file icon.png predefinito che si trova nella cartella assets.

3. Nel riquadro Esplora risorse di VS Code espandere la cartella assets e quindi selezionare il file icon.png .

4. Esaminare l'icona.

   

Creare un pacchetto dell'oggetto visivo

1. In VS Code assicurarsi che tutti i file vengano salvati.

2. In PowerShell immettere il comando seguente per generare un file pbiviz :

   pbiviz package
   

   Questo comando crea un file pbiviz nella directory /dist/ del progetto visivo e sovrascrive qualsiasi file pbiviz precedente che potrebbe esistere.

   

Il pacchetto restituisce la cartella /dist/ del progetto. Il pacchetto contiene tutti gli elementi necessari per importare l'oggetto visivo personalizzato nel servizio Power BI o in un report di Power BI Desktop. L'oggetto visivo personalizzato è stato creato in un pacchetto ed è pronto per l'uso.

Contenuto correlato

Pubblicare oggetti visivi di Power BI nel Centro per i partner

Importare un oggetto visivo personalizzato