Matriz (Pivot Table)

O Widget Matriz é a ferramenta mais poderosa para análise tabular no Horus DataViz. Diferente de uma tabela simples, a Matriz permite agrupar dados em níveis hierárquicos (Drill-Down), transpor colunas (Pivot) e realizar análises financeiras avançadas (Vertical e Horizontal) nativamente.

É o componente ideal para Balancetes, Análises de Vendas por Categoria e qualquer cenário que exija exploração profunda de dados agrupados.

TIP

Demonstrativo com linhas calculadas é outro Widget. Na Matriz as linhas saem do dado: são os valores de uma dimensão. Por isso ela não expressa "Receita Líquida", que não existe como valor de coluna nenhuma — é Receita Bruta menos Deduções.

Se o seu demonstrativo tem contas calculadas (Receita Líquida, EBITDA, margens) ou mistura fatos que não se relacionam entre si, use a Matriz Composta.

Se for um balancete puro sobre um plano de contas que já tem Código e Código Pai, fique aqui: o modo Hierárquico resolve em uma consulta, e é muito mais barato.

🏗️ Modos de Estrutura

A Matriz opera em dois modos distintos de estruturação de linhas:

1. Por Níveis (Drill-down)

É o modo clássico de Pivot Table. Define-se uma ordem de Dimensões (País > Estado > Cidade).

• Comportamento: O usuário clica em País para expandir e visualizar os Estados, e assim por diante

TIP

Ideal para análises comerciais, geográficas ou de produtos.

2. Hierárquico (Pai/Filho)

Muitas estruturas de dados (como planos de contas contábeis ou organogramas) são armazenadas no formato "Auto-relacionamento" (ID e ID Pai). A Matriz entende essa estrutura nativamente.

• Configuração:
  • Campo Código: O ID único da linha (ContaContabilID)
  • Campo Código Pai: O ID que aponta para o nível superior (ContaPaiID)
  • Campo Rótulo: O nome a ser exibido (Nome da Conta)

TIP

Ideal para Balancetes, Balanços e Organogramas — estruturas em que a árvore inteira já existe no dado. Quando o demonstrativo precisa de contas que o plano não tem, veja a Matriz Composta.

---

🔀 Configuração de Colunas (Pivot)

Além das linhas hierárquicas, é possível adicionar uma Dimensão de Coluna para "pivotar" os dados.

• Campo de Coluna: Selecione uma dimensão (Meses, Ano, Lojas) para que cada valor único dessa dimensão se torne uma coluna na matriz
• Total Lateral: Quando uma coluna é definida, o sistema pode calcular automaticamente uma coluna extra de "Total" que soma horizontalmente os valores da linha

---

💰 Análises Financeiras (DRE)

A Matriz possui um motor de cálculo embutido para análises financeiras comuns, dispensando a necessidade de criar medidas complexas no banco de dados.

1. Análise Vertical (AV%)

Calcula a representatividade de uma linha em relação a um total.

• Padrão: Calcula a % da linha em relação ao Total da Coluna
• Referência Avançada: Permite configurar uma linha específica da hierarquia em 100% como métrica para cálculos diversos
  • Exemplo: Em um DRE, é possível configurar a "Receita Bruta" como dado de referência. Assim, todas as despesas mostrarão quantos % representam da Receita Bruta, e não do total geral
  • Acesso: Clique no botão de engrenagem na aba Comportamento para abrir o menu de seleção de referência

2. Análise Horizontal (AH%)

Calcula a variação (crescimento ou queda) entre colunas adjacentes, sendo ideal para comparar a evolução temporal (Fev vs Jan) ou (2024 vs 2023).

• Visualização: Pode ser exibida como percentual (+15.5%) ou através de setas indicativas (▲/▼) para uma leitura mais limpa e compacta

TIP

Cores Inteligentes: As análises podem ter suas cores invertidas.

• Para receitas, crescimento (cor verde) é bom.
• Para despesas/custos, crescimento (cor vermelha) pode ser ruim. Use a opção Inverter Cores na aba Comportamento conforme a natureza do dado.

---

🎨 Customização Visual

A Matriz oferece extenso controle sobre a aparência para personalização de relatórios densos ou Dashboards executivos.

Aparência Geral

• Estilo:
  • Padrão: Visual clássico com fundo branco/escuro
  • Transparente: Remove fundos e bordas externas
  • Destacado: Adiciona sombras e bordas para ênfase
• Linhas Zebradas: Alterna a cor de fundo das linhas para facilitar a leitura em tabelas longas
• Espaçamento (Padding): Controla a densidade da informação
  • Pequeno: Máxima densidade de dados (estilo Excel)
  • Grande: Mais respiro, ideal para apresentações
• Tamanho do Texto: Ajuste global da fonte (Pequeno, Médio, Grande)

Totais e Subtotais

• Mostrar Totalizador Geral: Exibe a linha de rodapé com a soma total dos valores das colunas
• Mostrar Totalizador Lateral: (Apenas quando há Dimensão de Coluna) Exibe a última coluna com a soma da linha
• Níveis Abertos: Define quantos níveis da hierarquia já vêm expandidos por padrão ao carregar o Widget

Alinhamento e Layout

• Alinhamento de Cabeçalho/Conteúdo: Controle independente (Esquerda, Centro, Direita) para títulos e dados
• Quebra de Texto: Controla se textos longos na primeira coluna serão cortados (...) ou terão quebras de linhas (Wrap)
• Bordas de Célula: Configuração fina de bordas (Horizontais, Verticais ou Todas), incluindo espessura e cor
• Delimitadores de Coluna: Adiciona linhas verticais mais espessas para separar grupos de colunas, sendo útil quando existem muitas métricas por mês

Cores Customizadas

Habilitando a opção "Customizar Cores", é possível sobrescrever a paleta do tema:

• Cabeçalho, Corpo e Rodapé (Texto e Fundo)
• Linhas Zebradas
• Subtotais (Linhas de nível hierárquico)

---

📝 Formatação de Células (Dados)

Cada métrica (coluna de valor) pode ser customizada individualmente clicando na engrenagem ao lado do campo na aba Dados.

Cores Condicionais

É possível colorir o fundo, o texto ou adicionar um indicador (bolinha) na célula:

1. Por Escala: Define faixas de valores (0 a 50 = Vermelho, 50 a 100 = Verde)
2. Por Valor: Define cores para valores exatos de texto ("Lucro" = Verde, "Prejuízo" = Vermelho)
3. Por Expressão (JavaScript): Lógica total

   // Exemplo: Pintar de vermelho se for negativo
   if (this.value < 0) {
       return '#ef4444'; 
   }
   return ''; // Sem cor

Formatação Numérica

Além dos formatos padrões (Moeda, %...), é possível forçar formatações específicas para uma coluna se ela divergir do padrão do banco de dados (exibir como Inteiro ou Reduzido 1k).

Lógica do Totalizador

Por padrão, os totais dos nós pais são a soma dos filhos. Porém, é possível alterar esse comportamento se a métrica exigir:

• Média: O pai será a média dos filhos
• Máximo/Mínimo: O pai mostrará o maior/menor valor encontrado nos filhos
• Expressão: Mantém o cálculo original proveniente do banco (útil para métricas não-aditivas, como Margem %, que não podem ser somadas)

---

➕ Subtotalizadores (Linhas Calculadas)

A Matriz permite a criação de linhas de subtotal "artificiais" que são injetadas na tabela em posições específicas. Diferente dos totais nativos (que somam os filhos), esses subtotalizadores são calculados com base em filtros customizados.

Isso é essencial para DREs e relatórios contábeis onde certas linhas são somas de outras contas que não necessariamente compartilham o mesmo pai hierárquico ("EBITDA" ou "Margem de Contribuição").

Configuração

Acesse a aba Subtotais no configurador:

• Nome: Rótulo que aparecerá na linha ("Receita Líquida")
• Filtros: Defina quais dados devem ser somados nesta linha

NOTE

Os filtros do subtotal são somados aos filtros globais do Widget.

• Posicionamento:
  • Tipo: Se a linha deve aparecer "Antes" ou "Depois" de um nó de referência
  • Prefixos: Uma lista de textos (separados por vírgula) para encontrar onde inserir a linha. O sistema buscará a primeira linha visível cujo rótulo comece com um desses prefixos
  • Comportamento "Depois": Se o nó de referência tiver filhos (drill-down), o subtotal será inserido após todos os filhos e netos, respeitando a hierarquia visual.

---

⚡ Performance e Limites

Para garantir performance, mesmo com milhões de linhas, a Matriz utiliza Virtual Scrolling (Renderização Virtual).

• Renderização Inteligente: O componente desenha na tela apenas as linhas que estão visíveis. É possível ter uma árvore com 10.000 linhas abertas, e o navegador continuará leve
• Limitação por Nível: Se um nível tiver um número elevado de filhos (50.000 produtos dentro de uma categoria), é possível usar a opção Limitar registros por nível na aba Visual para carregar apenas os "Top N" (os 50 primeiros), evitando sobrecarga de rede e do navegador
• Ocultar sem valores: Opção para esconder automaticamente linhas que estejam zeradas ou nulas, resultando em uma visualização mais limpa