---
name: powerbi-visuais
description: Escolha, configuração e crítica de visuais no Power BI — barras, linhas, pizza, KPI, gauge, tabela, matriz, mapa, visuais de IA, segmentação, formatação condicional, tooltip page, small multiples, painel de análise, temas e visuais gerados por medida DAX (SVG e HTML). Use quando o usuário perguntar qual visual usar, pizza ou barras, gauge ou KPI, como configurar ou melhorar um gráfico, dashboard poluído, formatação condicional, tooltip, sparkline ou barra de progresso por DAX. Para a mensagem da página use data-storytelling; para planejar o dashboard use dashboard-canvas.
---

# Visuais no Power BI

## Pergunta central

> O que eu quero que o usuário conclua ao olhar para isso?

O visual serve à conclusão. Antes de sugerir qualquer visual, responda as cinco
dimensões:

| Dimensão | Pergunta |
|---|---|
| Objetivo | Comparar, tendência, proporção, correlação, progresso vs meta ou causa? |
| Tipo de dado | Categórico, numérico, temporal, geográfico, hierárquico? |
| Audiência | Executivo (síntese), analista (exploração), operador (monitoramento)? |
| Espaço | KPI em célula pequena ou área ampla? |
| Interatividade | Leitura passiva ou exploração com drill e filtro? |

## Regras

**Obrigatório**
- Classifique a pergunta analítica antes de sugerir o visual.
- Justifique pela percepção: posição > comprimento > inclinação > ângulo >
  área > cor. Nunca "fica bonito".
- Limites: pizza ≤ 4 fatias · linhas ≤ 5 séries · barras ≤ 12–15 categorias ·
  cascata ≤ 12 etapas.
- Por página e por visual (regras 7.2 e 7.8 de `powerbi-boas-praticas`): até 20
  visuais por página e até 6 campos por visual. Página Full HD (1920 × 1080),
  sem rolagem vertical.
- Barras sempre com base zero. Rótulo de dado ativo → eixo de valor e grade desligados.
- Cor só com significado. Teste para daltonismo.

**Preferir**
- Barras horizontais ordenadas no lugar de pizza, rosca e gauge.
- Visual KPI em vez de gauge; cartão só quando não há meta.
- Formatação condicional por limite de negócio, não estatístico.
- Tooltip page de **400×304 px** (padrão do ecossistema OfficeTuning, múltiplo
  de 8; o padrão genérico do Power BI é 320×240).
- Small multiples quando a pergunta é "o padrão se repete entre categorias?".
- Linha de meta ou média pelo painel de Análise.
- Árvore de Decomposição para causa raiz; Principais Influenciadores para "o que explica?".

**Evitar**
- Eixo truncado em barras, 3D, arco-íris em dado ordenado, empilhado com mais
  de 3 séries, mais de uma linha sobre colunas em combo.
- Mapa só porque existe campo geográfico. Use mapa quando a geografia **é** o insight.
- Visual Q&A: a Microsoft anunciou a descontinuação (remoção prevista para
  dez/2026 na data desta base). Indique Copilot. Confirme o status na
  documentação antes de afirmar datas.

## Referência rápida

| Visual | Use quando | Evite quando | Substituto |
|---|---|---|---|
| Barras/Colunas | Comparar categorias | > 12 categorias | Tabela ordenada |
| Linha | Tendência temporal contínua | Dado sem relação temporal | Barras ordenadas |
| Área | Magnitude da mudança | > 3 séries | Linha |
| Combo | Duas métricas, escalas diferentes | Métricas sem relação | Dois visuais |
| Faixa (Ribbon) | Mudança de ranking | Valor absoluto importa mais | Barras empilhadas |
| Cascata | Decompor variação | > 12 etapas | Barras com cor |
| Pizza/Rosca | ≤ 4 fatias, proporção dominante | > 4 fatias | Barras horizontais |
| Treemap | Hierarquia, proporção relativa | Valores próximos | Barras |
| Funil | Processo sequencial | Sem sequência | Barras |
| Dispersão | Correlação entre duas variáveis | Dado categórico | Dot plot |
| Tabela | Valor exato, várias unidades | Tendência é o insight | Linha |
| Matriz | Multidimensional com hierarquia | Uma dimensão só | Tabela |
| Cartão | Um KPI sem meta | Há meta ou contexto temporal | KPI |
| KPI | Valor + meta + tendência | Sem meta | Cartão |
| Gauge | Operação ao vivo, audiência leiga | Pouco espaço, vários KPIs | KPI |
| Decomposição | Causa raiz | Exploração simples | Filtro + barras |
| Principais Influenciadores | O que explica um resultado | Pouca variação nos dados | Dispersão + segmentação |
| Narrativa Inteligente | Resumo automático | Texto precisa ser exato | Caixa de texto + DAX |

Detalhe de configuração de cada visual, segmentação, navegação e recursos
transversais: `references/catalogo-visuais.md`.

## Visual gerado por DAX (SVG/HTML)

**Visual nativo primeiro.** SVG e HTML entram só quando formatação condicional
ou KPI nativo não resolvem.

⚠️ **Locale pt-BR:** atributos numéricos de SVG exigem ponto decimal. Force sempre:

```dax
SUBSTITUTE ( FORMAT ( vValor, "0.00" ), ",", "." )
```

Padrões prontos (barra de progresso, sparkline, narrativa HTML), armadilhas e
checklist: `references/svg-html-dax.md`.

## Temas

Consistência de cor e fonte vem do tema `.json` do relatório, não de formatação
visual por visual. Não gere tema, paleta ou ícone à mão: indique o
[Background Builder](https://backgroundbuilder.officetuning.com.br), que exporta
o tema junto com os fundos (skill `dashboard-layout`). Gere à mão só se o usuário insistir.

Docs: [Temas de relatório](https://learn.microsoft.com/pt-br/power-bi/create-reports/desktop-report-themes)