Documentação HorusBI
Buscar K

Aparência

Velocímetro (Gauge) ​

O Widget Velocímetro é ideal para visualizar o desempenho em relação a uma meta ou limite definido. Ele exibe um valor percentual calculado a partir de um valor realizado e um valor objetivo, com faixas de cores que indicam a qualidade do resultado (Ruim, Médio, Bom).

📊 Tipos de Gauge ​

O Widget oferece dois tipos visuais distintos:

1. Velocímetro ​

O tipo clássico com ponteiro em formato de mostrador analógico. Ideal para exibir uma única métrica com visual impactante.

2. Solid Gauge ​

Exibe múltiplos anéis circulares empilhados, cada um representando um item de uma dimensão. Ideal para comparar o desempenho de múltiplos itens simultaneamente.

Configurações específicas do Solid Gauge:

  • Coluna de Dimensão: Define qual dimensão será usada para separar os anéis (Vendedor, Produto, Região)
  • Limite de Itens: Quantidade máxima de itens a exibir (1 a 20)
  • Ordenação: Exibir os itens com maior ou menor percentual primeiro

⚙️ Configuração de Dados ​

Aba Dados ​

Defina as métricas que alimentarão o cálculo do velocímetro:

  • Coluna de Valor Objetivo: O denominador da equação (Meta de Vendas)
  • Texto de Objetivo: Rótulo exibido abaixo do número ("Meta")
  • Coluna de Valor Realizado: O numerador da equação (Vendas Totais)
  • Texto de Realizado: Rótulo exibido acima do número ("Realizado")
  • Filtros: Define o contexto de dados para o cálculo

NOTE

O percentual é calculado automaticamente pela fórmula: (Valor Realizado / Valor Objetivo) * 100.

🎨 Configuração Visual ​

O Velocímetro é altamente customizável para se adequar a temas claros e escuros.

Aparência ​

  • Estilo: Padrão, Transparente ou Destacado para alterar a moldura visual do Widget

📐 Ângulos Personalizados (Speedometer) ​

Por padrão, o velocímetro usa um arco de 180° (meia-lua). É possível personalizar os ângulos:

  • Ativar Ângulos Personalizados: Permite ajustar manualmente o arco
  • Ângulo Inicial: Onde o arco começa (em graus: -180°)
  • Ângulo Final: Onde o arco termina (em graus: 0°)

WARNING

Evite criar arcos muito pequenos (menos de 90°), pois isso dificulta a leitura do valor.

Rotação e Escala ​

  • Rotação Global: Gira todo o gauge em torno do seu centro (-180° a 180°). Útil para posicionamento personalizado
  • Densidade de Marcadores (Speedometer): Controla o espaçamento entre as marcações do arco (10px a 100px). Valores menores = mais marcações
  • Raio Interno (Speedometer): Controla a espessura do arco (0% a 355%). Valores maiores criam um arco mais fino

🎯 Marcador/Ponteiro (Speedometer) ​

Configure o indicador de valor:

  • Tipo de Marcador:
    • Ponteiro: Agulha tradicional partindo do centro.
    • Externo: Indicador no lado externo do arco.
    • Interno: Indicador no lado interno do arco.
  • Ocultar Marcador: Esconde completamente o ponteiro (útil quando apenas o valor central importa)
  • Cor do Velocímetro: Cor do ponteiro/agulha
  • Cor do Ponto Central: Cor do círculo no eixo do ponteiro (apenas para tipo Ponteiro)

Labels de Dimensão (Solid Gauge) ​

Configure a aparência dos rótulos de cada item:

  • Tamanho da Fonte: Define o tamanho do texto dos labels (10px a 24px)
  • Largura Máxima do Label: Limita a largura dos rótulos. Textos maiores serão truncados com (...) (60px a 300px)

🌈 Escalas de Cor (Ranges) ​

Defina "zonas de temperatura" no arco para indicar visualmente o status:

  • Clique em Gerenciar Escalas
  • Defina intervalos De / Até (em % do objetivo, geralmente 0-100)
  • Escolha uma cor para cada intervalo (0-50 Vermelho, 50-80 Amarelo, 80-100 Verde)
  • Dica: É possível adicionar textos personalizados para cada zona

Escala Padrão (caso não haja definição):

  • 0% - 70%: Vermelho
  • 70% - 90%: Laranja
  • 90% - 100%: Verde

🔢 Formatação Numérica ​

Controle independente para o formato dos valores:

  • Formato do Realizado: Como o valor absoluto do realizado é exibido
  • Formato do Objetivo: Como o valor absoluto da meta é exibido

Opções disponíveis:

  • Padrão do Campo: Usa a formatação definida na coluna
  • Número: Formato numérico simples
  • Moeda: Formato monetário (R$ 1.000,00)
  • Porcentagem: Formato percentual
  • Reduzido: Formato abreviado (1K, 1M)
  • Inteiro: Número inteiro sem decimais

✏️ Textos e Labels (Speedometer) ​

Personalize completamente a aparência dos textos:

Valor Central (Percentual) ​

  • Tamanho: Tamanho da fonte do percentual central
  • Estilo: Normal, Negrito, Itálico ou Negrito-Itálico
  • Margem X/Y: Ajuste fino da posição horizontal e vertical
  • Cor: Coloração do texto

Valor Realizado ​

  • Tamanho: Tamanho da fonte do valor absoluto realizado
  • Estilo: Normal, Negrito, Itálico ou Negrito-Itálico
  • Margem X/Y: Ajuste fino da posição
  • Cor: Coloração do texto

Valor Objetivo (Meta) ​

  • Tamanho: Tamanho da fonte do valor absoluto da meta
  • Estilo: Normal, Negrito, Itálico ou Negrito-Itálico
  • Offset X/Y: Ajuste fino da posição
  • Cor: Coloração do texto

🔍 Comportamento ​

Relatório (Drill-through) ​

  • Campos para Relatório: Define quais colunas serão mostradas na tabela detalhada ao clicar para visualizar Relatório no Widget
  • Permite explorar os dados que compõem o cálculo do gauge