Empacotar um visual do Power BI

Antes de carregar seu visual personalizado no Power BI Desktop ou compartilhá-lo com a comunidade na Galeria Visual do Power BI, você precisa empacotá-lo. Usando este tutorial, você aprenderá a:

• Fornecer valores de propriedade e metadados para o visual.
• Atualizar o ícone.
• Empacotar o visual personalizado.

Inseri valores de propriedade

1. No PowerShell, interrompa o visual se ele estiver em execução.

2. No VS Code, navegue até a pasta raiz do projeto visual e abra o arquivo pbiviz.json.

3. No objeto visual, defina o valor displayName para o que você deseja que seja o nome de exibição do seu visual.

   

   O nome de exibição do visual aparece no painel Visualizações do Power BI quando você passa o cursor sobre o ícone do visual.

4. Preencha ou modifique os seguintes campos no arquivo pbiviz.json:

   • visualClassName
   • description

   visualClassName é opcional, mas description deve ser preenchido para que o comando de pacote seja executado.

5. Preencha supportUrl e gitHubUrl com as URLs que um usuário pode visitar para obter suporte e exibir o projeto do GitHub do visual.

   O código a seguir mostra os exemplos supportUrl e gitHubUrl:

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

6. Insira seu nome e email no objeto author.

7. Salve o arquivo pbiviz.json.

Atualizar o ícone (opcional)

1. No arquivo pbiviz.json, observe que o documento define um caminho para um ícone no objeto assets. O ícone é a imagem que aparece no painel Visualizações no Power BI. Deve ser um arquivo no formato PNG e 20 x 20 pixels.

2. No Windows Explorer, copie o arquivo icon.png que deseja usar e cole-o para substituir o arquivo icon.png padrão localizado na pasta de ativos.

3. No VS Code, no painel Explorer, expanda a pasta assets e selecione o arquivo icon.png.

4. Verifique o ícone.

   

Empacotar o visual

1. No VS Code, verifique se todos os arquivos foram salvos.

2. No PowerShell, insira o seguinte comando para gerar um arquivo pbiviz:

   pbiviz package
   

   Esse comando cria um arquivo pbiviz no diretório dist/ do seu projeto de visual e substitui qualquer arquivo pbiviz já existente.

   

O pacote é gerado para a pasta /dist/ do projeto. O pacote contém tudo o que é necessário para importar o visual personalizado para o serviço do Power BI ou para um relatório do Power BI Desktop. Você empacotou o visual personalizado e ele está pronto para uso.

Próximas etapas

Publicar visuais do Power BI no Partner Center

Importar um visual personalizado