Comparativo de Datas
Campo especial que permite alterar o funcionamento de um campo do tipo data no filtro do resumo, possibilitando a comparação de métricas ao longo do tempo. Para utilização deste tipo de campo, é necessário ter um campo do tipo data criado, e posteriormente alterar seu tipo para Comparativo de Datas.
Está disponível apenas no filtro avançado e seu funcionamento é exclusivo para o módulo de resumo da consulta.
Exemplo do campo no filtro do resumo
Exemplo do resumo comparando as métricas no período
Ao utilizar o comparativo, o resumo será montado exibindo os valores dos períodos informados.
Configuração Geral
Neste bloco estão as configurações gerais do campo, e onde ele será ‘transformando’ em um campo comparativo de dadas, basta acessar as configurações de um campo data e mudar o Tipo de dado para Comparativo de Datas.
Tipo de Dado
Define o formato dos dados no campo da aplicação. Cada tipo de dado possui características e configurações específicas que influenciam a maneira como os dados são manipulados, validados e exibidos.
O tipo de dado é definido automaticamente pelo Scriptcase, de acordo com o tipo do campo na tabela, por exemplo, um campo do tipo varchar(255) terá seu Tipo de Dado definido como texto.
O desenvolvedor pode alterar o tipo de dado para atender as necessidades do sistema, mas deve levar em consideração o tipo do campo na tabela.
Label Filtro
Define o título de um campo em uma aplicação do Scriptcase, com o objetivo de identificar e descrever o propósito do campo para o usuário do sistema.
Este atributo pode ser definido utilizando langs para sistemas multi-idiomas, que são gerenciadas no menu Traduzir aplicações, ou definindo o texto diretamente no campo, de acordo com a necessidade do sistema.
Utilizando a macro sc_label o desenvolvedor pode criar rotinas para alterar dinamicamente o nome dos campos, atendendo às necessidades do sistema.
Usar o mesmo label da Grid
Esta opção quando ativada, permite utilizar o título do campo definido na grid, neste caso o valor definido no atributo Label filtro será desconsiderado.
Formatação dos Valores
Usar configurações regionais
Quando habilitado, aplica as Configurações Regionais de formação da data, levando em consideração o idioma utilizado na aplicação.
As Configurações Regionais definem a exibição dos campos de acordo com o idioma utilizado na aplicação. Esta definições podem ser alteradas, basta acessar o menu: Localidades > Configurações Regionais
Confira abaixo mais detalhes sobre cada opção de configuração.
Separador de data
Define o caractere que será utilizado para a separação visual das partes da data (dia, mês e ano). Os caracteres normalmente utilizados são: barras (“/”), hifens (“-“) e Pontos (.).
Alguns exemplos de separadores
- Barras (/): 25/10/2023
- Hifens (-): 25-10-2023
- Pontos (.): 25.10.2023
Esta opção será exibida caso o atributo Usar configurações regionais seja desabilitado.
Primeiro Dia
Define o primeiro dia da semana para a exibição no calendário do campo data, para a seleção de datas.
Exemplo de alteração do primeiro dia
Neste exemplo o Primeiro dia foi definido como Segunda-feira, alterando a ordem de exibição dos dias da semana no calendário do campo.
Esta opção será exibida caso o atributo Usar configurações regionais seja desabilitado.
Exibição
Define o formato de exibição da data, selecionado um dos formatos listados.
As opções são:
- dd-mm-aaaa
- mm-dd-aaaa
- aaaa-mm-dd
Esta opção será exibida caso o atributo Usar configurações regionais seja desabilitado.
Exibir número da semana
Quando habilitado, o calendário do campo data (para seleção de uma data) será exibido com o contador de semanas.
Exemplo do calendário com número de semanas
Esta opção será exibida caso o atributo Usar configurações regionais seja desabilitado.
Condições Especiais
Define quais condições especiais serão exibidas no calendário do campo, facilitando a definição do intervalo de tempo que será considerado no filtro.
Confira o exemplo abaixo.
Exemplo das condições especiais no calendário do campo data
Caso nenhum intervalo esteja habilitado, o calendário será exibido apenas com a opção Personalizado. Nesta opção o usuário terá que informar um intervalo de datas selecionando manualmente ou digitando os valores no campo.
Exemplo do campo data sem condições especiais
Selecionar Valores
Neste atributo, o desenvolvedor define os intervalos de tempo que serão exibidos como opção no calendário do campo.
As condições selecionadas serão listadas na aba Ordenação, onde podem ser reordenadas de acordo com a necessidade do sistema.
Em cada uma das abas é possível criar intervalos personalizados ao clicar no botão Adicionar novo intervalo.
Aba de Ordenação
Nesta aba é possível ordenar e remover os intervalos selecionados através do x, ao lado do nome do intervalo, ou utilizando o botão Remover todos.
Adicionar Novo Intervalo
Ao clicar no botão Adicionar novo intervalo será aberta uma tela para inclusão de novos intervalos. Para adicioná-los devemos informar o Type e inserir o intervalo no atributo Valor.
Por exemplo, para adicionar o intervalo Próximos dois anos, em type selecione a opção Próximo, já no campo Valor informe o intervalo de tempo desejado, que neste exemplo é 2.
É possível adicionar novos intervaloes em todos os períodos: Ano, Trimestre, Mês, Semana e Dia.
Type
Define se o intervalo criado será referente a um período futuro (proximo) ou a um período aterior (ultimo).
- Proximo - Define que o intervalo criado será referente a data futura, por exemplo, Proximo ano.
- Último - Define que o intervalo será referente a uma data anterior, por exemplo, Último Ano.
Valor
Define o intervalo de tempo que a condição será criada.
Este campo aceita apenas valores inteiros e maiores que zero.
Título
Define o texto que será exibido na aplicação. Ao criar um novo intervalo uma lang é gerada automaticamente, é possível utilizar também um texto fixo.
Incluir Atual
Esta opção altera o funcionamento do intervalo criado, adicionando o período atual no intervalo.
Por exemplo, supondo que o ano atual seja 2024, utilizando o intervalo Próximos 2 anos as datas utilizadas seriam referentes aos anos 2025 e 2026.
Com o Incluir atual habilitado, este mesmo intervalo iria utilizar as datas dos anos 2024(ano atual) e 2025.
Configuração de Ajuda
Permite que o desenvolvedor adicione instruções e dicas de utilização no campo, permintindo assim que o desenvolvedores auxiliem os usuários no entendimento e na utilização do sistema.
Tipo do Help
Forma de exibição do help.
Descrição dos atributos da configuração.
Descreva Ajuda
Area destinada a inclusão do texto que será apresentado na aplicação de acordo com o tipo selecionado abaixo.
Hint
Exibe um ícone padrão ? ao lado do campo. Ao posicionar o mouse sobre o ícome, a mensagem será exibida.
O ícone exibido ao selecionar os tipos Hint ou Popup variam de acordo com o tema que está sendo utilizado. Este ícone pode ser alterado no [css dos botoes].
Texto
Exibe o texto dentro de um <span></span> ao lado do campo.
Pop-up
Exibe um ícone padrão ? ao lado do campo. Para exibir a mensagem basta clicar no ícone, um pop-up será exibido contendo o texto.
Tippy
Exibe um ícone padrão ? ao lado do campo. Ao posicionar o mouse sobre o ícome, a mensagem será exibida de forma mais amigável.
Configurações do tipo de ajuda (Tippy)
Descreva Ajuda : Define onde será exibido o botão de ajuda do campo
Posição do botão Ajuda : Define qual a posição de exibição do hint Tippy em relação ao ícone de ajuda do campo
Tempo para abrir o hint Tippy : Define o tempo em milissegundos para que o hint Tippy seja exibido após o mouse passar por cima do ícone de ajuda.
Tempo para fechar o hint Tippy : Define o tempo em milissegundos para que a dica do Tippy fique oculta após o mouse sair do ícone de ajuda.
Largura do hint Tippy : Define a largura da dica Tippy em pixels.
Posição do botão ajuda (Exceto Tippy)
Define onde o botão ajuda irá aparecer no campo da aplicação em execução. As opções são:
Ao lado: O ícone de ajuda irá aparecer ao lado do campo. Na coluna: O ícone de ajuda irá aparecer ao lado do label do campo.