CEP

Configuração Geral

Interface de configuração do campo cep.

• Tipo do dado : Define o tipo do campo da aplicação. Quando o campo é definido como CEP é exibido ao lado um ícone, o qual se clicado irá abrir uma janela de pesquisa de CEPs; o campo é formatado ao perder o foco. O scriptcase se encarrega de verificar se o campo que foi fornecido existe, caso seja uma informação inexistente , será exibida uma mensagem de erro.

• Label : Define o título do campo na aplicação. Por exemplo: se o campo estiver definido no banco de dados como cmp_nome_cliente fica mais claro o entendimento se o mesmo for exibido como Nome do Cliente.

• Etiqueta abaixo do campo : Define a mensagem a ser exibida abaixo do campo

• Marca d’agua : É Criado uma marca d’agua no texto do campo selecionado.
• Valor inicial : Permite definir um valor inicial para o campo quando o formulário estiver em modo de inclusão. As opções são:
  • Valor definido : O campo será preenchido com o valor informado na caixa de texto do atributo Valor Inicial.
  • Data do sistema : O campo será preenchido com a data atual do servidor.

    Caso selecione o tipo Data do Sistema, não é necessário o preenchimento do atributo Valor Inicial.

• Valor inicial : Permite definir o valor inicial do campo.

Interface de configuração do valor inicial.

• Quantidade de caracteres : Permite configurar a largura do objeto Text informando a quantidade de caracteres.
• Gravar Variável : Permite gravar uma variável de sessão com o valor do campo, que poderá ser utilizada em outras aplicações. Por exemplo, no formulário de login o nome do usuário pode ser salvo em sessão para exibição no cabeçalho de outras aplicações.
• Nome da Variável : Permite definir o nome da variável de sessão que receberá o valor do campo.
• Campo Escondido : Esta opção disponibiliza o campo no formulário como tipo hidden (Escondido), estando o valor do campo disponível para processamento (Javascript ou PHP).
• Campo Label : Exibe apenas o valor do campo sem permitir a edição dos dados tanto na atualização quanto na inclusão.

Interface de configuração do label.

• Preenchimento automático do navegador : Define se o campo permitirá o preenchimento automático do navegador. Por padrão, o preenchimento automático dos campos é permitido.
  • Quando estiver desabilitado, o campo permitirá o preenchimento automático pelo navegador.
  • Quando estiver habilitado, o preenchimento automático do campo será bloqueado.
• Desabilitar Campo : Define se o campo será desabilitado em “Modo de Inserção”, “Modo de Atualização” ou em “Modo de Inserção e Atalização”.
• Tipo HTML : Objeto HTML usado para exibir o campo no formulário.
• Tipo SQL : Informa o tipo do campo no banco de dados.

Formatação dos Valores

Interface de formatação de valores.

Dados do CEP

Define os campos que serão preenchidos com os valores correspondentes ao CEP pesquisado.

Com este recurso é possível recuperar os seguintes valores:

• Logradouro
• Bairro
• Cidade
• UF
• Tipo do Logradouro
• Nome do Logradouro
• Latitude
• Longitude

Clicando no botão é possível pesquisar pelo CEP desejado. Veja como realizar esta pesquisa na sessão Pesquisando o CEP..

CEP no onChange

Define a forma de preenchimento dos campos informados na opção Dados do CEP.

Opção Habilitada

Neste caso, após digitar um CEP válido, o evento onchange é disparado no campo, recuperando os valores e preenchendo automaticamente de acordo com os campos definidos anteriormente.

Caso o CEP informado seja inválido, um erro será exibodo: CEP não encontrado

Opção Desabilitada

Neste caso, para realizar o preenchimento dos campos configurados na opção Dados do CEP, será necessário confirmar as informações recuperadas pelo CEP, clicando no botão .

Em seguida, a Tela de Confimação dos dados será exibida. Para realizar o preenchimento dos campos, basta clicar em Confirmar.

Exemplo da tela de Confirmação dos dados: .

Tambem é possível realizar o preenchimento dos campos através da pesquisa pelo CEP. Veja como realizar esta pesquisa na sessão Pesquisando o CEP.

Pesquisando o CEP

O botão ativa a pesquisa do CEP, caso nenhum valor seja informado no campo ou quando a opção Atualizar o CEP no evento onChange está ativa.

Ao clicar no botão, a tela de pesquisa será exibida.

Veja abaixo um exemplo da tela de pesquisa preenchida:

Para realizar a pesquisa, apenas o campo tipo é dispensável, todos os demais são obrigatórios.

Os campos para a pesquisa do CEP são:

• UF - Selecione o estado do CEP que será pesquisado;
• Localidade - Informe o nome da cidade onde a busca do CEP será realizada.
• Tipo - Selecione o tipo de endereço: Avenida, Bloco, Praça, Quadra, Rua e Outros.
• Logradouro - Recebe o nome da rua do CEP que será pesquisado;
• Condição - Define a condição de pesquisa para o campo logradour. As opções são: Que contenha, Exatamente igual, Começando com e Terminando com

Exemplo do resultado da pesquisa

Caso o CEP seja listado, selecione o endereço desejado e clique em Confirmar, caso contrário clique em cancelar e realize a pesquisa novamente

Ao clicar em confirmar, os campos configurados anteriormente devem ser preenchidos.

Valor no Banco de Dados

Permite definir o valor a ser gravado no banco de dados.

Interface de configuração do valor no banco de dados.

• Valor Definido : Permite especificar um valor fixo ou associar a variáveis globais.

Interface de configuração do valor definido.

• Auto Incremento (automático) : Permite utilizar o incremento gerado pelo banco de dados. Usado apenas quando o campo do banco de dados é do tipo AUTO INCREMENT ou similar. Para os bancos de dados que utilizam sequência, tais como Oracle, PostGres e Firebird, é necessário informar o nome da sequência.

Interface de configuração do auto incremento.

• Auto Incremento (manual) : A aplicação gerada simulará um auto incremento no campo. Para a inclusão o valor do campo será calculado automaticamente pela aplicação.
• Data de inclusão : Na inclusão o campo será preenchido com a data do servidor.
• Data de atualização : Na atualização o campo será preenchido com a data do servidor.
• IP do usuário : O campo receberá o IP da máquina que está acessando a aplicação.
• Calculado pelo banco de dados : O valor do campo será atribuído pelo próprio banco de dados. O campo não será utilizado nos processos de atualização. Por exemplo: será atualizado através de um Trigger.
• Nulo : O campo será preenchido com nulo (null).

Configurações de Lookup

##

Forma utilizada para exibir uma descrição ao lado do campo.

Interface de configuração do Lookup de Edição.

• Usar lookup para exibir descrição do campo : Quando marcado é ativado o lookup de consulta e abre as demais configurações.
• Comando SQL : Define o comando SQL que irá recuperar os valores no banco de dados. Para montar o comando SQL é possível utilizar o construtor de select . O comando SQL deve ter o seguinte formato:

SELECT Campo_a_ser_Exibido FROM tabela WHERE Campo_Chave = '{Campo_do_Formulário}'

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

• Fonte : Define o tipo de fonte que será usada na exibição do lookup.
• Cor da fonte : Define a cor em formato HTML da fonte utilizada na exibição do lookup.
• Tamanho da fonte : Define o tamanho da fonte na exibição do lookup.
• Mensagem em caso de EOF : Define a mensagem que será exibida caso não seja encontrado nenhum registro.
• Utilizar na Validação : Quando marcado irá gerar uma validação automática do campo com base no lookup, caso não seja encontrado nenhum registro a mensagem será exibida como crítica (Atualização e Inclusão).

Interface de configuração da validação do Lookup de Edição.

• Usar conexão específica : Permite selecionar uma outra conexão existente no projeto diferente da conexão atual do formulário.

Configuração da Visualização

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.

• 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 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.