Calendário

Tipo

Referência

Para

Analista

Na tela

DataViz › Aplicação › Dashboards › Editando Widget › Calendário

O Calendário desenha um mês em grade e pinta cada dia conforme o valor de uma medida: quanto maior, mais perto da cor final. Ajuda a achar padrão no dia a dia, como o dia da semana que mais vende, a quinzena de pico do contas a pagar ou os dias em que a carga não trouxe nada.

Nome, filtros e Campos para Relatório seguem as opções comuns.

Aba Dados

Na tela	O que faz
Coluna de Data	A data de cada dia.
Coluna de Valor	A medida que dá a cor e o número de cada dia, como Vendas.Valor (soma).
Colunas de Informação Extra	Medidas que aparecem só no balão ao passar o mouse sobre o dia, e no detalhe do dia.
Ação do clique no dia	Filtrar o dashboard (o padrão) ou Abrir detalhes do dia. Veja Clique no dia.
Coluna de detalhe	Aparece com Abrir detalhes do dia. A dimensão pela qual o valor do dia será quebrado, como Cidade ou Categoria.
Filtros	Restringe só este widget. Veja Filtros.

Aba Visual

Na tela	O que faz
Aparência	Padrão, Transparente ou Destacado. Veja Aparência.
Modo de Exibição	O que vai escrito em cada dia: Apenas Dia, Apenas Valor, Dia e Valor ou Sem Informação (só a cor).
Tipo de Visualização	Mês Final, Selecionar Mês ou Acumulado. Veja abaixo.
Cor Inicial (Valores Mínimos), Cor Final (Valores Máximos)	As pontas do degradê. O dia de menor valor no mês fica com a inicial, o de maior com a final. Padrão: azul claro e azul escuro.
Cor para Valores Ausentes	A cor dos dias sem dado, como feriado ou dia sem venda. Padrão: cinza claro.
Formato do Número	Padrão do Campo, Número, Moeda, Porcentagem, Reduzido (1,2K, 3,4M) ou Inteiro. Vale para o número escrito no dia; o balão usa o formato da coluna.
Campos para Relatório	Veja Campos para Relatório.

Tipo de Visualização	O que mostra
Mês Final	O último mês com dado, sem navegação. Bom para um painel do mês corrente.
Selecionar Mês	Setas e uma lista de meses, para andar pelo período que os filtros trazem.
Acumulado	Uma grade só, de 1 a 31, com todos os meses juntos: o dia 5 reúne todos os dias 5 do período. Responde perguntas como "o começo do mês vende mais que o fim?".

No Acumulado, cada dia é a medida calculada sobre todos os dias com aquele número. Para uma soma, é a soma de todos os dias 5; para uma média, a média deles.

A escala de cor é calculada mês a mês. Um dia escuro em março é escuro em relação aos outros dias de março, e não ao ano inteiro.

Quando o widget é baixo demais para o mês inteiro, os dias rolam dentro dele e os nomes dos dias da semana ficam fixos no topo.

Clique no dia

Com Filtrar o dashboard, clicar num dia aplica aquela data como filtro no Dashboard inteiro. No Acumulado, o filtro é o dia do mês: clicar no 5 filtra todos os dias 5.

Com Abrir detalhes do dia, o widget troca a grade pelo detalhe daquele dia, e o resto do Dashboard continua como está. O detalhe, com o título Detalhes: {data}, traz:

• A data e o total do dia, no mesmo tom de cor da célula.
• As Colunas de Informação Extra, se houver.
• O valor do dia quebrado pela Coluna de detalhe, do maior para o menor, com a cor calculada sobre as próprias linhas do detalhe.
• O botão Filtrar, que aparece ao passar o mouse numa linha e aplica aquele item como filtro do Dashboard.

A seta no canto do título (Voltar ao calendário) retorna à grade. Dias sem valor não abrem detalhe. Sem Coluna de detalhe, o widget avisa "Configure a coluna de detalhe para ver a quebra do dia.", e um dia sem itens mostra "Sem detalhe para este dia.".

O detalhe mostra até 50 itens. Quando há mais, o rodapé avisa que mostra os 50 maiores e que há outros itens. Não existe uma linha "Outros" com o resto: numa medida que não soma, como ticket médio, o total do dia não é a soma das partes.

A Coluna de detalhe e os Campos para Relatório fazem coisas diferentes. A coluna de detalhe define a quebra mostrada dentro do widget; os Campos para Relatório entram no relatório que abre pelo menu do widget, fora dele.

Limites

• Um dia vazio no dado aparece com a Cor para Valores Ausentes, sem valor, e não abre detalhe nem filtra.
• Abaixo de 80 px de altura o widget não desenha a grade e pede "Aumente a altura para visualizar o calendário".
• Porcentagem no Formato do Número multiplica por 100 uma vez, como esperado: guarde a taxa como fração (0,15 para 15%).

Pelo Lumo CLI

Este widget também pode ser criado e versionado em YAML, com type: Calendar. O clique no dia fica em clickAction (filter ou details) e a coluna de detalhe em detailColumn. Veja a referência de app.