Feedback Imprimir

Select

Configurações Gerais

Interface de configuração do campo select.

  • Tipo do dado : Definir o tipo de aplicação no campo. Campos de moeda são formatados de acordo com as regras de formatação de moeda.
  • Label Filtro : Define o título do campo na aplicação. Por exemplo: se o campo estiver definido no banco de dados como nm_nome fica mais claro o entendimento se o mesmo for simplificado para Nome. Ou seja, o label é o apelido do campo na camada de aplicação.
  • Marca d’agua: Exibe uma marca d’agua no campo.
  • Use Select2: Essa opção permite a utilização do novo componente para selecção de dados, permitindo pesquisas na caixa de seleção.
  • Quantidade de caracteres : Quantidade de caracteres por linha dentro da coluna.
  • Tamanho Máximo : Tamanho máximo do campo
  • Tipo SQL : Tipo do campo no banco de dados.

Configuração do Filtro

Interface de configuração do filtro do campo select.

  • Texto entre valores : Texto que aparecerá entre os valores.
  • Submeter no Onchange : Permite quando ativada, submeter o filtro quando houver alterações no campo.
  • Exibir Condição : Permite quando ativada exibir ou não a condição do filtro, a mesma só funcionará se o filtro tiver ao menos uma opção.

Lookup de Filtro

Forma utilizada para disponibilizar ao usuário final uma lista de valores onde poderão ser selecionados os itens que serão utilizados no formulário. Por exemplo, para um campo sexo no banco de dados com valores M ou F pode ser apresentado como Masculino ou Feminino ou de forma dinâmica, ter esses valores recuperados de uma tabela do banco de dados.

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

  • 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). Seleção do tipo de Lookup. Seleção do tipo de Lookup.

    • Lookup de Edição - Automático

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

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

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

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

      • Múltiplos Valores : Selecionando Sim, permite que sejam armazenados vários valores no campo da tabela, separados por um caracter definido em Delimitador.

        Seleção de multiplos valores em campo select.

        • Delimitador : Define o caracter usado para separar os valores selecionados no campo do formulário. Só preencher este campo se Múltiplos Valores estiver selecionado. Caso não seja informado, o delimitador padrão será ponto e vírgula ( ; ) .
      • Altura : Permite definir a altura do objeto select.
      • Usar Título / Negação : Permite exibir uma linha de título no objeto select (atributo Título) associado a um valor informado manualmente (atributo Valor Negativo).

        Seleção de utilização do título/negação de campos select.

        • Valor Negativo : Valor a ser gravado no campo quando for selecionado a linha de título do objeto select.
        • Título : Texto exibido na linha de título do objeto select.
      • 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 select.
      • Exibir valor original e lookup : Exibe o valor do campo e o valor retornado pelo lookup.

        Exibição de valor originial do 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.
      • Criar Ligação : Permite criar uma ligação para outro formulário possibilitando a manutenção da lista exibida no campo select. Após a manutenção, o objeto select é atualizado automaticamente.

        Exibição de ligação do lookup automático.

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

      Interface Lookup de Edição Manual. Interface Lookup de Edição Manual.

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

          Interface de configuração de Lookup de edição manual Configuração do lookup de edição Simples Valor

          • Label : Texto que será exibido para o item da lista no objeto select.
          • Valor : Atributo que corresponde ao valor que será armazenado no campo da tabela. Por exemplo, o valor M será incluído no campo da tabela quando na lista estiver selecionado o item Masculino.
          • Default : Com esta opção marcada o item já virá selecionado quando o formulário estiver em modo de inclusão.
          • Altura : Define uma altura(linhas) para o objeto select.
        • 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 Esportes, Cinema e Turismo selecionada no formulário será gravada como E;C;T caso o delimitador seja ; (ponto e vírgula).

          Interface de configuração de Lookup de edição manual Configuração do lookup de edição Múltiplos Valores (delimitador)

          • Label : Texto que será exibido para o item da lista no objeto select.
          • Valor Atributo que corresponde ao valor que será armazenado no campo da tabela. Por exemplo, o valor Cserá incluído no campo da tabela quando na lista estiver selecionado o item Cinema.
          • Delimitador Caracter(es) utilizado(s) para fazer a separação dos múltiplos valores dentro do campo da tabela. Caso não seja informado, o delimitador padrão será ponto e vírgula ( ; ) .
          • Altura Define uma altura (linhas) para o objeto select.
        • 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: Se fossem selecionados Masculino, Casado e Estudar, no banco de dados seria armazenado o seguinte valor MCED.

          Interface de configuração de Lookup de edição manual Configuração do lookup Múltiplos Valores (posição)

          • Label : Texto que será exibido para o item da lista no objeto select.
          • Valor : Atributo que corresponde ao valor que será armazenado no campo da 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.
          • Altura : Define uma altura (linhas) para o objeto select.
        • 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 no campo da tabela 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 no campo da tabela 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

          Interface de configuração de Lookup de edição manual Configuração do lookup de edição Múltiplos Valores (Binário)

          • Label : Texto que será exibido para o item da lista no objeto select.
          • Altura : Define uma altura (linhas) para o objeto select.
      • 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.
      • Usar Título / Negação : Permite exibir uma linha de título no objeto select (atributo Título) associado a um valor informado manualmente (atributo Valor Negativo).

        Interface de configuração de valor negativo em lookup.

        • Valor Negativo : É possível informar um valor para ser armazenado no campo da tabela quando a opção Usar Título / Negação estiver selecionada.
        • Título : Texto exibido na linha de título do objeto select.
      • 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 select.
      • Exibir valor original e lookup : Exibe o valor do campo e o valor retornado pelo lookup.

        Exibição de lookup com valor original. Exibição de lookup com valor original.]

      • Separados por : Define o caracter que será usado para separar o valor do campo que está sendo definido e o valor retornado pelo lookup. Só é necessário preencher este campo se a opção Exibir valor original e lookup estiver selecionado.

Lookup de Edição - Valor Atual

Este lookup é usado para listar todos os valores do campo selecionado.

Este lookup irá aplicar um “distinct” em sua query SQL.

Processamento Ajax

Interface de configuração do processamento ajax. Interface de configuração do 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ções de Visualização

Permite definir valores de CSS para o campo individualmente. Desta forma, por exemplo, podemos destacar um campo dos demais na aplicação.
As propriedades CSS do campo, quando alteradas, são adicionadas à uma classe criada automaticamente pelo Scriptcase para cada campo da aplicação.

As configurações individuais do CSS dos campos, quando informadas, sobrepõem as configurações do tema(CSS das Aplicações (Temas)) selecionado para a aplicação.

As configurações de visualização são divididas em três blocos de propriedades, estes blocos são:

CSS do Título

Que possibilita a alteração das propriedades do CSS da Label(Título) do campo.

No exemplo abaixo, podemos visualizar a diferença nas configurações do titulo do campo.
Enquanto os campos Fornecedor e Categoria possuem a mesma formatação, herdada do tema da aplicação, o campo Avaliação do Produto possui uma formatação diferente dos demais, proveniente das alterações realizadas no CSS do campo.

Alteração de CSS da label do campo

CSS do Campo

Que altera as propriedades do CSS da <td> onde o Objeto Input(onde informamos os dados para inserção em um formulário) está posicionado. Na imagem abaixo, podemos visualizar onde as alterações são aplicadas.

Campo com alterações nas propriedades do CSS do Campo, alterando a cor de fundo e o alinhamento horizontal

Campo com alteração no CSS

CSS do Objeto Input

Que altera as propriedades do CSS no Objeto Input do campo, onde digitamos os dados em um formulário.

Campo com alterações nas propriedades do CSS do Objeto Input, alterando a cor de fundo e cor da fonte do input

Campo com alteração no CSS

Propriedades CSS

As opções de configuração disponíveis são basicamente as mesmas para cada um dos blocos de configuração mencionados acima.

Interface de configuração da visualização do titulo no formulário

Descrição dos atributos da configuração disponíveis

Fonte

Altera a fonte do texto de acordo com as fontes selecionadas, utilizando a propriedade font-family.

Nesta opção, disponibilizamos alguns tipos de fontes(conforme imagem abaixo).
Lista de fontes disponíveis na interface de configuração

Tamanho

Altera o tamanho da fonte do texto utilizando a propriedade font-size na classe do campo.

Devemos selecionar o valor disponível em nossa lista, a medida utilizada para esta propriedade é o pixel.

Cor da fonte

Define a cor da fonte utilizado a propriedade color na classe do campo.

Cor de fundo

Define a cor de fundo, utilizado a propriedade background-color na classe do campo.

As cores que serão utilizadas nas duas propriedade de cores listadas acima, Cor da fonte e Cor de fundo, podem ser informadas por meio da paleta de cores - Ícone da paleta de cores - disponível ao lado do campo ou informado manualmente os valores nos formatos aceitos que são: Hexadecimal, RGB, RGBA, HSL, HSLA ou o Nome da Cor.

Paleta de Cores
Ao clicar no ícone da paleta de cores - Ícone da paleta de cores - ao lado do campo, uma janela será aberta com algumas cores predeterminadas.

Ao selecionar uma das cores, será inserido um valor no formato hexadecimal(HEX), que representa a cor escolhida.

Hexadecimal
Sigla para hexadecimal, este código é composto do sinal de cerquilha (#) mais seis dígitos.
Os dois primeiros definem a intensidade da cor vermelha; os dois do meio dizem respeito ao verde e os dois últimos, ao azul.

Representação de cores

Este código é representado por #000000.

Nesse sistema de representação o #000000 representa a cor preta e o #ffffff representa a cor branca.

RGB / RGBA Sigla que representa Vermelho (Red), o Verde (Green) e o Azul (Blue).
Este código é representado por RGB(255,255,255).

Representação de cores

Os três primeiros números definem a intensidade da cor vermelha; os três números do meio dizem respeito ao verde e os três últimos números representam o azul.

HSL / HSLA

Representação de cores

Nome das Cores
Devemos informar o nome da cor que desejamos utilizar. Este nome deve ser informado em inglês e a cor deve está dentro da lista de cores suportadas pelo navegador que iremos utilizar.

Exemplo: Informando nome da cor

Alguns sites disponibilizam uma lista de cores com cada um dos valores citados acima.

especificar as cores de diferêntes maneirasutilizando diferentes maneiras de atribuição de valores

Esta propriedade possibilita

É possível também informar valores diretamente no campo, sem a utilização da nossa paleta de cores.
Esta propriedade permite especificar as cores de diferentes maneiras de se atribuir valores para as propriedades CSS que admitem cores

Negrito

Permite aplicar o tipo negrito na fonte.

Sublinhado

Permite aplicar o tipo sublinhado na fonte.

Estilo da Borda

Define o estilo da fonte.

Collapse da Borda

Define o collapse da borda.

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

Não disponível no CSS do Objeto Input

Largura

Para definir a largura do título.

Altura

Para definir a altura do título.

Configurações 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.

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.