Como usar visuais personalizados no Power BI: passo a passo

Os visuais nativos resolvem 90% dos casos, mas o problema aparece nos outros 10%#

Se você já chegou naquele ponto em que precisa de um gráfico que o Power BI simplesmente não entrega de fábrica, é aqui que os visuais personalizados Power BI entram em cena. Estamos falando de um Gantt de projeto, um gráfico de cascata mais rico que o nativo, um Sankey para fluxo de valores, ou um mapa de calor de calendário que a diretoria pediu depois de ver em algum relatório de fornecedor. O conjunto de visuais que vem embutido no Power BI Desktop é bom e cobre a maioria das necessidades corporativas, mas ele tem limites claros. Quando você bate nesses limites, o caminho oficial é o AppSource, o marketplace da Microsoft onde ficam os custom visuals.

O detalhe que quase ninguém conta na hora de mostrar um tutorial de dois cliques: importar um visual de terceiro tem implicações de segurança, governança e manutenção que vão muito além de deixar o dashboard bonito. Neste texto eu vou te levar pelo passo a passo real, do jeito que a gente orienta os clientes em projetos de Power BI, incluindo quando vale a pena usar, como instalar direito, os erros que mais quebram relatório em produção e as boas práticas que separam um ambiente sustentável de uma bagunça.

Visual personalizado é código de terceiro rodando dentro do seu relatório#

Antes de qualquer clique, entenda o que você está trazendo para dentro de casa. Um visual personalizado é um pacote (.pbiviz) escrito em TypeScript e D3, empacotado pela Microsoft ou por um desenvolvedor externo, que executa dentro do seu relatório. Ele pode ler os dados que você joga no campo dele. Isso não é motivo para pânico, mas é motivo para critério.

A Microsoft classifica os visuais do AppSource em três níveis, e essa distinção muda tudo na hora de decidir:

Tipo de visual	Origem	Passou por revisão da Microsoft	Acesso externo à internet	Recomendação de uso corporativo
Certificado	AppSource	Sim, revisão de código completa	Não pode chamar serviços externos	Preferencial
Não certificado	AppSource	Validação básica de publicação	Pode chamar serviços externos	Avaliar caso a caso
Importado de arquivo	Arquivo .pbiviz avulso	Nenhuma	Depende do código	Evitar sem análise

Visual certificado é o padrão-ouro. Ele passou por revisão de código da Microsoft, não acessa recursos externos e pode ser usado até em exportação para PowerPoint e PDF, coisa que os não certificados nem sempre suportam. Visual não certificado do AppSource ainda tem alguma validação de publicação, mas pode fazer chamadas para fora. E o pior cenário é o .pbiviz solto que alguém te mandou por e-mail: não passou por nenhum crivo e você está confiando cegamente em código desconhecido. Em ambiente sério, esse último não entra sem análise.

Você só deve usar custom visual quando o nativo realmente não resolve#

Minha opinião, depois de muito projeto: custom visual é ótimo servo e péssimo mestre. A tentação de sair instalando dez visuais bonitos é grande, mas cada um vira dependência que você precisa manter, testar em cada atualização e explicar para a área de segurança. A regra que eu uso é simples: primeiro esgote o nativo, depois considere o AppSource.

Vale usar visual personalizado quando:

• O tipo de gráfico não existe no nativo (Gantt, Sankey, gráfico de rede, timeline).
• O nativo existe mas é limitado demais para o caso (o gráfico de cascata nativo não lida bem com múltiplas categorias, por exemplo).
• Há um requisito de interação ou de storytelling que só o visual de terceiro entrega e o público justifica o esforço.

Não vale a pena quando o problema se resolve com um nativo bem configurado, quando o ganho é puramente estético num relatório operacional consumido por dezenas de pessoas todo dia, ou quando você não tem como garantir a manutenção daquele visual ao longo do tempo.

Antes de partir para o marketplace, muitas vezes o problema real não é o visual, é a modelagem. Um gráfico que não sai como você quer costuma ser sintoma de medida mal escrita ou modelo mal desenhado. Vale revisar a modelagem e as boas práticas de DAX antes de gastar energia importando componente novo.

O passo a passo para importar um visual do AppSource#

Agora a parte prática. O processo dentro do Power BI Desktop é direto, mas cada passo tem um detalhe que importa.

Passo 1: abra o painel de visualizações e vá em "Obter mais visuais"#

No painel de Visualizações, clique nos três pontinhos (as reticências) e escolha "Obter mais visuais". Isso abre a loja do AppSource diretamente dentro do Power BI, sem precisar sair para o navegador. Essa é a forma recomendada, porque você importa de dentro do ambiente controlado da Microsoft.

Passo 2: busque e filtre por certificados#

Use a caixa de busca para encontrar o visual pelo nome ou pela categoria. Sempre que possível, filtre ou priorize os visuais certificados. Leia a descrição, veja o número de downloads e a avaliação. Um visual com milhares de downloads e mantenedor conhecido é bem menos arriscado que um publicado ontem por alguém sem histórico.

Passo 3: adicione o visual#

Clique em "Adicionar". O ícone do novo visual aparece no painel de Visualizações junto com os nativos. A partir daí, é só selecioná-lo e arrastar os campos de dados como você faria com qualquer gráfico padrão.

Passo 4: configure campos e formatação#

Cada visual tem seus próprios buckets de campo (categoria, valores, legenda, e às vezes campos exclusivos como "task", "start date", "end date" num Gantt). Preencha conforme a documentação do visual. A formatação fica no painel de formato, igual aos nativos, mas o conjunto de opções varia bastante de um visual para outro.

Passo 5: teste a exportação e a publicação#

Antes de dar o trabalho por concluído, teste exportar o relatório para PDF e PowerPoint e publique no Power BI Service. Alguns visuais não certificados não renderizam em exportação estática e aparecem como um retângulo vazio. Melhor descobrir isso agora que depois de a diretoria receber um PDF furado.

A tabela abaixo resume os três caminhos possíveis de instalação e para quem cada um serve:

Método	Como funciona	Quando usar	Risco
AppSource pelo Desktop	"Obter mais visuais" dentro do Power BI	Uso geral, caminho padrão	Baixo
Arquivo .pbiviz	Importar de arquivo local	Visual interno ou em desenvolvimento	Alto sem análise
Repositório organizacional	Admin publica visuais aprovados no tenant	Empresas com governança madura	Baixo e controlado

O terceiro método, o repositório organizacional de visuais, é o que a gente recomenda para clientes com ambiente maduro. O administrador do tenant aprova uma lista curada de visuais no admin portal, e os usuários só enxergam aqueles. Isso elimina o risco de alguém importar qualquer coisa e ainda garante consistência entre relatórios. Se a sua empresa está nesse estágio, faz parte de uma estratégia mais ampla de governança de dados no Power BI.

Os erros mais comuns quebram relatório justamente em produção#

Depois de acompanhar muitos ambientes, os problemas com visuais personalizados são quase sempre os mesmos. Conhecê-los antes economiza horas de suporte.

Visual sumiu depois da publicação. Você importou o visual só naquele arquivo, publicou, e outra pessoa que abre o relatório não vê o gráfico ou vê um erro. Isso acontece quando o visual não está aprovado no tenant e a política de segurança bloqueia visuais não certificados. Solução: ou usar certificado, ou pedir para o admin liberar aquele visual no repositório organizacional.

Exportação para PDF vem vazia. Como já mencionei, visual não certificado pode não renderizar na exportação. Se o relatório vive de PDF distribuído, isso é um bloqueador. Teste antes.

Performance despencou. Alguns visuais de terceiro são pesados e mal otimizados. Quando você joga muitas linhas de dados dentro deles, o relatório trava. O nativo costuma ser mais eficiente porque a Microsoft otimiza a renderização. Se um visual custom está derrubando a performance, muitas vezes o certo é reduzir a granularidade dos dados ou voltar para o nativo.

Visual parou de funcionar depois de uma atualização. O desenvolvedor abandonou o projeto e o visual quebrou numa atualização do Power BI. Dependência de terceiro é isso: você não controla o roadmap dele.

Alerta de privacidade ignorado. Ao adicionar um visual não certificado, o Power BI avisa que ele pode acessar recursos externos. Muita gente clica em "OK" no automático. Em ambiente com dado sensível, esse aviso é para ser levado a sério e discutido com segurança.

A tabela a seguir cruza sintoma e causa provável para você diagnosticar rápido:

Sintoma	Causa mais provável	O que fazer
Gráfico não aparece para outros usuários	Visual não aprovado no tenant	Usar certificado ou liberar no admin portal
PDF ou PPT sem o visual	Visual não certificado não exporta	Trocar por certificado ou nativo
Relatório lento ao abrir	Visual pesado com muitos dados	Reduzir granularidade ou usar nativo
Erro após atualização do Power BI	Visual desatualizado ou abandonado	Verificar nova versão ou substituir
Aviso de acesso externo	Visual não certificado chama internet	Avaliar com segurança antes de aprovar

As boas práticas que mantêm o ambiente sustentável no longo prazo#

Instalar visual é fácil. Manter um ambiente com dezenas de relatórios e visuais de terceiro sem virar caos é o desafio real. Algumas práticas que valem para qualquer empresa:

Prefira certificados como política, não como exceção. Deixe claro no seu padrão interno que visual não certificado só entra com justificativa e aprovação. Isso corta 80% dos problemas antes de acontecerem.

Centralize a aprovação no repositório organizacional. Não deixe cada analista importar o que quiser. Uma lista curada de visuais aprovados dá consistência e reduz risco. Quem cuida disso é normalmente a equipe de governança ou o time de sustentação de BI.

Documente qual visual é usado onde. Se um visual for descontinuado, você precisa saber rápido quais relatórios dependem dele. Uma planilha simples de rastreamento já ajuda muito.

Padronize a formatação e teste a cada atualização. Um arquivo de tema (JSON) aplicado em todos os relatórios garante que o custom visual não fuja da identidade. E antes de rolar uma nova versão do Power BI para todo mundo, valide os relatórios críticos, porque a atualização mensal já quebrou visual de terceiro mais de uma vez.

Tenha um plano B nativo. Para relatórios críticos, saiba de antemão qual gráfico nativo você usaria se aquele custom visual sumir. Assim você não fica refém.

Essas práticas fazem parte de uma discussão maior sobre como estruturar o Power BI numa empresa de verdade, tema que a gente aprofunda no guia completo de Power BI para empresas no Brasil. E quando o assunto é escala, com muitos relatórios e times, entra também a conversa sobre plataforma, que hoje passa por Microsoft Fabric.

Perguntas frequentes#

Visuais personalizados do Power BI são gratuitos?

A maioria dos visuais no AppSource é gratuita, mas existem visuais pagos ou com versão premium que cobram por licença adicional, geralmente para desbloquear recursos avançados. O visual em si aparece de graça, e a cobrança acontece quando você tenta usar as funções pro. Sempre confira na descrição se há custo antes de padronizar o uso em vários relatórios, porque uma faixa de licença por usuário pode surpreender no orçamento. Os valores variam bastante conforme o fornecedor e o modelo de cobrança.

Posso criar meu próprio visual personalizado?

Sim. A Microsoft disponibiliza o SDK de visuais do Power BI, baseado em TypeScript e D3, e um desenvolvedor pode construir um visual sob medida, empacotar como .pbiviz e até publicar no AppSource. Faz sentido quando nenhum visual existente atende e o caso justifica o investimento de desenvolvimento e, principalmente, de manutenção contínua. Não é um caminho trivial, e você passa a ser responsável por manter aquele código funcionando a cada atualização do Power BI.

Visual não certificado é perigoso?

Não necessariamente, mas exige critério. Ele pode fazer chamadas para serviços externos, o que em ambiente com dado sensível é uma preocupação legítima de segurança e de LGPD. Para dashboards internos sem dado crítico, o risco é menor. Para informação regulada, fique nos certificados ou passe o visual por análise de segurança antes de aprovar. A dúvida sempre se resolve pelo tipo de dado que o visual vai enxergar.

Como bloquear que usuários importem qualquer visual?

No admin portal do Power BI, o administrador do tenant pode restringir visuais não certificados e definir um repositório organizacional com uma lista aprovada. Assim, os usuários só conseguem adicionar os visuais que a governança liberou. É a forma mais eficaz de controlar o risco em empresas com muitos criadores de relatório, e faz parte de qualquer projeto sério de governança de dados.

O visual personalizado funciona no aplicativo mobile e na exportação?

Depende do visual. Visuais certificados costumam funcionar bem no app mobile e na exportação para PDF e PowerPoint. Os não certificados podem não renderizar em exportação estática e ter comportamento inconsistente no mobile. Por isso a recomendação de testar esses cenários antes de considerar o relatório pronto, especialmente se o público consome pelo celular ou recebe PDFs.

Vale mais a pena usar custom visual ou melhorar a modelagem?

Quase sempre a modelagem vem primeiro. Muitos gráficos que parecem exigir um visual especial só precisam de uma medida DAX bem escrita ou de um modelo bem desenhado. O custom visual resolve o formato, não o dado por trás. Se a base está mal estruturada, nenhum visual bonito salva o relatório, e vale investir na fundação, o que muitas vezes passa por um bom trabalho de engenharia de dados.

Fechamento#

Visuais personalizados são uma ferramenta poderosa quando usados com critério e um foco de problema quando usados sem. A receita é simples de enunciar e difícil de disciplinar: esgote o nativo, prefira certificados, centralize a aprovação, teste a cada atualização e documente as dependências. Faça isso e o custom visual vira aliado. Ignore e ele vira mais uma fonte de suporte no meio da noite.

Se a sua empresa está lidando com um ambiente de Power BI que cresceu sem governança, com visuais espalhados e relatórios difíceis de manter, esse é exatamente o tipo de problema que a gente resolve todo dia. Fale com a gente e vamos organizar isso junto.