Compartir a través de


Empaquetar 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, debe empaquetarlo. Con este tutorial, hará lo siguiente:

Introducir valores de propiedad

  1. En PowerShell, detén el componente visual si está en ejecución.

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

  3. En el objeto visual, establezca el valor displayName en el nombre que desea utilizar como nombre para mostrar de su visual.

    Captura de pantalla de VS Code, que muestra que el valor del nombre para mostrar está configurado como Circle Card.

    El nombre para mostrar del objeto visual aparece en el panel Visualizaciones de Power BI cuando se pasa el cursor sobre el icono del objeto visual.

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

    • visualClassName
    • description

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

  5. Complete supportUrl y gitHubUrl con las direcciones URL que un usuario puede visitar para obtener soporte técnico y para ver el proyecto de GitHub de su visualización.

    El código siguiente muestra supportUrl y gitHubUrl ejemplos:

    {
        "supportUrl": "https://community.powerbi.com",
        "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
    }
    
  6. Escriba el nombre y el correo electrónico en el author objeto .

  7. Guarde el archivo pbiviz.json .

Actualizar el icono (opcional)

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

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

  3. En VS Code, en el panel Explorador, expanda la carpeta assets y, a continuación, seleccione el archivo icon.png .

  4. Revise el icono.

Empaquetar el objeto visual

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

  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 visual y sobrescribe cualquier archivo pbiviz anterior que pueda existir.

    Captura de pantalla del Explorador de Windows, que muestra la jerarquía de carpetas del proyecto visual de Power BI. La carpeta dist está resaltada.

Los archivos del paquete se colocan 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 su uso.