Matriz Dinâmica

Tipo

Referência

Para

Analista

Na tela

DataViz › Aplicação › Dashboards › Editando Widget › Matriz Dinâmica

A Matriz Dinâmica agrupa as linhas em níveis que abrem e fecham (região, depois estado, depois cidade) e pode abrir uma coluna por valor de outra dimensão, como um mês por coluna. É a tabela dinâmica do Lumo: balancete, vendas por categoria, despesa por centro de custo.

As linhas da Matriz Dinâmica saem do dado: cada linha é um valor de dimensão. Por isso ela não calcula uma conta que não existe em coluna nenhuma, como Receita Líquida = Receita Bruta − Deduções. Para um demonstrativo com contas calculadas, use a Matriz Composta. Nome, aparência e filtros seguem as opções comuns.

Aba Dados

Na tela	O que faz
Tipo de Matriz	Níveis ou Hierárquico. Veja abaixo.
Níveis	Com Níveis: as dimensões das linhas, em ordem. A primeira é o nível de cima.
Campo Código, Campo Código Pai, Campo Rótulo	Com Hierárquico: o código da linha, o código da linha-mãe e o texto que aparece.
Coluna	Opcional. Uma dimensão que vira colunas, um valor por coluna (um mês, uma loja).
Valores	As medidas das células. A engrenagem de cada valor abre a configuração da coluna.
Filtros	Restringe só este widget. Veja Filtros.
Ordenação	Colunas que ordenam as linhas.

Tipo	Como monta as linhas	Quando usar
Níveis	Cada dimensão é um nível. Abrir uma região mostra os estados dela.	Análise comercial: região › estado › cidade, categoria › produto.
Hierárquico	A árvore vem do próprio dado, pelo código e pelo código pai de cada linha, numa consulta só.	Plano de contas, centro de custo, organograma: estruturas que já têm Código e Código Pai na tabela.

Aba Visual

Na tela	O que faz
Aparência	Padrão, Transparente ou Destacado. Veja Aparência.
Total níveis abertos (Hierarquia/Níveis)	Quantos níveis já chegam abertos, de 1 a 9. Nenhum abre tudo fechado.
Mostrar Totalizador Geral	Linha de total no rodapé.
Mostrar Totalizador Lateral	Coluna de total à direita. Só com Coluna preenchida.
Linhas Zebradas	Alterna a cor de fundo das linhas.
Mostrar itens sem valores	Mostra também as linhas sem valor.
Limitar registros por nível	Com Máximo de registros por nível (padrão 50), mostra só as primeiras N linhas de cada nível, depois da ordenação. Útil quando uma categoria tem milhares de produtos.
Espaçamento das Células, Tamanho do Texto	Pequeno, Médio ou Grande.
Alinhamento Padrão Cabeçalho, Alinhamento Padrão Conteúdo	Alinhamento da matriz inteira: Padrão (número à direita, texto à esquerda), Esquerda, Centro ou Direita.
Estouro da Coluna Primária	O que fazer com rótulo longo na primeira coluna: Quebrar Texto (corta com reticências) ou Quebra de Linha.
Campos para Relatório	Colunas extras do relatório do widget. Veja Campos para Relatório.
Cores	Customizar Cores troca as cores do tema: cabeçalho, conteúdo, rodapé, linha zebrada e subtotal, texto e fundo de cada.
Bordas das Células	Estilo (Nenhuma, Horizontal Apenas, Vertical Apenas, Todas) e Espessura (Fina (1px), Média (2px), Grossa (3px)). A Cor só aparece com Customizar Cores.
Delimitadores de Coluna	Linhas mais fortes entre grupos de colunas, com Espessura e Estilo (Sólida, Tracejada ou Pontilhada); a cor, com Customizar Cores. Ajudam quando cada mês tem mais de uma medida.

Aba Comportamento

A seção Análises acrescenta colunas calculadas na tela, sem mudar os valores originais.

Na tela	O que faz
Análise Vertical (%)	Uma coluna com o percentual de cada linha sobre uma referência. Sem configurar, a referência é o total da coluna. Configurar abre a escolha de uma linha como 100%.
Análise Horizontal (%)	Uma coluna com a variação de cada período para o anterior, entre colunas vizinhas, a partir da segunda coluna.
Usar setas na Análise Horizontal (ao invés de %)	Troca o número por ▲ e ▼.
Inverter cores da Análise Vertical., Inverter cores da Análise Horizontal.	Sem inverter, a alta fica verde e a queda vermelha. Invertido, para custo e despesa, em que subir é ruim, a alta fica vermelha e a queda verde.
Valores neutros das análises em cinza	A variação zero fica cinza, em vez de amarela.

Num DRE em que a linha Receita Bruta é a referência da Análise Vertical (%), cada despesa mostra quanto ela pesa sobre a receita, e não sobre a soma da coluna.

Aba Subtotais

Um subtotal é uma linha a mais, com nome livre, cujo valor vem de uma consulta própria: os filtros do widget mais os filtros do subtotal.

Na tela	O que faz
+ Adicionar Subtotal	Cria um subtotal.
Nome do Subtotal	O rótulo da linha, como "Receitas Totais".
Filtros	Quais linhas do dado entram na soma deste subtotal.
Posicionamento	Antes ou Depois da linha de referência. Com Depois, se a linha de referência tem filhos, o subtotal entra depois de todos eles.
Prefixos para Antes / Prefixos para Depois	Prefixos separados por vírgula, como 1.1, 2.0. O subtotal vai junto da primeira linha cujo rótulo começa com um deles. Se nenhum prefixo casa, o subtotal vai para o fim da matriz.

Subtotal sem nome, sem filtro, sem posicionamento ou sem prefixo não aparece. O subtotal soma linhas por filtro e para aí: não subtrai uma linha de outra nem divide. Uma Receita Líquida só sai como subtotal se couber num filtro, por exemplo somar todas as contas que começam com 3 quando as deduções já estão negativas no dado. Receita Bruta − Deduções, EBITDA e margem como conta são da Matriz Composta.

Configuração da coluna

A engrenagem de cada item de Valores abre a mesma configuração de coluna da Tabela, no formato antigo: Ocultar Campo, Rótulo Customizado, Tooltip, Alinhamento Customizado, Estilo de Coloração (Indicador ou Cédula) com Tipo de Coloração (Por Escala, Por Valor, Por Expressão) e Formatação do Número (Por Lista, com o Formato do Número).

Na cor Por Expressão, a regra em JavaScript recebe this.value (o valor da célula) e this.row (os valores da linha), além de this.datefns:

if (this.value < 0) return "#ef4444"; // vermelho para negativo
return "";                            // sem cor

Exemplo

Despesa por centro de custo, mês a mês, com o peso de cada uma sobre o total:

1. Tipo de Matriz = Hierárquico, com Campo Código = CentroCusto.Codigo, Campo Código Pai = CentroCusto.CodigoPai e Campo Rótulo = CentroCusto.Nome.
2. Coluna = mês de Lancamentos.Data; Valores = Lancamentos.Valor (soma).
3. Em Comportamento, ligue Análise Vertical (%) e Análise Horizontal (%). Marque Inverter cores da Análise Horizontal., que só aparece com a horizontal ligada, já que despesa subindo é ruim.

Limites

• A Matriz Dinâmica não faz conta entre linhas. Use a Matriz Composta.
• A configuração da coluna mostra opções que a Matriz Dinâmica não usa: Lógica do Totalizador, Por Expressão em Formatação do Número (a célula sai com a máscara do campo), Posição do ícone e o ícone das faixas, e Aplicar formatação condicional no totalizador.
• Porcentagem em Por Lista multiplica por 100 duas vezes neste widget. Veja o aviso em Formato do Número.
• Ao exportar o widget em imagem ou PDF, a matriz sai com no máximo 100 linhas abertas. Um grupo que não cabe inteiro fica de fora, em vez de sair pela metade.
• Exportar para Planilha, no menu do widget, baixa um .xlsx com as linhas como estão abertas na tela, com os números como número.

Pelo Lumo CLI

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