Tema
Indicadores (KPI)
O widget KPI mostra um ou mais números em destaque. É o primeiro widget de quase todos os dashboards, e o mais fácil de usar mal.
Um widget, vários indicadores
Um KPI não é um número — é uma faixa de indicadores lado a lado. Quatro números numa linha fazem-se com um widget KPI de quatro indicadores, não com quatro widgets.
A vantagem é prática: alinhamento e espaçamento ficam garantidos, e a faixa acompanha a largura sozinha.
Cada indicador tem
| Propriedade | O que faz |
|---|---|
| Rótulo | O texto por cima do número |
| Ícone | Um símbolo à esquerda |
| Cor | A cor do ícone |
| Prefixo e sufixo | Texto colado ao número (€, %, un.) |
| Casas decimais | Quantas mostrar |
| Compacto | 1,2 M em vez de 1 234 567 |
| Separador de milhares | Ligado ou desligado |
| Conjunto de dados e campo | De onde vem o valor |
| Valor fixo | Um número escrito à mão, quando não vem de dados |
| Período | A etiqueta do fecho a que o número diz respeito |
| Tendências | Uma ou mais comparações, por baixo do número |
| Tamanho | Escala o cartão inteiro — ver Estilos e tema |
De onde vem o valor
Um indicador lê a primeira linha do conjunto de dados indicado, na coluna indicada.
Isto significa que a consulta que alimenta um KPI deve devolver uma linha só — uma consulta apenas com medidas, sem dimensões nenhumas:
| Coluna | Origem |
|---|---|
vendas | SUM(valor) |
encomendas | COUNT(numero) |
ticketMedio | AVG(valor) |
margem | medida calculada (Receita - Custo) / Receita * 100 |
Um KPI ligado a uma consulta com dimensões mostra o valor da primeira linha — que é o primeiro grupo, não o total. É a causa mais comum de "o número está errado".
Vários conjuntos no mesmo KPI
Os indicadores de um KPI podem ler de conjuntos diferentes. Se um número precisa de uma consulta com condições próprias — o mês anterior, por exemplo —, crie um segundo conjunto no mesmo widget em vez de outro widget.
O período
Um cartão financeiro tem de dizer de que fecho fala: o mesmo valor pode ser de meses diferentes, e um número sem período é uma afirmação sem data.
A etiqueta (12/2026) lê-se preferencialmente dos dados — indica-se o conjunto e o campo, tipicamente a data da linha que deu o valor. Uma data ISO é mostrada como MM/AAAA.
Há também um campo de texto fixo, mas é um recurso para quando a consulta não devolve nenhuma data.
Um período escrito à mão mente em silêncio
12/2026 escrito no cartão continua a dizer 12/2026 no dia em que entrarem dados de Janeiro. Não dá erro, não muda de cor: mostra o número novo com a data velha.
O par natural disto é a condição só o período mais recente na consulta — ver Filtros da consulta. Uma consulta fixada no período mais recente devolve esse período, e o cartão passa a dizer sozinho de que fecho fala.
Tendências
Um indicador pode mostrar tendências por baixo do número: uma variação com sinal, cor e um rótulo de comparação (vs 11/2026). Podem ser várias no mesmo indicador — face ao mês anterior e face ao início do ano, por exemplo.
O valor da tendência lê-se de um conjunto e de um campo, tal como o número principal. A forma normal de o obter é uma coluna de variação face ao período anterior na mesma consulta.
Subir nem sempre é bom. A opção de inverter marca os casos em que crescer é mau — dívida, custos, prazo médio de recebimento. Com ela, um aumento aparece a vermelho com a seta para cima, que é a leitura certa.
Não use ícones de seta como indicador de direcção
Um ícone trending-up escolhido à mão afirma que o valor está a subir — e continua a afirmá-lo no mês em que ele cai. É mentir sem dar erro.
A direcção pertence à tendência, que vem dos dados e sabe inverter-se. O inspector avisa quando um indicador usa um ícone direccional.
Dois guardas ao gravar
O produto recusa gravar um indicador cujo valor, período ou tendência aponte para um campo que a consulta não devolve.
A razão é a forma como estas falhas se manifestam: um campo inexistente não dá erro nenhum — o cartão fica apenas sem seta, ou sem período, e ninguém repara durante meses. O mesmo guarda cobre as barras de progresso vs limite.
Se a gravação for recusada, a mensagem diz que campo falta. Normalmente é um nome de saída que mudou na consulta e não foi acompanhado no cartão.
Formatação
Três decisões mudam muito a legibilidade:
Compacto para valores grandes. 2,58 M lê-se de relance; 2 584 253 obriga a contar dígitos. Para valores acima de cem mil, use compacto.
Casas decimais conforme a grandeza. Um total em euros não precisa de decimais. Uma percentagem de margem precisa de uma. Um rácio precisa de duas.
Sufixos curtos. EUR ou €, %, un.. O rótulo já diz o que é.
Ver Formatos de valor.
Quantos indicadores
Quatro numa faixa de 48 colunas é confortável. Cinco cabem. Seis obrigam a encolher o número, que é justamente o que se queria destacar.
Se tem oito números para mostrar, tem provavelmente dois assuntos — e dois dashboards, ou duas faixas separadas por um título.
No telemóvel, quatro indicadores lado a lado não cabem. Ver Web, tablet e telemóvel.
Progresso vs limite
Um widget próprio, para o caso em que o número só tem significado comparado com outro: realizado contra meta, consumo contra limite contratado.
Tem valor, limite, unidade, casas decimais, e uma lista de limiares com a cor de cada faixa. A opção de "acima é bom" inverte a leitura das cores — num consumo, ultrapassar é mau; numa meta de vendas, é bom.
Vale para ele o mesmo guarda dos indicadores: um valor que aponte para um campo que a consulta não devolve impede a gravação, em vez de deixar a barra vazia com um traço no lugar do número.