Por meio do Person também é possível personalizar consultas. Aqui será apresentado como usar essa funcionalidade. 

Acessos

Para acessar a ferramenta de consultas personalizadas há 3 formas:

• Menu Tabela e o sub menu Consultas Personalizadas: Tabela > Consultas Personalizadas;

• Atalho do teclado através das teclas: CTRL, ALT e C pressionadas ao mesmo tempo;

• Clique com o botão direito do mouse sobre a tabela e escolha a opção Consultas Personalizadas no menu suspenso que será apresentado, conforme apresentado abaixo:

Open

O formulário Consultas Personalizadas será apresentado:

Open

Criando uma nova Consulta Personalizada

Para habilitar o botão de inclusão de consultas personalizadas, digite o nome da tabela de testes, U_DOCUMENTO, no campo Tabela e em seguida pressione o botão Pesquisar, conforme exemplo abaixo:

A metade inferior do formulário ficará habilitada e mostrará que a pesquisa não retornou resultados:  

Para iniciar o processo, pressione o botão Incluir:

O formulário mudará para o seguinte:

Observe que o formulário já aparece com o início de um "script" SQL onde será definida a consulta personalizada. Será utilizado o "script" abaixo para manter o exemplo da tabela U_DOCUMENTO e seus campos já criados na segunda rotina deste material: 

IMPORTANTE: O carácter ? no “script” acima representa onde os parâmetros da busca serão inseridos. 

Após digitar/colar o "script" acima, substituindo o código inicial “select * from”, pressione o botão Examinar SQL no formulário:

Os campos Nome da Tabela, Descrição e Uso serão preenchidos automaticamente. Se for necessário, melhore a Descrição de acordo com a necessidade. Observe que existe um botão chamado “Parâmetros” no formulário. É por meio dele que a consulta receberá seu parâmetro de busca.

Descrição dos campos principais:

Após o preenchimento dos parâmetros da consulta, baseado no exemplo deste material, o formulário ficará da seguinte maneira:

No formulário acima, no campo SQL, nota-se que o “script” inicial já está completo, com a substituição do carácter ? pela condição construída a partir da edição dos parâmetros da consulta, explicado abaixo:

• WHERE:

  • É o comando que inicia a cláusula de condição dentro dos “scripts” SQL; 

• DOC.DESCDOCUMENTO:

  • É o campo que servirá como alvo na consulta, ou seja, o dado a ser pesquisado deve fazer parte deste campo; 

• :CONTAINING:

  • Indica que o dado a ser consultado deve estar contido no valor do campo a ser pesquisado; 

Explicando os Códigos de Operadores aritméticos e lógicos

Testando a consulta personalizada

Para o teste da consulta personalizada, será utilizado o aplicativo Gerenciador de Sistemas: 

Observação: A tela composição inicial do Gerenciador de Sistemas pode variar de acordo com a configuração individual do usuário.

Iniciando os testes com a Consulta Personalizada

Para acessar a consulta personalizada, alvo deste material, escolha o menu Cadastros e, em seguida, o sub menu Minhas Tabelas e, por fim, a tabela foco deste material:

Será apresentado o formulário Filtrar Tabela para gravação de documentos abaixo, baseado configurações feitas dos parâmetros da consulta:

Os elementos configurados nos parâmetros da consulta estão todos presentes no formulário: O rótulo da consulta (Display Label) e a condição “Contém”.

O dado a ser consultado será usado para comparação com a descrição dos documentos armazenados na tabela. Se a expressão indicada neste campo estiver contida em um ou mais registros da tabela, estes registros serão filtrados e apresentados na próxima tela.

Neste caso específico, a tabela ainda não possui registros gravados. Assim, faz-se necessário a inclusão desses registros. Como não existem dados na tabela, é possível pressionar o botão OK sem informar qualquer dado a ser consultado. O formulário Consulta: Tabela para gravação de documentos será apresentado, como se espera, sem dados retornados na pesquisa:

Inserindo dados na tabela personalizada

Para incluir novos registros na tabela personalizada, utilize o atalho Ctrl+Ins ou pressione o botão de inclusão:

O formulário Tabela para gravação de documentos será apresentado. Este formulário tem as mesmas opções e comandos dos demais formulários de inclusão de dados dos sistemas: 

Os campos a serem preenchidos são do tipo Texto, Arquivo (BLOB) e Data. Os campos do tipo texto são simples, bastando digitar o conteúdo que se quer.

O campo Arquivo (BLOB) é um campo que aceita a inclusão direta de um arquivo no banco de dados. O tamanho máximo do arquivo é de 2MB. Este campo possui três botões auxiliares, cada um com uma função específica, a saber: 

O campo de Data apresenta um calendário padrão das aplicações VIASOFT para que a data seja escolhida. Caso a data seja a do momento da gravação dos dados na tabela, bastará pressionar o botão Hoje do calendário. 

O campo Estabelecimento faz parte da tabela FILIAL para fins de pesquisa a Razão Social, e foi incluído na rotina 2. 

Um duplo clique na Razão Social escolhida preencherá o campo Estabelecimento no formulário “Tabela de gravação de documentos”.

Após preenchimento do formulário, para salvar, pressione o botão salvar, ou use o atalho CTRL+S.