Formulário

Na tela 508 – Gerador de Telas, é possível criar um Formulário. O formulário é uma tela que permite a inclusão e alteração de registros da tabela definida na consulta.

Configuração:

Para a criação de um Formulário, é necessário incluir um novo registro na tela 508 – Gerador de Telas, informando o tipo Formulário. Após definir o tipo, deve-se criar um SQL na aba Comando, informando a tabela que será utilizada e os campos que deverão ser exibidos no cadastro.

Exemplo de SQL:

SELECT NIVEL, CAPTION, NOME_BPL, NOME_FORM 
FROM ACESSO_MENU

Após a criação do SQL, deve-se acessar a aba Campos. Nessa aba é possível consultar todos os campos retornados pelo SQL por meio do botão Buscar, que irá listar automaticamente todos os campos disponíveis.

Entre os campos listados, é necessário configurar:

  • Deve existir ao menos um campo definido como chave, que será utilizado como identificador do registro. Além disso, quando o campo estiver configurado como chave, não possuir consulta de tabela associada e estiver vinculado à tabela Codigos_001, o sistema realizará a geração automática de um valor sequencial para esse campo no momento da inserção do formulário.

  • Um campo requerido, que será obrigatório para preenchimento.

Além disso, os campos que devem aparecer para o usuário na aba Acesso precisam estar com a flag Acesso marcada.

Formulário com Capa e Detalhe

É possível configurar um Formulário utilizando uma tabela principal e uma tabela auxiliar, permitindo realizar a manutenção de registros relacionados.

Para utilizar essa configuração, a tabela principal deve ser informada no Comando Principal e a tabela auxiliar no Comando Auxiliar.

Na aba Campos, os campos da tabela principal devem ser configurados com o tipo de listagem Cabeçalho, enquanto os campos da tabela auxiliar devem utilizar o tipo de listagem Detalhe.

Para realizar o relacionamento entre as tabelas, deve ser utilizado um campo existente em ambas, que deverá possuir o mesmo nome no banco de dados.

No formulário, os campos configurados como Cabeçalho serão apresentados na parte superior, enquanto os campos Detalhe serão exibidos em uma tabela abaixo, permitindo a inclusão dos registros relacionados.

Os campos configurados como Detalhe não serão considerados nas consultas realizadas na aba Acesso.

Configuração de campos do tipo Opções:

Para campos que utilizam opções, é necessário preencher a tabela Opções, informando:

  • Código da opção

  • Nome que será apresentado ao usuário

  • Valor que será gravado no banco de dados conforme definido no SQL.

Para que as opções funcionem corretamente no SQL, é necessário que a consulta esteja configurada para contemplar os parâmetros informados. Seguem exemplos de configuração:

Exemplo 1:
AND (STATUS = :STATUS OR STATUS IN ('P','N','F'))

Exemplo 2:
AND (ENT.TIPO = CAST(:TIPO AS VARCHAR(2)) OR CAST(:TIPO AS VARCHAR(2)) = '**')

Funções

VUSUARIOCODIGO

No SQL é possível utilizar o parâmetro “VUSUARIOCODIGO” que retorna o usuário logado no sistema, possibilitando utilizar o mesmo como filtro na condição do WHERE.