Compartilhar via

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ê vai:

Inserir 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 como o nome de exibição desejado para o seu visual.

    Captura de tela do VS Code, que mostra que o valor do nome de exibição está definido como Cartão Circular.

    O nome de exibição do visual aparece no painel Visualizações do Power BI quando você passa o cursor sobre o ícone 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 do pacote seja executado.

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

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

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

  6. Insira seu nome e email no author objeto.

  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 assets objeto. O ícone é a imagem que aparece no painel Visualizações no Power BI. Deve ser um arquivo de formato PNG e 20 x 20 pixels.

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

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

  4. Examine o ícone.

Empacotar o visual

  1. No VS Code, verifique se todos os arquivos são 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 visual e substitui qualquer arquivo pbiviz anterior que possa existir.

    Captura de tela do Windows Explorer, que mostra a hierarquia de pastas do projeto visual do Power BI. A pasta dist está realçada.

O pacote é enviado 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 um relatório do Power BI Desktop. Você embalou o visual personalizado, e agora ele está pronto para uso.

Conteúdo relacionado

  • Last updated on