Velocímetro

Tipo

Referência

Para

Analista

Na tela

DataViz › Aplicação › Dashboards › Editando Widget › Velocímetro

Num Velocímetro, o realizado é medido contra um objetivo: o ponteiro anda num arco de zero até o objetivo, e as faixas de cor dizem se o valor está bom ou ruim. Rende mais quando a meta tem teto claro, como vendas do mês contra a meta ou ocupação contra a capacidade.

Para um número sem teto, use o KPI. O que vale para todo widget (nome, aparência, filtros, Campos para Relatório) está em opções comuns.

Tipos

O campo Tipo de Gráfico, no topo da aba Dados, tem dois ícones que trocam o desenho. O nome de cada um aparece ao passar o mouse.

Tipo	Mostra	Quando usar
Velocímetro	Um arco com ponteiro. Com Repetir por dimensão, vira uma grade de arcos, um por item.	Uma meta, ou a mesma meta para cada loja, região ou vendedor.
Gauge Sólido	Anéis concêntricos, um por item de uma dimensão, preenchidos até o percentual de cada um.	Comparar o atingimento de poucos itens num desenho só.

Aba Dados

Na tela	O que faz
Realizado (valor principal)	A medida que move o ponteiro. Obrigatório.
Máscara do valor	O formato do realizado: Reduzido (1,2 mi) (padrão), Padrão do campo, Inteiro, Moeda, Percentual. Substitui o Formato do Número neste widget.
Objetivo (máximo da escala)	O fim do arco. Campo lê de uma coluna; Número usa um valor fixo. O ponteiro fica em realizado ÷ objetivo. Vazio, zero ou negativo, o arco vai de 0 a 100.
Marcador de meta	Só no tipo Velocímetro. Desligado por padrão. Ligado, abre Meta (linha), outra referência (campo ou número) desenhada como um traço no arco.
Filtros	Restringe só este widget. Veja Filtros.

Repetir por dimensão

Seção da aba Dados, só no tipo Velocímetro. Com uma dimensão escolhida, o widget desenha um card por valor dela.

Na tela	O que faz
Dimensão (repetir cards)	A coluna que gera os cards, como Loja. Vazia, volta ao arco único.
Largura mínima do card (px)	O widget encaixa quantos cards couberem por linha. Os outros quebram para baixo, com rolagem. Padrão 180, mínimo 80.
Limite de cards	Quantos cards no máximo, de 1 a 24, contados depois da ordenação. Padrão 12.
Ordenar por	Uma ou mais colunas, cada uma crescente ou decrescente. Pode ser uma coluna que não aparece no widget.
Aparência do card	Fundo do card; Título (o valor da dimensão) com Cor do título, Fundo do título, Tamanho, Alinhamento, Negrito e Quebrar linha (desligado, o nome longo é cortado com reticências); e Legenda em card, que põe a legenda das faixas dentro de um cartão. A grade tem uma legenda só para todos os cards.

Com o objetivo em Número, todos os cards usam a mesma escala e dá para comparar um com o outro de olho. Com o objetivo em Campo, cada card usa o próprio objetivo, e as faixas se ajustam a ele.

Se a coluna de ordenação é mais detalhada que a dimensão (ordenar por dia quando a dimensão é o mês), os cards podem repetir. A tela mostra esse aviso sempre que Ordenar por tem uma coluna diferente da dimensão.

Só no Gauge Sólido

Na tela	O que faz
Coluna de Dimensão	A dimensão que vira anéis. Obrigatória: sem ela o widget mostra "Gauge Sólido requer uma coluna de dimensão. Configure o widget." A engrenagem ao lado da coluna abre a cor dos anéis (veja abaixo).
Limite de Itens	De 1 a 20 anéis, os de maior ou menor percentual conforme a Ordenação. Padrão 5.
Ordenação	Maior % primeiro ou Menor % primeiro.

Aba Visual

Na tela	O que faz
Estilo	Galeria de pontos de partida: Clássico, Fino, Arco 270°, Progresso, Original. Velocímetros criados antes da galeria abrem em Original.
Tipo do Marcador	Gota, Ponteiro, Interno, Externo ou Sem ponteiro, com Cor do Marcador, Cor do Ponto Central (só no Ponteiro) e Recorte do ponteiro, uma borda na cor do fundo que destaca o ponteiro sobre o arco, ligada por padrão.
Coloração	Faixas (cada trecho do arco na cor da faixa), Gradiente, Barra (cor fixa), com a Cor da barra, ou Barra (cor da faixa), em que a barra preenchida toma a cor da faixa onde o valor está.
Gerenciar Faixas	As zonas de cor do arco. Cada faixa tem Nome, De, Até (de 0 a 100, em percentual do objetivo) e Cor de Fundo. A barra no topo da janela mostra as faixas: arraste um divisor para mudar o limite entre duas. Adicionar faixa divide a faixa mais larga ao meio.
Estilo do marcador	Para o marcador de meta: Linha, Tracejado ou Triângulo, com cor e Texto do marcador.
Legenda (áreas nomeadas)	Nenhuma, Topo ou Abaixo. Lista as faixas com nome.
Layout de texto	Onde aparece cada texto: Valor, Realizado/Meta, Status (o nome da faixa atual) e Meta (rótulo), este só no estilo Original. Cada um vai em Oculto, Topo, Centro ou Baixo. Os atalhos Limpo, KPI e Completo preenchem as posições de uma vez. Padrão: Valor no Topo, Realizado/Meta em Baixo quando há objetivo, o resto Oculto. Realizado/Meta e Meta (rótulo) só se ativam com objetivo.
Tratamento (centro/topo)	Contorno ou Pill (caixinha com cor, borda, Arredondamento e transparência) atrás do texto do centro.
Aparência	Padrão, Transparente ou Destacado. Veja Aparência.
Ângulos	Customizar Ângulos Manualmente, com Ângulo Inicial e Ângulo Final do arco, de 10 em 10 graus. Arco curto demais ganha o aviso "Intervalo muito curto pode afetar a leitura."
Rotação e Escala	Rotação Global; Escala (números): Sem números, Só início e fim ou Graduada; Máscara dos ticks; Densidade dos Ticks (distância mínima entre marcações, de 10 a 100; menor, mais marcações); Raio Interno (Inner Radius), que define a espessura do arco (menor, mais espesso).
Textos e Labels	Tamanho (Pequeno, Médio, Grande), cor, negrito e itálico de Valor central, Percentual, Status e Ticks. O Status não tem cor própria: usa a da faixa.

Sem faixas configuradas, o arco usa três: Crítico de 0 a 60, Atenção de 60 a 85 e Ótimo de 85 a 100. O Status só aparece quando a faixa tem nome.

No Gauge Sólido, a aba Visual tem só Aparência e Labels das Dimensões: Tamanho da Fonte (10 a 24) e Largura Máxima do Label (60 a 300; o texto maior é cortado com "..."). A cor de cada anel fica na engrenagem da Coluna de Dimensão, na aba Dados: Cores Automáticas (a paleta padrão), Cor por Valor (uma cor por item, com Carregar Valores da Aplicação) ou Cor por Expressão. Na expressão, a regra em JavaScript recebe this.label (o item), this.value (o realizado), this.target (o objetivo), this.percent (fração: 0,73 para 73%) e this.index (a posição do anel), além de this.datefns.

Aba Comportamento

Campos para Relatório, na seção Drill Down: colunas extras do relatório do widget. Veja Campos para Relatório.

Exemplo

Meta de vendas por loja, numa grade de velocímetros:

1. Tipo de Gráfico = Velocímetro. Realizado = Vendas.Valor (soma), Máscara do valor = Moeda.
2. Objetivo = Campo Metas.Valor, para cada loja usar a própria meta.
3. Em Repetir por dimensão, Dimensão = Lojas.Nome, Largura mínima do card = 180, Ordenar por Vendas.Valor decrescente.
4. Em Gerenciar Faixas: Abaixo de 0 a 70, Perto de 70 a 100.

A Loja Centro, com R$ 84.000 vendidos e meta de R$ 120.000, aparece com o ponteiro em 70%, no começo da faixa Perto.

Limites

• Percentual na Máscara do valor multiplica uma vez: o realizado 0,73 aparece como 73,00%.
• Acima do objetivo, o ponteiro para no fim do arco; o texto Realizado/Meta continua mostrando o percentual real, como 120,0%.
• O Gauge Sólido mostra no máximo 20 anéis. Ele lê até 500 itens da dimensão e só então ordena por percentual: numa dimensão maior que isso, o maior percentual pode ficar de fora.
• Repetir por dimensão não existe no Gauge Sólido.

Pelo Lumo CLI

Este widget também pode ser criado e versionado em YAML, com type: Gauge. Veja a referência de app.