Creare un pacchetto di un oggetto visivo di Power BI

  • Articolo

Prima di caricare l'oggetto visivo personalizzato in Power BI Desktop o condividerlo con la community nella raccolta di oggetti visivi di Power BI, è necessario includerlo in un pacchetto. Questa esercitazione illustra come:

Immettere i valori delle proprietà

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

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

  3. Nell'oggetto visual, impostare il valore displayName su quello che si desidera che sia il nome visualizzato dell'oggetto visivo.

    Screenshot di VS Code, che mostra il valore del nome visualizzato impostato su Circle Card.

    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. Compilare supportUrl 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 gli esempi supportUrl ed gitHubUrl:

    {
    "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 per 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 di icon.png predefinito che si trova nella cartella assets.

  3. Nel riquadro Explorer VS Codeespandere la cartella asset 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 eventuali file pbiviz precedenti che potrebbero esistere.

    Screenshot di Esplora risorse, che mostra la gerarchia di cartelle del progetto visivo di Power BI. La cartella dist è evidenziata.

Il pacchetto restituisce la cartella /dist/ del progetto. Il pacchetto contiene tutto il necessario 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