CHECKBOX

Permite utilizar no campo do formulário um objeto do tipo checkbox.

CONFIGURAÇÃO GERAL

Figura1: Interface Configuração Geral.

Atributos:

Tipo do dado - O Tipo de Checkbox é um objeto que permite a seleção de uma ou mais informação através de uma caixa de objetos de marcação.
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.
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.
  
  OBS: 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.
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.

Campo sem usar atributo label Campo usando atributo label
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.

VALOR NO BANCO DE DADOS

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

Figura3: Interface Valor Banco de Dados

As opções são válidas para Inserção e Atualização.

Valor Definido - Permite especificar um valor fixo ou associar a variáveis globais.
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.
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).

Lookup de Edição


Antes do Lookup		Depois do Lookup

Métodos para Lookup

Estão disponíveis dois métodos de lookup: Manual (informando manualmente as condições de seleção) ou Automático (utilizando uma query de banco de dados).

Figura1: Seleção do tipo de Lookup.

Lookup de Edição - Automático

Lookup utilizado para listar os valores que serão exibidos no campo Checkbox. Estes valores serão recuperados de forma dinâmica através de um Comando Select.

Figura2: Interface Lookup de Edição Automático.

Atributos :

Comando Select - Define o comando SQL que irá recuperar os valores a serem exibidos no campo do formulário. O comando deverá ter o seguinte formato "SELECT campo_chave , campo_a_ser_exibido FROM tabela".

OBS: O valor do campo_chave será armazenado no campo da tabela.

Colunas - Permite informar a quantidade de colunas para exibição dos itens do checkbox.

Delimitador - Define o caracter usado para separar os valores selecionados no campo do formulário. Caso não seja informado, o delimitador padrão será ponto e vírgula ( ; ).
Recarregar formulário após alteração do valor - Com esta opção selecionada, o formulário será recarregado quando houver mudança do item selecionado no objeto Checkbox.
Opção marcar todos - Exibe uma opção para marcar e outra para desmarcar todos os itens.

Exibir valor original e lookup - Exibe o valor do campo e o valor retornado pelo lookup.

Valor lookup

Valor original e lookup
- Separados por - Define que caracter será usado para separar o valor do campo e o valor retornado pelo lookup. Só é necessário preencher este campo se a opção Exibir valor original e lookup estiver selecionada.
Usar conexão específica - Permite selecionar uma outra conexão existente no projeto. O comando select será realizado nesta conexão secundária.

Lookup de Edição - Manual

Este método permite que o desenvolvedor crie manualmente uma lista de valores que ficará gravada na aplicação gerada. É utilizado o método Manual quando a base de dados não possui uma tabela com essas informações.

Figura3: Interface Lookup de Edição Manual.

Atributos:

Tipo 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

Permite a seleção de apenas um valor da lista.

Figura4: Configuração do lookup de edição Simples Valor

Label - Texto que será exibido para o item da lista no objeto checkbox.
Valor - Atributo que corresponde ao valor que será armazenado no campo da tabela. Por exemplo, o valor 2será incluído no campo da tabela quando na lista estiver selecionado o item Cha de Erva Doce.
Default - Com esta opção marcada o item já virá selecionado quando o formulário estiver em modo de inclusão.
Colunas - Permite informar a quantidade de colunas, para organizar o objeto no formulário.

Múltiplos Valores (delimitador)

Poderão ser armazenados vários valores para o campo selecionado. Os valores devem ser separados por um delimitador informado. Por exemplo: a combinação Andorra, Angola e Argentina selecionada no formulário será gravada como AD;AO;AR caso o delimitador seja ; (ponto e vírgula).

Figura5: Configuração do lookup de edição Múltiplos Valores (delimitador)

Label - Texto que será exibido para o item da lista no objeto checkbox.
Valor - Atributo que corresponde ao valor que será armazenado na tabela. Por exemplo, o valor AO será incluído no campo da tabela quando na lista estiver selecionado o item Angola.
Delimitador - Caracter(es) utilizado(s) para fazer a separação das múltiplas opções dentro do campo da tabela. Caso não seja informado, o delimitador padrão será ponto e vírgula ( ; ) .
Colunas - Permite informar a quantidade de colunas para exibição dos itens do checkbox.

Múltiplos Valores (Posição)

Permite armazenar diversas informações em uma única string do campo selecionado. Para que estas informações sejam incluídas 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 Masculino, Casado e Estudar.

Figura6: Configuração do lookup Múltiplos Valores (posição)

Label - Texto que será exibido para o item da lista no objeto checkbox.
Valor - Atributo que corresponde ao valor que será armazenado na tabela. Por exemplo, o valor M será incluído no campo da tabela quando na lista estiver selecionado o item Masculino.
Negativo - Valor a ser gravado na tabela caso nenhum valor de uma determinada posição seja selecionada.
Início - Posição inicial na string onde a informação será gravada. A primeira posição é sempre 1.
Tamanho - Quantidade de bytes que a informação ocupará na string.
Colunas - Permite informar a quantidade de colunas para exibição dos itens do checkbox.

Múltiplos Valores (Binário)

Permite armazenar diversas informações em um valor inteiro no campo selecionado.

Como exemplo usaremos a seguinte lista (apesar de não ser informado na interface de inclusão de valores na lista, cada item possui um valor atribuído 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 armazenar os dados é realizado uma soma do número decimal. Veja os exemplos abaixo.

Exemplo1: Se fossem selecionados as opções Esportes e Cultura o número armazenado seria 3.

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

1 (Esportes) + 2 (Cultura) = 3

Exemplo2: Se fossem selecionados as opções Esportes, Lazer e Leitura o número armazenado seria 13.

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

1 (Esportes) + 4 (Lazer) + 8 ( Leitura) = 13

Figura7: Configuração do lookup de edição Múltiplos Valores (Binário)

Label - Texto que será exibido para o item da lista no objeto checkbox.
Colunas - Permite informar a quantidade de colunas para exibição dos itens do checkbox.

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. Aparecerão as definições existentes no ScriptCase e as listas salvas pelo usuário.

Recarregar formulário após alteração do valor - Com esta opção selecionada, o formulário será recarregado quando houver mudança do item selecionado no objeto Checkbox.
Opção marcar todos - Exibe uma opção para marcar e outra para desmarcar todos os itens.

Exibir valor original e lookup - Exibe o valor do campo e o valor retornado pelo lookup.

Valor lookup

Valor original e lookup
Separados por - Define que caracter será usado para separar o valor do campo e o valor retornado pelo lookup. Só é necessário preencher este campo se a opção Exibir valor original e lookup estiver selecionada.

PROCESSAMENTO AJAX

Permite definir o(s) campo(s) que será(ão) recarregado(s) após a seleção de um valor do campo (onChange). Por exemplo: um campo do tipo select com uma lista de estados, e outro campo do tipo select com uma lista de cidades. Ao selecionar um estado será recarregada a lista de cidades.

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.

Figura: Interface de definição de CSS a nível de campo.

CSS do Título

Atributos:

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

Atributos:

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

Atributos:

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

Este recurso permite que seja documentado instruções para utilização da aplicação gerada, isto é, ajuda ao Usuário final a entender melhor as Regras de Negócio do Sistema e a melhor maneira de operar o Sistema.

Figura1 Configuração da Ajuda utilizando Pop-UP.

Atributos:

Descreva Ajuda - Permite a inclusão de um texto que será apresentado quando o usuário posicionar o mouse sobre o campo.
Tipo do Help:
- Popup - Ao escolher o tipo popup, será exibido o ícone de ajuda ao lado do campo; que ao ser clicado, exibirá o que foi informado no atributo Descreva Ajuda.
- Hint - Ao passar o cursor do mouse sobre o campo, aparecerá a ajuda descrita no campo Descreva Ajuda.
- Texto - Ao lado do campo aparecerá o texto contendo a ajuda que foi descrita no campo Descreva Ajuda.


Campo sem usar atributo label		Campo usando atributo label