Relatório

Na tela 508 – Gerador de Telas, é possível criar um Relatório. O relatório é uma tela que permite uma consulta personalizada pelo cliente.

Configuração:

Para a criação de um Relatório, é necessário incluir um novo registro na tela 508 – Gerador de Telas, informando o tipo Relatório. Após definir o tipo, deve-se criar um SQL na aba Comando, informando as informações desejadas na consulta

Exemplo de SQL:

SELECT CODCLI, NOME, FANTASIA FROM {ENTIDADE} WHERE CODCLI = :CODCLI

Funções:

  • VUSUARIOCODIGO:
    No SQL é possível utilizar o parâmetro VUSUARIOCODIGO, que retorna o código do usuário logado no sistema. Esse parâmetro pode ser utilizado como filtro em condições WHERE, permitindo que a consulta retorne informações relacionadas ao usuário que está acessando o sistema.

  • ‘:’ (Dois pontos):
    O caractere ‘:’ é utilizado para definir campos que serão consultados retornando apenas um único registro.

  • ‘!’ (Exclamação):
    O caractere ‘!’ é utilizado para definir campos que podem consultar vários registros, sendo normalmente aplicado em consultas utilizando a cláusula IN no SQL.

  • ‘{}’ (Chaves):
    As chaves ‘{}’ são utilizadas junto ao nome de uma tabela para indicar que a consulta deve considerar todas as empresas relacionadas a essa tabela.

Campos:

Para buscar os campos disponíveis para consulta, deve-se utilizar o botão Buscar. Também é possível incluir manualmente um novo campo diretamente na tabela Campos.

Ao cadastrar um campo, podem ser configuradas as seguintes informações:

  • Label: Nome que será exibido para o campo na tela.

  • Texto: Define um valor padrão que será preenchido automaticamente no campo ao abrir a tela.

Campos de Pesquisa:
Os campos de pesquisa são utilizados quando é necessário consultar informações em outra tabela. Nessa configuração, o sistema realiza uma busca na tabela definida e retorna os dados selecionados.

Exemplo de configuração:

  • Tabela: Entidade

  • Código: CodCli

  • Descrição: Nome

Nesse exemplo, será aberta uma pesquisa na tabela Entidade, retornando o CodCli para a consulta, enquanto a Descrição (Nome) será apresentada para identificação do registro.

Caso a consulta permita retornar mais de um registro, é necessário marcar a opção Multi-seleção.

No campo Tipo Informação, deve-se informar o tipo de consulta que será utilizado para o filtro.

Configuração do tipo Opções:
Para campos do tipo 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á utilizado na consulta SQL.