Feedback

Integer

Configuração Geral

Nesta página, o desenvolvedor podera definir as configurações referentes ao seu campo do tipo Número. Desde a utilização de símbolos específicos de exibição até o modo em que são exibidos. Podendo assim, dinamizar sua aplicação.

Interface de configuração do campo número.

Tipo do dado:

Define o tipo do campo da aplicação. Quando o campo é definido como Número, é permitido definir regras de formatação de números inteiros.

Label:

Define o título que será exibido no campo ao executar a aplicação. A terminologia utilizada na interface é fundamental para que seu sistema tenha uma boa usabilidade. Neste caso, devemos utilizar nomes e termos familiares para o usuário final da aplicação, ao invés de utilizarmos termos originados no sistema.

Máscara de Exibição:

Define a máscara de exibição do campo. São dois os tipos de máscara descritos na tabela abaixo:

Caracter Descrição
X É substituído por quaisquer caracteres retornados pelo banco de dados. Seu preenchimento é obrigatório e quando forem retornados menos caracteres do que o tamanho da máscara, o valor será completado com zeros à esquerda.
Z É substituído por quaisquer caracteres retornados pelo banco de dados. Seu preenchimento é opcional e quando forem retornados menos caracteres do que o tamanho da máscara, nada será feito em relação aos caracteres que estão faltando. Além disso os zeros à esquerda serão suprimidos. Obrigatoriamente o uso deste caracter é à esquerda da máscara quando usado em conjunto com o X.

Por exemplo, é possível configurar a máscara para a exibição de um número de telefone:
![Configuracao Mascara][img_mascaraconf_grid]

Ele irá aparecer com a seguinte formatação na execução:
![Execucao Mascara][img_mascaraexec_grid]

Também é possível configurar a máscara de exibição da seguinte maneira:

Exemplos de máscaras:

Campo Máscara Valor Digitado Valor Formatado
Número de Telefone (xx) xxxx - xxxx 12345678 (00) 1234 - 5678
Número de Telefone (xx) xxxx - xxxx 1234567890 (12) 3456 - 7890
Número de Telefone (zz) xxxx - xxxx 12345678 ( ) 1234 - 5678
Software Key (Letras e Números) xxxx-xxxx-xxxx-xxxx Q1W2E3R4T5Y6U7I8 Q1W2-E3R4-T5Y6-U7I8

Repetir Valor:

Habilitar esta opção permite repetir o valor do campo caso este seja igual ao valor do registro anterior na base de dados.

Exemplo:

Exibição de repetição de valores.

Tipo SQL:

Informa o tipo SQL do campo tal como ele está configurado no banco de dados.

Formatação dos Valores

Interface de formatação de valores.

Usar configurações regionais:

Permite aplicar as configurações regionais de formatação de números ao campo. Quando não for selecionada serão exibidos os atributos Agrupamento, Sinal negativo e Formato de número negativo.

Agrupamento:

Define qual caractere será usado para a separação de milhar. Esta opção só estará disponível quando a opção de Usar configurações regionais estiver desabilitada.

Sinal negativo:

Define qual caractere será usado para a exibição de números negativos. Esta opção só estará disponível quando a opção de Usar configurações regionais estiver desabilitada.

Formato de número negativo:

Define o posicionamento do sinal negativo em relação ao valor. Esta opção só estará disponível quando a opção de Usar configurações regionais estiver desabilitada.

Cor dos Negativos:

Permite definir uma cor quando o valor for negativo, facilitando o entendimento do usuário final.

Exemplo:

Cor do Valor Negativo

Exibir valor por extenso:

O valor do campo será exibido por extenso na aplicação. Esta funcionalidade pode facilitar a compreensão e entendimento do usuário.

Exemplo:

Exibir Valor por Extenso

Tamanho da Linha:

Tamanho máximo em caracteres a ser exibido na célula do valor, por extenso. Ao ultrapassar este valor é feita a quebra da linha dentro da célula.

Lookup Settings

O Lookup é uma forma utilizada para disponibilizar ao usuário final uma lista de valores onde poderão ser selecionados os itens que serão utilizados na Aplicação. Por exemplo, para um campo sexo no banco de dados com valores M ou F pode ser apresentado como Masculino ou Feminino de forma dinâmica. É possível recuperar esses valores de uma tabela do banco de dados.

Exemplo:

Configuração de exibição de campo com lookup de consulta.

Métodos para Lookup

Estão disponíveis dois métodos de lookup:

Manual: Para utilizar este método, é necessáiro informar manualmente as condições de seleção do Lookup.

Automático: Neste método, para definir este método de lookup, é necessário utilizar uma query do banco de dados.

Seleção do tipo de Lookup.

Lookup de Edição - Automático:

Interface Lookup de Consuta Automático.

Comando Select:

Define o comando SQL que irá recuperar o valor a ser exibido no campo da consulta. O comando deverá ter o seguinte formato SELECT campo_a_ser_exibido FROM tabela WHERE campo_chave = {campo_da_consulta}.

O campo da consulta deve ser referenciado sempre entre chaves {}. No momento da execução, o campo entre chaves será substituido pelo seu valor na tabela.

Múltiplas Opções:

Quando o Comando Select informado retornar vários valores, a opção Sim deve ser selecionada.

Delimitador:

Define o separador dos valores retornados pelo Comando Select, esta opção deverá ser preenchida quando estiver marcado Sim no atributo Múltiplas Opções.

Usar o lookup em:

Consulta : Aplica o lookup em todas as formas de consulta (HTML, PDF, XML , CSV e RTF).

Resumo : Aplica o lookup somente no resumo (HTML e PDF).

Ambos : Equivale à marcação das opções Consulta e Resumo.

Valor Default:

Define um valor padrão, usado nos casos onde o comando select não retorna nenhum valor.

Exibir valor original e lookup:

Quando selecionado Não, é exibido apenas o valor retornado pelo Comando Select. Caso contrário, serão exibidos o valor original do campo e o valor retornado pelo Comando Select separados pelo caractere definido em Separados por.

Separados Por:

Define o(s) caracter(es) que será(ão) usado(s) para separar o valor orignal do campo e o valor retornado pelo Comando Select. Esta opção deverá ser preenchida quando estiver marcado Sim no atributo Mostrar valor original e lookup.

Usar conexão específica:

Permite selecionar uma outra conexão existente no projeto diferente da conexão atual da consulta.

Lookup de Edição - Manual:

Lookup usado para modificar a exibição do campo com valores pré-definidos.

Interface Lookup de Consulta Manual.

Tipos de Lookup

Define o modo de funcionamento do lookup, podendo ser : Simples Valor , Múltiplos Valores (Delimitador), Múltiplos Valores (Posição) e Múltiplos Valores (Binário).

Simples Valor: Será exibido apenas um valor para o campo. É feita uma substituição direta do valor armazenado no banco por um label definido em uma lista.

Configuração do lookup Simples Valor.

Label: Texto que será exibido na consulta.

Valor: Atributo que corresponde ao valor armazenado na tabela. Por exemplo, o valor M será substituído por Masculino.

Múltiplos Valores (Delimitador):

Poderão ser exibidos vários valores para o campo selecionado. Os valores devem ser separados por um delimitador a ser informado. É feita uma substituição das partes de uma string armazenada no campo, separadas por um delimitador, por valores contidos em uma lista.

Configuração do lookup Múltiplos Valores (delimitador).

Label: Texto que será exibido na consulta.

Valor: Atributo que corresponde ao valor armazenado na tabela. Por exemplo, o valor E;C será substituído por Esportes Cinema .

Delimitador: Caracter usado para separar os valores dentro de uma mesma string.

Múltiplos Valores (Posição)

Permite recuperar diversas informações armazenadas em uma única string do campo selecionado. Para que estas informações sejam recuperadas são informados, além do label, a posição inicial e a quantidade de bytes que cada informação ocupa dentro da string.

Como exemplo usaremos uma string para armazenar Sexo, Estado civil e Hobby respectivamente. Sexo ocupa um byte, estado civil um byte e hobby dois bytes.

Para tanto definimos a lista como:

Label Valor Inicio Tamanho
Masculino M 1 1
Feminino F 1 1
Casado C 2 1
Solteiro S 2 1
Estudar ED 3 2
Esportes ES 3 2
Ler LE 3 2

Exemplo: A string MCED seria apresentada na consulta como: MasculinoCasado Estudar.

Configuração do lookup Múltiplos Valores (Posição).

Label : Texto que será exibido na consulta. Valor : Atributo que corresponde ao valor armazenado na tabela. Por exemplo, o valor M será substituído por Masculino. Início : Posição inicial na string onde a informação está gravada. A primeira posição é sempre 1. Tamanho : Quantidade de bytes que a informação ocupa na string.

Múltiplos Valores (Binário):

Permite recuperar diversas informações armazenadas em forma decimal do campo selecionado.

Como exemplos usaremos a seguinte lista (apesar de não ser informado na interface de inclusão de valores na lista, cada item possui um valor atribuido automaticamente de acordo com a ordem):

Valor Atribuído Descrição no Lookup
1 Esportes
2 Cultura
4 Lazer
8 Leitura
16 Música

Para exibição dos dados é realizada uma decomposição do número decimal armazenado no banco. Por exemplo: os números 11 e 12 (gravados na base de dados) seriam decompostos da seguinte forma:

11 = 1 + 2 + 8 = (Esportes - Cultura - Leitura)

Valor Atribuído Descrição no Lookup
1 Esportes
2 Cultura
4 Lazer
8 Leitura
16 Música

12 = 4 + 8 = ( Lazer - Leitura)

Valor Atribuído Descrição no Lookup
1 Esportes
2 Cultura
4 Lazer
8 Leitura
16 Música

Configuração do lookup Múltiplos Valores (Binário).

Label:

Texto que será exibido na consulta.

Botão Incluir:

Inclui na lista os valores preenchidos nos campos Label e Valor.

Botão Alterar:

Altera os atributos do item selecionado.

Botão Excluir:

Exclui o item selecionado.

Botão Limpar:

Limpa os campos.

Botão Salvar:

Permite que o usuário salve toda a lista, para posterior utilização através da opção Carregar Definição de Lookup.

Carregar Definição de Lookup:

Permite carregar uma Lista de valores pré-definida para uso como lookup.

Usar o lookup em:

Consulta: Aplica o lookup em todas as formas de consulta (HTML, PDF, XML , CSV e RTF).

Resumo: Aplica o lookup somente no resumo (HTML e PDF).

Ambos Equivale à marcação das opções Consulta e Resumo.

Valor Default:

Define um valor padrão, usado nos casos onde o valor armazenado não corresponde a nenhum valor da lista.

Exibir valor original e lookup:

Quando selecionado Não, é exibido apenas o valor retornado pelo Comando Select. Caso contrário, serão exibidos o valor original do campo e o valor retornado pelo Comando Select separados pelo caracter definido em Separados por.

Separados Por:

Define o(s) caracter(es) que será(ão) usado(s) para separar o valor orignal do campo e o valor retornado pelo Comando Select. Esta opção deverá ser preenchida quando estiver marcado Sim no atributo Mostrar valor original e lookup.

Configuração da Visualização{#id-04}

A Configuração da Visualização permite definir valores de CSS para campos individualmente. Para cada Esquema de Visualização do Scriptcase existem os mesmos atributos disponíveis nesta Interface.

Interface de configuração da visualização. Interface de configuração da visualização.

  • CSS do Título
    • Fonte : Permite escolher o tipo de fonte, que será aplicado no campo da aplicação.
    • Tamanho : Permite escolher o tamanho da fonte, que será aplicado no objeto da aplicação.
    • Cor da fonte :Permite escolher a cor utilizando uma paleta de cores para ser aplicada a fonte.
    • Cor de fundo : Permite escolher a cor, utilizando uma paleta de cores para ser aplicada como plano de fundo do campo da aplicação.
    • Negrito : Permite aplicar o tipo negrito na fonte.
    • Sublinhado : Permite aplicar o tipo sublinhado na fonte.
    • Tamanho da Borda : Permite aumenta o tamanho da borda do título.
    • Cor da Borda : Permite escolher a cor da borda, utilizando uma paleta de cores para ser aplicada no título.
    • Alinhamento Horizontal : Permite posicionar o label do filtro no local desejado (left,rigth,center e justify).
    • Alinhamento Vertical : Permite posicionar o label do fitro no local desejado (baseline, sub, super, top, text-top, middle, bottom, text-bottom).
    • Largura : Para definir a largura do título.
    • Altura : Para definir a altura do título.
  • CSS do Campo
    • Fonte : Permite escolher o tipo de fonte, que será aplicado no campo da aplicação.
    • Tamanho : Permite escolher o tamanho da fonte, que será aplicado no título da aplicação.
    • Cor da fonte :Permite escolher a cor utilizando uma paleta de cores para ser aplicada a fonte.
    • Cor de fundo : Permite escolher a cor, utilizando uma paleta de cores para ser aplicada como plano de fundo do campo da aplicação.
    • Negrito : Permite aplicar o tipo negrito na fonte.
    • Sublinhado : Permite aplicar o tipo sublinhado na fonte.
    • Tamanho da Borda : Permite aumenta o tamanho da borda do campo.
    • Cor da Borda : Permite escolher a cor da borda, utilizando uma paleta de cores para ser aplicada no campo.
    • Alinhamento Horizontal : Permite posicionar o label do filtro no local desejado (left rigth, center e justify).
    • Alinhamento Vertical : Permite posicionar o label do fitro no local desejado (baseline, sub, super, top, text-top, middle, bottom, text-bottom).
    • Largura : Para definir a largura do campo.
    • Altura : Para definir a altura do campo.
  • CSS do Objeto Input
    • Fonte : Permite escolher o tipo de fonte, que será aplicado no objeto input. Por exemplo: Radio, Select, Text, etc
    • Tamanho : Permite escolher o tamanho da fonte, que será aplicado no título da aplicação.
    • Cor da fonte : Permite escolher a cor utilizando uma paleta de cores para ser aplicada a fonte.
    • Cor de fundo : Permite escolher a cor, utilizando uma paleta de cores para ser aplicada como plano de fundo do objeto input.
    • Negrito : Permite aplicar o tipo negrito na fonte.
    • Sublinhado : Permite aplicar o tipo sublinhado na fonte.
    • Tamanho da Borda : Permite aumenta o tamanho da borda do objeto input.
    • Cor da Borda : Permite escolher a cor da borda, utilizando uma paleta de cores para ser aplicada no objeto input.
    • Alinhamento Horizontal : Permite posicionar o label do filtro no local desejado (left, rigth, center e justify).
    • Alinhamento Vertical : Permite posicionar o label do fitro no local desejado (baseline, sub, super, top, text-top, middle, bottom, text-bottom).
    • Largura : Para definir a largura do objeto input.
    • Altura : Para definir a altura do objeto input.

Configuração da 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.

Interface de configuração da ajuda.

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.

Interface de configuração do tipo de exibição da ajuda.

Hint - Exibe um ícone padrão ? ao lado do campo. Ao posicionar o mouse sobre o ícome, a mensagem será exibida.

Interface de configuração do tipo de exibição da ajuda.

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.

Interface de configuração do tipo de exibição da ajuda.

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.