Empaquetado de un objeto visual de Power BI

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:

• Proporcionar los valores de propiedad y los metadatos para el objeto visual.
• Actualizar el icono.
• Empaquetar el objeto visual personalizado.

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.

   

   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.

   

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