Tabela

Tipo

Referência

Para

Analista

Na tela

DataViz › Aplicação › Dashboards › Editando Widget › Tabela

A Tabela lista linhas com as colunas que você escolher, como os pedidos do dia ou os clientes com título vencido. Cada coluna pode ter formato, cor por regra e total no rodapé.

Para cruzar duas dimensões (produto nas linhas, mês nas colunas), use a Matriz Dinâmica. Nome, aparência e filtros seguem as opções comuns.

Aba Dados

Dados Primários

Na tela	O que faz
Campos	As colunas da tabela, na ordem. O ícone de engrenagem do campo abre a configuração da coluna.
Filtros	Restringe só esta tabela. Veja Filtros.
Ordenação	Colunas que ordenam as linhas, cada uma crescente ou decrescente.

Visões Alternativas

Uma visão alternativa é outra tabela dentro do mesmo widget, com campos, filtros e ordenação próprios. Quem vê o Dashboard troca de visão num seletor no widget.

Na tela	O que faz
Habilitar Visões Alternativas	Liga o recurso. Nome da Visão Principal nomeia a visão de sempre.
+ Adicionar Visão	Cria uma visão que começa com os campos, filtros e ordenação da principal. Cada visão tem Nome da Visão, Campos, Filtros, Ordenação, Limite de Linhas (Top), Definir Largura das Colunas Manualmente e Mostrar itens sem valores próprios. Remover Visão apaga.
Disparar por filtro	Com uma Coluna escolhida, a visão abre sozinha quando o Dashboard recebe um filtro nessa coluna, e volta à principal quando o filtro sai.

Com Disparar por filtro, uma tabela "Vendas por estado" pode virar "Vendas por cidade" assim que alguém clica em SP num mapa do mesmo Dashboard.

Aparência, totalizador, zebra, contador, congelamento e a Formatação avançada de linha vêm da visão principal e valem para todas as visões.

Aba Comportamento

Na tela	O que faz
Limite de Linhas (Top)	Quantas linhas no máximo na visão principal (cada visão alternativa tem o seu). 0 = sem limite. Com a ordenação certa, vira um "10 maiores".

Aba Visual

Na tela	O que faz
Campos para Relatório	Colunas extras do relatório do widget. Veja Campos para Relatório.
Modelo de estilo	Galeria: Padrão (a tabela como sempre foi), Compacto (fonte 12 px, células justas), Contábil (número monoespaçado, tudo à direita) e Painel (fonte 20 px, para telão). Ajuste fino abre as abas Tabela, Cabeçalho, Conteúdo e Rodapé (tamanho, fonte, cores, degradê; em Conteúdo, com Linhas Zebradas ligada, também a Linha alternada) e Bordas, com as bordas internas (Nenhuma, Horizontal Apenas, Vertical Apenas, Todas; Fina (1px), Média (2px), Grossa (3px); cor).
Aparência	Padrão, Transparente ou Destacado. Veja Aparência.
Mostrar Totalizador	Liga a linha de total no rodapé. Manter totalizador junto aos dados cola o total logo abaixo da última linha, em vez do pé do widget.
Linhas Zebradas	Alterna a cor de fundo das linhas.
Mostrar Contador de Linhas	Põe uma coluna # à esquerda. A numeração é da posição na tela: reordenar não leva o número junto.
Congelar colunas	Fixa as primeiras colunas à esquerda durante a rolagem horizontal. A quantidade vai de 1 ao total de colunas menos 1.
Espaçamento das Células	Pequeno, Médio ou Grande.
Tamanho do Texto	Pequeno, Médio ou Grande. Só nas tabelas que ainda não passaram ao formato atual; no formato atual, o tamanho fica no Ajuste fino.
Comportamento do Texto Excedente	Automático, Quebrar Linha ou Mostrar Reticências (...). Quebrar Linha Cabeçalho quebra os títulos longos.
Modo de largura	Proporcional (%): as colunas dividem a largura do widget. Pixels: cada coluna tem largura fixa, e o que passar vira rolagem horizontal. Com o Dashboard em edição, arraste as divisas do cabeçalho para ajustar; duplo clique ajusta ao conteúdo. Restaurar larguras automáticas desfaz.
Mostrar itens sem valores	Na seção Avançado, mostra também as linhas sem valor nas medidas.
Regras da linha	Na seção Avançado, pinta a linha inteira quando uma condição casa, sem código. Só aparece no formato atual.
Formatação avançada de linha	Na seção Avançado, a regra de linha em JavaScript. Veja Regras em JavaScript.

Escolher um Modelo de estilo, mudar algo no Ajuste fino, usar Pixels ou arrastar a largura de uma coluna no cabeçalho passa a tabela para o formato atual de estilo. Abrir o configurador não converte nada. As tabelas antigas continuam com a aparência de antes até alguém fazer isso. Se a tabela tinha cores fixas do modo antigo, o Ajuste fino avisa e oferece Trazer as cores escolhidas para cá.

Configuração da coluna

A engrenagem de cada campo abre Configuração do Campo.

Na tela	O que faz
Ocultar Campo	Consulta a coluna sem mostrá-la. Serve para usar o valor numa regra.
Rótulo Customizado	Troca o título da coluna só nesta tabela.
Tooltip	Mostrar tooltip ao passar mouse no cabeçalho, com o texto em Texto a ser exibido. Aceita *negrito* e _itálico_.
Alinhamento Customizado	Força o alinhamento. Sem ele, número vai à direita e texto à esquerda. No formato atual, o alinhamento fica em Estilo da coluna.
Lógica do Totalizador	Como o rodapé desta coluna é calculado. Só em coluna numérica. Veja abaixo.
Estilo da coluna	Fonte, tamanho, alinhamento, cores e Ícone no rótulo (antes ou depois do texto). Só no formato atual.
Formato do valor	O formato da coluna. Só no formato atual. Veja abaixo.
Regras condicionais	Cores e marcas por condição. Só no formato atual. Veja abaixo.

Numa visão alternativa, a coluna herda estilo, formato e regras da mesma coluna na principal até você mudar algo nela.

Lógica do Totalizador

Opção	Como calcula
Expressão (Nativo)	O banco calcula o total com a mesma fórmula da coluna. É o padrão.
Soma, Média, Máximo, Mínimo, Mediana	O navegador calcula sobre as linhas carregadas na tabela.

Use Expressão (Nativo) para razão e média ponderada. Uma coluna "Margem %" com Soma soma as margens de cada linha e dá um número sem sentido; com Expressão (Nativo), o rodapé mostra lucro total ÷ venda total. As opções do navegador também mudam de valor quando o Limite de Linhas corta a tabela.

Formato do valor

Na tela	O que faz
Tipo	automático (a máscara do campo), número, percentual, moeda ou texto. Coluna de texto só oferece automático e texto.
Casas	Casas decimais, de 0 a 8.
Escala	nenhuma, × 100, ÷ 1.000, ÷ 1.000.000, ou abreviar (K, M, B, T).
Moeda	Com o tipo moeda: Real, Dólar, Euro, Libra, Peso argentino, Guarani, Peso uruguaio, Peso chileno, Iene ou Yuan.
Negativo	com sinal − ou entre parênteses.
Em volta	prefixo e sufixo colados ao valor.
Vazio	O que mostrar sem valor. Padrão: -.

Aqui percentual multiplica por 100 uma vez: 0,1534 aparece como 15,34%. Nas tabelas que ainda não passaram ao formato atual, a coluna numérica mostra Formatação do Número: Padrão, Por Lista (o Formato do Número comum) ou Por Expressão (uma regra em JavaScript). Nesse formato antigo, Porcentagem multiplica por 100 duas vezes: 0,1534 aparece como 1.534,00%, e Moeda é sempre real.

Regras condicionais

Cada regra tem uma condição (Quando a célula) e um efeito (Ela fica assim). Vale a primeira regra que casar, de cima para baixo; as setas reordenam, e cada regra pode ser desligada sem apagar.

Condição	Casa quando a célula
for maior / menor que	Compara (>, >=, <, <=, =, !=) com um valor fixo, outra coluna ou outra coluna × um número.
for exatamente o texto	Tem exatamente o texto digitado, como aparece na célula.
estiver entre	Fica entre dois limites, cada um valor fixo ou outra coluna.
estiver vazia	Não tem valor.
estiver entre os N maiores / menores	Está entre os N maiores ou menores valores da coluna.
estiver acima / abaixo da média	Fica acima da média da coluna ou abaixo da média da coluna.
atender TODAS as condições, atender QUALQUER condição	Junta várias condições (+ condição).
escala de cor — contínua, pela coluna	Sempre: cada célula numérica ganha a cor da posição entre o menor e o maior valor da coluna, com 2 ou 3 cores. pintar o texto em vez do fundo muda o alvo.
barra de dados — contínua, pela coluna	Sempre: cada célula numérica ganha uma barra proporcional ao valor.
código (avançado)	editar código abre uma regra em JavaScript que devolve a cor ou um objeto de efeito.

O efeito muda Texto (cor, negrito, itálico, sublinhado, riscado), Fundo (com degradê) ou Marca, um ícone antes do texto, depois do texto ou no lugar do texto. vale também no total aplica a regra ao rodapé.

As Regras da linha, na seção Avançado, usam o mesmo editor com Quando a coluna: você escolhe a coluna que a condição olha, e o efeito pinta a linha inteira. Ali não há maiores e menores, média, escala, barra nem Marca. Uma visão alternativa herda as regras de linha da principal até ganhar as dela.

Nas tabelas que ainda não passaram ao formato atual, a coluna mostra Estilo de Coloração (Indicador, uma bolinha ao lado do valor, ou Cédula, a célula inteira) e Tipo de Coloração: Por Escala (faixas numéricas com cor), Por Valor (cor por texto exato) ou Por Expressão.

Regras em JavaScript

A Tabela aceita regras em JavaScript nos lugares abaixo. Em this.row, as colunas da linha aparecem pelo nome da coluna na tabela do HorusDW, como this.row.status.

Regra	Devolve	Variáveis
Cor da célula (Expressão de Cor da Cédula)	Uma cor	this.value (valor cru), this.row; no rodapé, this.value e this.isTotalizador
Formato por expressão	O texto da célula	this.value, this.row, this.prevRow (a linha anterior); no rodapé, this.value e this.isTotalizador
Formatação avançada de linha	Um estilo CSS para a linha	this.row, this.prevRow, this.index (posição, a partir de 0), this.rows (todas as linhas)
código (avançado) numa regra condicional da coluna	Uma cor ou um objeto de efeito	this.value, this.row
código (avançado) numa regra da linha	Verdadeiro ou falso: se a regra casa	this.row, this.prevRow, this.index, this.rows

Exemplo de regra de linha que apaga os produtos inativos:

if (this.row.status === "Inativo") return "background: #f1f5f9; color: #94a3b8";
return "";

Limites

• Ao exportar o widget em imagem ou PDF, a tabela sai com no máximo 100 linhas.
• Soma, Média e as outras lógicas do navegador só enxergam as linhas carregadas.
• O contador de linhas não acompanha a reordenação.
• Nas tabelas que ainda não passaram ao formato atual, Porcentagem em Por Lista multiplica por 100 duas vezes. Veja o aviso em Formato do Número.

Pelo Lumo CLI

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