Matriz Composta, referência

Tipo

Referência

Para

Analista

Na tela

DataViz › Aplicação › Dashboards › Editando Widget › Matriz Composta

As opções da Matriz Composta ficam em seções na barra lateral do configurador, e as linhas numa tela à parte, aberta por Montar matriz. O passo a passo de um demonstrativo completo está em Montar um DRE. Nome do widget e menu seguem as opções comuns.

Tempo

Na tela	O que faz
Coluna do Calendário	A data da Tabela Calendário que gera as colunas. Obrigatória.
Agrupar por	Dia, Mês, Ano ou Semana. Não há trimestre.
Períodos exibidos	Quanto o filtro de data do Dashboard é expandido. Veja abaixo.
Quantos períodos	Com Últimos N períodos, o N.
Mínimo de colunas	Nos outros dois modos. Filtrar um mês só não deixa a matriz com uma coluna. Padrão 3.

Períodos exibidos	Colunas
Exatamente o período filtrado	O período do filtro, arredondado para períodos inteiros. Do dia 15 de um mês ao dia 10 do seguinte, mostra os dois meses completos.
Sempre anos completos	O ano inteiro de cada data filtrada. No ano corrente, vai até o período de hoje, ou além quando há valor lançado à frente, como orçamento.
Últimos N períodos	N períodos contados para trás a partir do fim do filtro.

O demonstrativo sempre segue o filtro de data do Dashboard; essas opções só mudam o quanto ele se expande. Uma linha não pode filtrar a mesma data que define as colunas: o widget avisa e pede para ajustar o período aqui.

Se uma linha precisa de outra data, como despesa por competência e financeiro por caixa, isso se resolve na modelagem da aplicação. Veja Modelo de dados.

Totalizadores e análises

Na tela	O que faz
Coluna de acumulado	Ligada por padrão, com o rótulo editável (padrão "Acumulado"). Uma consulta própria sobre o período inteiro, sem agrupar por período.
Análise vertical	Cada linha como percentual de uma linha base, escolhida na lista. Sai numa coluna no fim, sobre o acumulado. Uma coluna em cada período põe a AV% dentro de cada período, sobre a base daquele período.
Análise horizontal	A variação contra Contra o período anterior ou Contra o mesmo período do ano anterior, mostrada Numa sub-linha abaixo de cada linha ou Numa coluna dentro de cada período.

Por ser uma consulta própria, o acumulado de um ticket médio é a média do período, o de uma contagem distinta são os distintos do período, e o de uma conta é recalculado sobre os acumulados. Numa linha de percentual, a variação sai em pontos percentuais: uma margem de 10% para 12% aparece como +2,0 p.p..

Filtros padrão do widget

Valem para todas as linhas: restringir o demonstrativo a uma filial ou a um centro de custo, ou ler outro período que o do Dashboard. O filtro de cada linha se soma por cima. Veja Filtros.

Colunas dentro do período

Com duas ou mais colunas declaradas, cada período passa a ter várias: orçado e realizado, ou empresa A, empresa B, eliminações e consolidado. A primeira adição já cria duas, Realizado e Orçado; uma coluna sozinha é recusada, porque cada período já é uma.

A coluna é só um nome, sem filtro próprio. O que muda entre elas é o campo que cada linha de medida lê, escolhido em Campo de cada coluna.

Linhas

Montar matriz abre a lista de linhas à esquerda e, à direita, as opções da linha selecionada. Adicionar cria Grupo, Medida ou Conta.

Na tela	Em que linha	O que faz
Nome	Todas	O texto da linha.
No total do grupo acima	Todas	Soma, Subtrai ou Não entra no total do grupo que contém a linha. Quem subtrai mostra (−) antes do nome.
Formato	Todas	Do próprio campo (a máscara da modelagem), Número, Moeda, Percentual, Reduzido (mil, mi) ou Inteiro. Grupos e contas herdam o formato das linhas que resumem.
Campo, ou Campo de cada coluna	Medida	A medida que a linha lê.
Filtros desta linha	Medida	Filtros só desta linha, por cima dos filtros do widget.
Quebrar por	Medida	Abre a linha em filhas, uma por valor de uma dimensão. Com Máximo de itens (as maiores) e Agrupar o resto.
Como esta linha é calculada	Conta	As parcelas da conta. Veja abaixo.
Começar fechado	Grupo	O grupo abre fechado, qualquer que seja o padrão da matriz.
Aparência desta linha, Colunas especiais nesta linha, Formatação condicional	Todas	Veja Aparência e Formatação condicional.

O sinal de No total do grupo acima age só na soma do grupo. Contas, acumulado e análise vertical leem o valor da linha sem sinal. Um valor que vem negativo do banco se corrige no dado, e não no sinal.

Como esta linha é calculada: cada parcela é uma ficha com a operação (somar, subtrair, multiplicar, dividir) e a linha que entra, um número fixo ou um par de parênteses. Abaixo, a conta aparece por extenso com o nome das linhas. A conta só oferece linhas que estão acima dela, o que impede referência circular.

Quebrar por: as filhas saem dos valores da dimensão, então um centro de custo novo aparece sem ninguém editar o demonstrativo. Até três níveis. Mantenha Agrupar o resto ligado; sem ele, as filhas mostradas não somam o valor da linha mãe. Com várias colunas, quem define a lista de filhas é a primeira coluna.

Reordenar: arraste pela alça. Soltar no terço de cima ou de baixo de outra linha põe antes ou depois dela; no meio de um grupo, dentro dele; na área vazia abaixo, no fim. Um grupo leva tudo o que tem dentro. Ao passar o mouse, cada linha mostra Subir, Descer e Excluir, e o grupo, Adicionar dentro.

Aparência

A seção Aparência tem a galeria de modelos. Trocar de modelo não apaga os ajustes que você fez por cima.

Modelo	Como fica
Limpo	Sem grade, hierarquia pelo peso do texto. O padrão.
Contábil	Negativo entre parênteses, sem grade, traço acima dos subtotais.
Compacto	Grade completa, linhas alternadas, texto menor.
Executivo	Texto maior e faixa colorida nos grupos, para telão.
Zebrado	Linhas alternadas com grade horizontal.

Ajuste fino abre Aparência da matriz, com prévia ao lado e estas seções:

Seção	Opções
Modelo	A galeria, com a explicação de cada modelo.
Geral	Espaçamento (Apertado, Normal, Espaçoso), Grade (Nenhuma, Só entre linhas, Completa) com cor, Cabeçalho (Simples, Com traço, Com fundo), Recuo por nível, Tamanho do texto, Listrar linhas alternadas, Números negativos (Com sinal de menos ou Entre parênteses), Negativo em vermelho (desligado em todos os modelos), Cor de destaque e Ao abrir o dashboard (Tudo aberto, Só o primeiro nível aberto, Tudo fechado).
Ajuste fino	Largura da coluna de rótulos, fonte dos números (Monoespaçada alinha dígito a dígito), caixa, alinhamento, fundo, texto e traço do cabeçalho, e Esconder o cabeçalho.
Período corrente	Destacar o período em que estamos, com fundo e cor do texto da coluna.
Por espécie de linha	Ajustes para Todas as linhas, Grupos e seções, Medidas, Contas, Itens de quebra e Linha de variação, cada uma com voltar ao modelo. Uma medida quebrada por dimensão conta como Grupos e seções.
Regras da matriz	Formatação condicional para todas as células.
Colunas especiais	Aparência da coluna de acumulado, da AV% e da variação.

Aparência desta linha, na tela de montagem, vence a da espécie. Tem negrito, itálico, caixa alta, tamanho relativo, cor de texto e de fundo, e o traço contábil: traço acima fecha uma conta, traço duplo abaixo fecha o resultado. O ajuste fino da linha traz largura, estilo e cor do traço, respiro, sublinhado, riscado, alinhamento, um ícone fixo e uma segunda cor de fundo para degradê. Um ponto ao lado do controle indica valor declarado ali, e não herdado.

A precedência, do mais fraco para o mais forte: modelo, espécie de linha, a linha, regra condicional.

Formatação condicional

Existe em Regras da matriz (todas as células) e em Formatação condicional dentro de cada linha, que vence a da matriz. Cada regra tem duas metades:

Metade	Opções
Quando a célula	For negativa, For positiva, For zero, Não tiver valor, Comparar com um número (>, >=, <, <=, =, !=), Estiver numa faixa ou Regra em código.
Ela fica assim	Estilos prontos (Ruim, Bom, Atenção, Destaque, as versões com fundo, Apagado), negrito, itálico, sublinhado, riscado, um ícone antes ou depois do número e cores à mão.

As regras valem de cima para baixo, e as de baixo somam às de cima. As setas reordenam e Desligar desativa sem apagar. Só cor, fundo, marcas de texto e ícone se aplicam; tamanho, espaçamento e borda ficam de fora, para não desalinhar a tabela.

Regra em código

O teste Regra em código abre o editor. Diferente das outras regras em JavaScript, esta roda célula a célula sem await e sem this.datefns. O código devolve true para aplicar o efeito escolhido ao lado, ou devolve o próprio efeito como objeto. O painel O que o código recebe lista as variáveis:

Variável	O que é
this.value	O valor da célula, ou null quando não deu para calcular.
this.row	A linha: nome e espécie.
this.period	O período da coluna, e se ela é a do acumulado.
this.column	A coluna dentro do período, quando há mais de uma.
this.rowValues	Os valores da linha, na ordem dos períodos.

Marcar o melhor mês da linha:

const v = this.rowValues.filter(x => x !== null);
return this.value !== null && this.value === Math.max(...v);

Escala de cor contínua dentro da linha:

const v = this.rowValues.filter(x => x !== null);
if (this.value === null || !v.length) return false;
const min = Math.min(...v), max = Math.max(...v);
const t = max === min ? 0.5 : (this.value - min) / (max - min);
return { background: `hsl(${Math.round(120 * t)} 70% 92%)` };

O editor testa a regra em células do próprio demonstrativo enquanto você escreve. Uma regra que dá erro, ou que demora demais numa célula, se desliga, e o demonstrativo mostra um aviso com o nome da linha até ela ser corrigida.

Clicar num número

Clicar numa célula abre o menu de ações:

Ação	O que faz
Copiar Valor, Copiar valor sem formatação	O número como na tela, ou cru.
Ver relatório deste número	Só em linha de medida. Abre o relatório com o recorte exato da célula: campo da linha, período da coluna e filtros.
De onde vem este número	Em grupo e conta. Abre a decomposição: cada parcela com o operador pelo qual entrou, inclusive as que não entram, e o total no rodapé. Decompor desce numa parcela composta; numa medida, a parcela ganha Relatório.
Copiar linha, Copiar matriz	A linha ou o demonstrativo inteiro, com cabeçalho, para colar direto numa planilha.

Células de AV% e de variação não têm essas ações. O menu do widget tem Exportar para Excel, que leva o demonstrativo com a aparência.

Abrir e fechar grupos à mão sobrevive a trocar o filtro do Dashboard.

Carregamento e erros

Enquanto carrega, o widget mostra a porcentagem dos dados já buscados e só desenha quando tudo chegou. Editar nome, sinal, conta, cor ou análise vertical não consulta o banco de novo. Campo, filtro, período, colunas, quebra, a coluna de acumulado e a análise horizontal refazem as consultas.

Se a montagem tem erro, o widget não desenha e lista os ajustes, cada um com o nome da linha:

Mensagem	O que fazer
"Escolha a coluna do Calendário e como agrupar os períodos."	Preencha a seção Tempo.
"Escolha o campo que esta linha vai ler."	Escolha o Campo da medida.
"Este grupo está vazio, então soma zero."	Ponha linhas no grupo ou apague-o.
"Escreva a conta desta linha."	Monte Como esta linha é calculada.
"Quebrar por mais de três níveis gera linhas demais para ler."	Tire uma dimensão de Quebrar por.
"Escolha a linha base da análise vertical."	Escolha a base ou desligue a Análise vertical.

Um traço no lugar do número quer dizer que não deu para calcular, e não zero. O caso comum é uma margem num mês sem receita. Também aparece quando a linha depende de um campo que seu acesso não alcança; só ela e as que dependem dela ficam vazias.

Pelo Lumo CLI

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