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
Este atributo define o tipo de campo na aplicação. Esta definição implica nas opções de configuração que serão exibidas para o desenvolvedor, bem como no comportamento do campo ao executar a aplicação.
Durante o processo de criação das aplicações, o Scriptcase mapeia os campos da tabela utilizada e define o Tipo de Dado do campo de acordo com seu tipo SQL.
Por exemplo , campos do tipo varchar
na tabela serão definidos como texto
no atributo Tipo de dado.
É possível alterar o tipo de dado do campo, porem é importante levar em consideração o Tipo SQL, exibido no bloco de Configuração Geral, para definir o tipo de dado do campo.
Label Filtro
Define o título do campo que será exibido na aplicação quando executada. A label dos campos podem ser definidas utilizand: Lang, Texto ou Variável global.
Lang
O uso de lang facilita a manutenção e padronização da label dos campo já que toda a definição delas é realizada em um único local, no menu Traduzir aplicações. Com o auxílio do Dicionário de Dados é possível também substituir todos os textos que definem a label por langs, facilitando ainda mais a aplicação em seu projeto.
Este recurso é normalmente utilizado para criação de sistemas com multi idiomas.
Texto fixo
Ao optar pelo texto fixo, o título do campo não será alterado a partir da interação do usuário final, como por exemplo, a mudança do idioma da aplicação.
Variável global
A utilização de uma variável global permite a alteração do título de acordo com a regra de negócio do sistema.
Disponibilizamos também a macro sc_label que permite alterar o título da coluna independente da forma como o atributo label foi definido.
Exemplo do título de uma coluna
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.
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.
Tipo do Help
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.
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.
Posição do botão ajuda
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.