O Cronapp utiliza um assistente de consulta visual que facilita a criação de consultas ao banco de dados.

Esta página é parte de um tutorial, para ter a documentação do contéudo acesse: Assistente de consulta JPQL

Visão Geral

As consultas não são em SQL puro, mas em JPQL (Java Persistence Query Language) que é uma linguagem de consulta ORM que opera sobre classes e objetos, diferente do SQL que opera sobre tabelas. Ela é também uma especificação da JPA e apesar de trabalhar com entidade (classes), é uma linguagem bem semelhante a SQL. Uma das vantagens da JPQL é que a mesma consulta pode ser executada em todos os bancos de dados.

O Assistente de consulta além de gerar uma consulta JPQL, possui outras funcionalidade, como vista na Figura abaixo:

Figura 1.1 - Assistente de consulta visual.

1. Estrutura da consulta: Possui as propriedades de criação de uma consulta JPQL, como adicionar entidades (equivalente a tabelas em SQL), campos de retorno, adição de regras ou condições, agrupamentos e outros. Mais detalhes em Assistente de consulta visual JPQL;
2. Paginador automático: automatiza o processo de paginação em uma página;
3. Multi inquilino: usado somente em projetos criados nas versões antigas do Cronapp;
4. Testar consulta: abre nova janela para realizar testes da consulta;
5. Editar como Texto: Permite editar ou criar a consulta via texto, sem o assistente visual;
6. Visualizar como Texto: exibe a consulta visual em modo texto;
7. Ok e Cancelar: Salva ou cancela a consulta.

select SQL('NOW()') from User u

Passos

De volta ao nosso exemplo, na função IdDoUsuarioLogado do bloco de programação que criamos no passo anterior, clique no ícone de configurações do bloco Abrir consulta para abrir a janela de assistente de consulta.

Vamos configurá-la como na Figura 2.1.

Figura 2.1 - Consulta para obter o Id do usuário através do seu login.

Siga os passos abaixo para obter a consulta da Figura 2.1.

1. Entidade: Clique no botão "…" e selecione a tabela User e depois clique no botão lateral + Adicionar;
2. Campos: Clique em + Novo Campo, deixe selecionado opção padrão Obter e selecione a opção u.id no campo seguinte;
3. Regras: Clique em  + Nova Regra e na linha que aparecer, altere:
   1. Primeiro campo: selecione u.login, será o atributo que iremos usar para realizar o filtro;
   2. Segundo campo: selecione a opção igual;
   3. Terceiro campo: deixe ou insira :login (com o sinal dois pontos na frente), este será o parâmetro que passaremos no filtro da consulta.

Após isso, clique no botão "Visualizar como texto" e será apresentado uma consulta como a informado abaixo: 

select u.id from User u where u.login = :login

Clique em Voltar, para retorna a janela do assistente visual e clique em Ok para salvar.

Acoplando os blocos

De volta ao bloco de programação que não finalizamos na etapa passada.

Após a configuração da consulta visual, o bloco "Abrir consulta" vai exibir a abertura lateral login, acople o bloco Obter login do usuário logado que está na categoria Util, como na Figura 2.2.

Figura 2.2 - Finalizando o bloco IdDoUsuarioLogado

Nessa função estamos realizando uma consulta pelo Id do Usuário logado no sistema, essa consulta retorna uma lista e estamos passando no retorno da função o primeiro item da lista.

Finalizada a configuração das funções do sistema, vamos trabalhar com as páginas web e mobile nas próximas etapas.