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.