Compartir a través de

Empaquetado de un objeto visual de Power BI

  • Artículo

Para poder cargar el objeto visual personalizado en Power BI Desktop o compartirlo con la comunidad en la galería de objetos visuales de Power BI, tiene que empaquetarlo. Con este tutorial, hará lo siguiente:

Especificación de los valores de propiedad

  1. En PowerShell, detenga el objeto visual si se está ejecutando.

  2. En VS Code, vaya a la carpeta raíz del proyecto del objeto visual y abra el archivo pbiviz.json.

  3. En el objeto visual, establezca el valor displayName en lo que desea que sea el nombre para mostrar del objeto visual.

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

    El nombre para mostrar del objeto visual aparece en el panel Visualizaciones de Power BI al mantener el cursor sobre el icono del objeto visual.

  4. Rellene o modifique los siguientes campos en el archivo pbiviz.json:

    • visualClassName
    • description

    visualClassName es opcional, pero description debe rellenarse para que se ejecute el comando del paquete.

  5. Rellene supportUrl y gitHubUrl con las direcciones URL que un usuario puede visitar para obtener soporte técnico y ver el proyecto de GitHub del objeto visual.

    El código siguiente muestra los ejemplos supportUrl y gitHubUrl:

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

  6. Escriba su nombre y dirección de correo electrónico en el objeto author.

  7. Guarde el archivo pbiviz.json.

Actualización del icono (opcional)

  1. En el archivo pbiviz.json, observe que el documento define una ruta de acceso a un icono del objeto assets. El icono es la imagen que aparece en el panel Visualizaciones de Power BI. Debe ser un archivo en formato PNG y de 20 x 20 píxeles.

  2. En el Explorador de Windows, copie el archivo icon.png que quiera usar y péguelo para reemplazar el archivo icon.png predeterminado ubicado en la carpeta assets.

  3. En VS Code, en el panel Explorador, expanda la carpeta assets y, después, seleccione el archivo icon.png.

  4. Revise el icono.

Empaquetar el objeto visual.

  1. En VS Code, asegúrese de que se hayan guardado todos los archivos.

  2. En PowerShell, escriba el siguiente comando para generar un archivo pbiviz:

    pbiviz package

    Este comando crea un archivo pbiviz en el directorio /dist/ del proyecto del objeto visual y sobrescribe cualquier archivo pbiviz anterior.

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

El paquete se mostrará en la carpeta /dist/ del proyecto. El paquete contiene todo lo necesario para importar el objeto visual personalizado en el servicio Power BI o en un informe de Power BI Desktop. Ha empaquetado el objeto visual personalizado y está listo para usarse.

Pasos siguientes

Publicación de objetos visuales de Power BI en el Centro de partners

Importación de un objeto visual personalizado