Apêndice VI: Construção SQL Campo Consulta do Formulário

1273 02/02/2023

CONSTRUÇÃO SQL CAMPO CONSULTA DO FORMULÁRIO

Para os formulários SmartShare e 2.0 é possível configurar campos do tipo consulta, sendo que, a construção dos comandos SQL é realizada baseada em tags de forma específica para o sistema SmartShare, podendo utilizar como base das consultas cláusulas SELECT e WHERE.

Abaixo será apresentada como a construção dos comandos SQL deverá ser realizada:

Usados na cláusula SELECT

  • Coluna: Este tipo de SELECT serve apenas para auxiliar na identificação dos registros, funcionando como uma apresentação da coluna que se deseja na tela.
    SELECT <coluna title="Título da coluna" procura="true" name="nome do campo" primeiraordem="true" direcaoordem= "ASC" />

Segue um breve detalhamento do SELECT dado como exemplo acima:

Title: Especificar o nome da coluna a ser listada;

Procura: Informar se será possível realizar pesquisa através deste campo (true/ false);

Name: Informar o nome do campo na base de dados que possui a informação desejada (cd_usuario, nmusuario);

Primeiraordem: Informar se a lista com o resultado da consulta inicialmente será ordenada por este campo;

Direcaoordem: Informar a direção ascendente (ASC) ou descendente (DES) de ordenação dos dados retornados no zoom de resultado;

  • RetColuna: Diferente da tag <coluna>, esta irá para o campo consulta do formulário através da propriedade target.
    SELECT <retcoluna title="Título da coluna" procura="true" target="código do campo destino" name="nome do campo" />

Target: Indicar para qual campo será retornado o conteúdo do registro, ou seja, retornará o campo selecionado configurado no target.

  • Retorno: Nesta tag o campo não aparecerá na lista de registros da tela de consulta, apenas retornará o conteúdo deseja para o formulário no processo, como se a informação estivesse escondida na lista de registros, mas que irá cumprir a tarefa de retorno de informação para o formulário.
    SELECT <retorno target="código do campo destino" name="nome do campo">
  • MultRetColuna: Esta tag permite o preenchimento dinâmico de uma tabela através de uma unica consulta.
    SELECT <multretcoluna title="Título da coluna" procura="true" target="código do campo destino dentro da tabela dinâmica" name="nome do campo" />

Para o correto funcionamento do MultRetColuna deve ser considerado:

  • A tabela deve ser dinâmica.
  • O campo consulta a ser utilizado deve estar fora da tabela para o retorno dos valores.
  • A tag não retorna valores para o mesmo campo consulta configurado.
  •  Os campos dentro da tabela devem ser do tipo texto ou consulta.
  •  A tag multretcoluna não retorna valores para campos fora de tabela.

Usados na cláusula WHERE

Na cláusula WHERE é possível utilizar campos que estão presentes no formulário para realizar o filtro da consulta.

'<campo id="código do campo" />'

Id: o código do campo do formulário que será utilizado para realizar o filtro.

Quando a consulta possuir uma Sub-Consulta com a cláusula WHERE, deve ser colocado um WHERE na consulta principal também, mesmo que seja WHERE 1 = 1.