Partilhar via

Empacotar um visual do Power BI

Antes de poderes carregar o teu visual personalizado no Power BI Desktop ou partilhá-lo com a comunidade na Power BI Visual Gallery, tens de o empacotar. Usando este tutorial, vai:

Introduza os valores das propriedades

  1. No PowerShell, pare o visual se este estiver a correr.

  2. No VS Code, navega até à pasta raiz do teu projeto visual e abre o ficheiropbiviz.json .

  3. No visual objeto, define o displayName valor para o nome de exibição do teu visual.

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

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

  4. Preencha ou modifique os seguintes campos no ficheiropbiviz.json :

    • visualClassName
    • description

    visualClassName é opcional, mas description deve ser preenchida para que o comando package seja executado.

  5. Preencha supportUrl e gitHubUrl com os URLs que o utilizador pode visitar para obter suporte e ver o projeto GitHub do seu visual.

    O seguinte código mostra exemplos de supportUrl e gitHubUrl:

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

  6. Insira o seu nome e email no author objeto.

  7. Guarda o ficheiro pbiviz.json.

Atualizar o ícone (opcional)

  1. No ficheiropbiviz.json , repare que o documento define um caminho para um ícone no assets objeto. O ícone é a imagem que aparece no painel de Visualizações no Power BI. Tem de ser um ficheiro em formato PNG e 20 x 20 pixels.

  2. No Explorador do Windows, copia o ficheiroicon.png que queres usar e depois cola-o para substituir o ficheiro icon.png predefinido localizado na pasta de assets.

  3. No VS Code, no painel do Explorador, expanda a pasta assets e depois selecione o ficheiro icon.png.

  4. Revê o ícone.

Prepare o elemento visual

  1. No VS Code, certifique-se de que todos os ficheiros estão guardados.

  2. No PowerShell, introduza o seguinte comando para gerar um ficheiro pbiviz :

    pbiviz package

    Este comando cria um ficheiro pbiviz no diretório /dist/ do seu projeto visual e sobrescrive qualquer ficheiro pbiviz anterior que possa existir.

    Captura de ecrã do Explorador do Windows, que mostra a hierarquia de pastas do projeto visual Power BI. A pasta do dist está destacada.

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 Power BI ou para um relatório Power BI Desktop. Empacotou o visual personalizado e está pronto a ser usado.

Conteúdo relacionado

  • Last updated on