Formulário

Por ser a principal porta para a manipulação dos dados das entidades de um banco de dados, é o objeto no qual é disponibilizada uma Barra de ferramentas, componentes (em abas) e ações (independentes das abas do formulário) que, após serem configuradas, são disparadas no momento: da execução de transações (inserção, alteração, exclusão e seleção);da abertura ou fechamento do formulário; e do pressionamento de tecla, estando o formulário com o foco. Todos os Componentes que podem ser utilizados nos formulários são disponibilizados na aba Formulário da Paleta Objetos, sendo necessário que um formulário seja aberto para que apareçam. Para visualizar um exemplo de criação de formulário acesse o tópico Criando um Formulário.

Abas do Formulário

Todo novo formulário é criado com duas abas, a aba Cadastro e a aba Localizar. Ao clicar com o botão direito do mouse sobre a área delas, pode-se:

• adicionar uma nova aba - a nova aba aparece à direita da aba na qual estava o ponteiro do mouse no momento da efetuação do clique com o botão direito do mouse;

• renomear a aba - aparece uma tela para que o usuário possa definir o novo nome da aba;

• e excluir a aba: é excluída a aba na qual estava o ponteiro do mouse no momento da efetuação do clique com o botão direito do mouse.

Cabe lembrar:

• havendo apenas duas abas no formulário (as abas Cadastro e Localizar), não será possível possível excluir a aba Cadastro (ou outro nome dado pelo usuário à aba), pois, obrigatoriamente, todo formulário deve ter pelo menos uma aba além da aba Localizar;

• não é possível excluir nem renomear a aba Localizar.

A aba Cadastro é a aba utilizada para a disposição dos componentes que serão ou não associados aos campos da fonte de dados do formulário. Sua área é composta por pequenos pontos separados um do outro por um espaçamento (vertical e horizontal) de oito pixels, os quais podem ser observados para efeito de posicionamento dos componentes.

A aba Localizar (no Maker) é composta por duas colunas:

• Campos de pesquisa - são os campos (componentes Caixa de Texto) que disponibilizarão ao usuário a possibilidade da execução de consultas na fonte de dados associada ao formulário. E acima de cada um destes campos há uma caixa de texto na qual se pode escolher o operador que deverá ser considerado durante a execução da consulta (se o dado associado ao campo for do tipo número (todas as variações), então aparecerão os operadores =, >, <, >=, <= e Iniciando Com; se o dado associado ao campo for do tipo texto (todas as variações), então aparecerão os operadores Contendo, Iniciando Com, Terminando Com e Igual);

• Campos para grade - são as colunas que mostrarão o resultado da execução das consultas feitas na fonte de dados associada ao formulário.

 Abaixo consta uma imagem que demonstra a aba Localizar de um formulário.

Os componentes pertencentes a aba Localizar são:

• Buscar - é executada a consulta, observados antes os parâmetros de pesquisa definidos nos Campos de pesquisa;

• Buscar Todos - cancela a listagem filtrada por uma pesquisa, reexibindo todos os registros;

• Consulta Avançada - oculta os Campos de Pesquisa e habilita a área Consulta avançada com outras opções de filtro:
   

• Limpar consulta - limpa uma consulta criada pelo componente Adicionar Novo Campo à Consulta;

• Aplicar consulta - executa a consulta;

• Carregar consulta salva - abre uma consulta que foi salva;

• Adicionar novo campo à consulta - adiciona um campo para uma consulta. Mostra uma tela para escolher o campo de pesquisa;

• Salvar consulta - salva uma consulta. É necessário especificar um nome para identificar a consulta salva;

• Remover campo - remove um campo da consulta.

A tabulação da aba Localizar ocorre entre os campos do filtro e o tipo de filtro. Dentro da aba Localizar, caso o usuário queira ir para o registro da aba Cadastro, é só pressionar a tecla Page Down em qualquer campo do filtro e, em seguida, selecione o registro e pressione a tecla Enter.

Observações:

• Caso o formulário esteja com a propriedade Entrar como pesquisa marcada como Sim, o botão Ultimo Registro da aba de Navegação do formulário desaparecerá.

• Caso a quantidade de abas ultrapasse o tamanho do formulário, para visualizá-las no Webrun é necessário aumentar a largura do formulário.

• A pesquisa da aba localizar é realizada na consulta que está vinculada nas definições do formulário. Com isso, caso o desenvolvedor tenha modificado a consulta do formulário, ele terá que criar sua própria aba localizar.

• Não é possível filtrar um campo que possua conteúdo do tipo lógico através da aba localizar, para isso será necessário criar um case dentro da consulta SQL.

• As pesquisas realizadas na aba localizar são feitas utilizando a cláusula where do banco, logo se a mesma contiver caracteres especiais eles serão tratados no SQL do banco de dados utilizado.

Exemplo: Ao utilizar o "_"(underline) em uma pesquisa, a consulta retornará todos os registro pois, o "_"(underline) representa qualquer caracter.

Nota: Caso queira realizar uma busca onde o caracter pesquisado seja por exemplo o (_) usa-se o caracter de escape \.

Por exemplo:
 

select* from fr_acao where aco_nome like '%\_%';

ou

select* from fr_acao where aco_nome like '%\%%';

Dessa forma, o banco tratará o caracter especial como se fosse qualquer outro.

• Não é possível filtrar subselects na aba localizar. Para tal deverá ser feito um join entre as tabelas utilizadas.

• Limite a quantidade de Campos de Pesquisa à largura do formulário, pois ela é estática. Sendo assim, se houver mais campos que os que a largura do formulário suportar, estes não aparecerão.

• O botão não atualiza a grade da aba Localizar. Quando acionado esse botão, é apresentada a mensagem: "Você deve sair da guia Localizar";

• Caso o usuário crie uma aba no Maker e não cole nenhum componente nela, esta não aparecerá ao ser aberto o formulário.

• Existe uma área reservada acima do componente grade editável ou não editável, portanto caso seja posicionado algum componente nesta área o mesmo não poderá ser acessado.

• Para um maior desempenho, os dados incluídos no formulário serão sempre inseridos no final da lista da aba localizar, portanto, mesmo que a fonte de dados do formulário esteja na ordem descendente a lista da aba localizar só será reordenada após atualizar o formulário ou clicar buscar todos.

• Ao serem pesquisados registros na aba Localizar de um formulário aberto no Webrun, não haverá sucesso ao tentar digitar a parte da hora da data num campo do tipo datetime ou timestamp, pois os tipos citados armazenam em sua estrutura além da data, hora, minutos, segundos e milisegundos.

• Na pesquisa avançada não se deve utilizar o mesmo campo mais de uma vez para realizar o filtro.

Preservando valores dos registros na aba consulta: não permitir scripts:

Por padrão, a grade na aba consulta permitirá scripts e tags HTML (mas o texto da tag aparece). Para desabilitar, use a propriedade avançada DesabilitarScriptAbaLocalizar para não escapar valores dos registros na aba de consulta.

Barra de Ferramentas da Grade de Listagens

• Listagem - gera um relatório simples, via browser, com todos os campos da Grade de Listagem;

• Exportar para HTML - gera um relatório via browser no formato HTML com todos os campos da Grade de Listagem;

• Exportar para XML - gera um relatório via browser no formato XML com todos os campos da Grade de Listagem;

• Exportar para TXT - gera um relatório via browser no formato Texto com todos os campos da Grade de Listagem;

• Gerenciar campos da grid - gerencia os campos da grade da aba Localizar, ocultando/exibindo e ordenando visualmente;

• Remover ordenação do grid - remove todas as ordenações da grade (a ordenação ocorre quando executa clique duplo no rótulo da coluna da grade da aba localizar: quando executa clique duplo, ocorre a ordenação ascendente do conteúdo alfanumérico ou numérico. Quando executa pela segunda vez, ocorre a ordenação descendente);

• Importar arquivos - ativa um Assistente de importação de dados para a origem do formulário (Esta funcionalidade foi depreciada):
   

Observação: Esta importação é somente para dados do tipo texto (String) e data. Não é possível a importação de dados a serem inseridos em campos de outros tipos que não seja string ou data.

Componentes

Na paleta, temos os componentes que poderão ser utilizados no formulário. Estes componentes aparecem quando entramos no modo de edição de formulário. Cada componente possui propriedades específicas.

O Maker utiliza alguns componentes já conhecidos em ambientes de desenvolvimento, tais como: Lista, Caixa de Texto, Texto, Texto Longo, Botão, Grade, Lista dinâmica, Opções, Imagem, Moldura, SubFormulário, Check.

O Maker possibilita a construção de sistemas apenas arrastando componentes e arrumando-os nos formulários.

Para mudar a posição do componente em relação ao limite esquerdo e superior do formulário, deve-se proceder da seguinte forma:

1. Abra o formulário que deseja editar;

2. Clique com o botão direito do mouse no campo do tipo Caixa de Texto;

3. Selecione em Propriedades a opção PosiçãoX para 25;

4. Selecione em Propriedades a opção PosiçãoY para 98;

5. Utilize controles de alinhamento para agilizar a organização dos componentes

À medida que se edita a propriedade, a nova configuração é aplicada automaticamente.

A atualização do formulário ocorrerá no navegador, Modo Projeto do sistema em uso no Webrun.

Todo Componente. possui Eventos. Esses eventos podem estar habilitados ou não: "Ao Clicar", "Ao Entrar", "Ao Sair", "Ao Modificar", são eventos disponíveis para cada componente. A ação que ocorrerá quando determinado evento for acionado depende do fluxo associado.

Menu pop-up ativado da Área do Formulário

Este menu permite acessar uma série de recursos, a partir do clique direito do mouse na área do formulário:

• Propriedades e Eventos

• Alinhamento

• Edição

• Controles

• Novo Componente

Clicando com o botão direito do mouse na aba do formulário, aparecem as opções abaixo:

• Inserir - insere uma nova aba;

• Renomear - renomeia a aba;

• Excluir - exclui uma aba criada;

• Assistente - abre a tela Assistente de Criação de Novo Formulário;

• Criar tabela... - abre a tela Assistente de banco de dados para criar tabela;

• Reorganizar Componentes - reorganiza os componentes do formulário alinhando à margem esquerda do formulário.

Procedimento para visualizar a alteração de tamanho do formulário

Para visualizar a alteração de tamanho de um formulário, é necessário recarregar o formulário e o menu do sistema. Para isso, siga os procedimentos abaixo:

1. Abra o formulário com o tamanho alterado.

2. Utilize a combinação de teclas Ctrl + F5 para atualiza-lo (Limpar Cache).

3. Feche o Formulário.

4. Recarregue o Menu do sistema.

5. Abra o formulário novamente (Através do menu).

Comportamento do Formulário

O formulário possui alguns comportamentos específicos, são eles:

• Ao abrir um formulário, cuja tabela tenha sido excluída, uma mensagem será apresentada informando que ocorreu um erro ao tentar carregar o formulário e a operação será abortada.

• Caso um formulário tenha resolução superior a suportada pelo monitor, o mesmo poderá apresentar-se de forma incorreta.

• Os eventos Ao Entrar, Ao Navegar, Ao Pressionar Tecla, Ao Sair não se aplicam quando o formulário está em um subform.
• A opção "Remover controles existentes no formulário" só é mostrando quando abre a tela Assistente de Criação de Novo Formulário ao clicar com o botão direito do mouse sobre a aba do formulário e escolhendo a opção Assistente. Com a opção ativada, o formulário é reestruturado conforme os campos marcados na grade da tela desfazendo toda estrutura existente no formulário;
• Configurações feitas na Área de Trabalho do Maker (plano de fundo do projeto, formulários associados a fontes de dados de conexões adicionais, dentre outros) não são consideradas na pré-visualização, sendo necessário que o usuário reinicie o sistema para que passem a ser consideradas.

Observações:

• Não pode ser utilizado "union" no sql vinculado ao formulário. Pode ser contornado criando uma view.

• A tecla F9 permite pré-visualizar o formulário. Caso sejam pressionadas as teclas Ctrl + F9 no Maker, abrirão o projeto no Webrun;

• Quando o Assistente for aberto com um clique com o botão direito do mouse na área das abas do formulário, não serão consideradas as configurações preexistentes, ou seja, serão selecionados todos os campos da tabela para que possam ser aplicados no formulário.

• Ao ser utilizado um campo obrigatório e o mesmo não possuir nenhuma descrição, será exibida a seguinte mensagem: O campo "" é obrigatório.
  

Caso este tópico não tenha comentário satisfatório, envie e-mail para [email protected]