Versões comparadas

Versão antiga 61

changes.mady.by.user Igor Andrade

Gravado em

comparado com

Nova versão 62

changes.mady.by.user Igor Andrade

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Para criar as consultas ao banco de dados, o Cronapp utiliza um o assistente de consulta visual, que facilita a criação de consultas ao banco de dados.

Visão Geral 

simplificando esse processo.

Âncora
Habilitar Paginação
Habilitar Paginação

Visão Geral 

O Assistente de Consulta visual gera consultas As consultas são realizadas em JPQL (Jakarta Persistence Query Language, conhecido antigamente como Java Persistence Query Language), que é uma linguagem de consulta ORM que atua sobre classes e objetos, diferentemente do SQL que realiza as consultas baseadas em sobre tabelas. Apesar de a diferença estrutural, a linguagem JPQL é bem semelhante ao SQL, porém a primeira possui a vantagem de que a mesma consulta pode ser realizada em todos os bancos de dados. O Assistente é utilizado tanto em blocos de programação quanto em fontes de dados, mas existem pequenas diferenças entre o assistente de consulta do bloco e da fonte de dados.

O assistente permite criar consultas de forma visual (low-code) ou O Cronapp possui um Assistente de consulta visual para facilitar a criação de consultas JPQL. O assistente de consulta é utilizado tanto em blocos de programação quanto em fontes de dados, mas existem pequenas diferenças entre o assistente de consulta do bloco e da fonte de dados. O assistente permite criar consultas de forma visual (low-code) ou manual (high-code), usando JPQL.

 

Image Modified

Figura 1.1 - Assistente de consulta visual (Bloco de programação)


  1. Estrutura de Consulta: Possui as opções para a criação da consulta, como selecionar as seleção das entidades, campos de retorno, criar regras e outros.
  2. Modo de Consulta: Altera a exibição dos dados em modo de teste forma como os dados são exibidos durante a criação da consulta, que pode podem ser por tabelas ou objetos (Figuras 1.2 e 1.3). 
  3. Aplicar dados da requisição: Aplica as requisições (paginação, ordenação e outros) diretamente na consulta (ver mais detalhes em aqui).
  4. Habilitar Paginação: Realiza a paginação dos dados em uma página telas de forma automática (ver mais detalhes em aqui).
  5. Testar Consulta: Exibe o resultado da consulta criada em uma nova janela, altere o campo Modo de Consulta para modificar a forma de exibição (Figuras 1.2 e 1.3).
  6. Editar como Texto: Muda a janela para editar a consulta manualmente em JPQL (high-code). Após alterar uma consulta manualmente, não será possível editar novamente em modo visual.
  7. Visualizar como Texto: Exibe a consulta feita no formato visual em forma de textoJPQL gerada através da configuração visual.
  8. OK e Cancelar: Salva ou cancela a consulta.


Image Modified

   Figura 1.2 - Exibição de consulta em modo objetos


Image Modified

Figura 1.3 - Exibição de consulta em modo tabela

Âncora
estrutura_consulta
estrutura_consulta

Estrutura da consulta

Agora vamos entender melhor as opções disponíveis na estrutura da consulta. 


Image Modified

Figura 2.1 - Estrutura visual da consulta


  1. Entidade:
    2.  Adiciona
  2. adiciona as entidades que farão parte da consulta.
  3. Campos:
    4.  Define
  4. define quais campos serão buscados na consulta.
  5. Regras:
    6. Regra
  6. regra que será considerada ao buscar os dados no banco.
  7. Agrupar:
    8.  Agrupa
  8. agrupa linhas que
    9. têm os mesmos valores
  9. possuem valores iguais nos mesmos campos.
  10. Having:
    11. Cria
  11. cria regras para serem usadas juntos com os campos agrupados.
  12. Ordenar:
    13. Define
  13. define a ordem em que os dados serão retornados.

Âncora
Consulta_Entidade
Consulta_Entidade

Entidade

Adiciona as entidades que farão parte da consulta. Equivale a seleção de tabelas após sentença "FROM" em uma consulta SQL.

Em consultas JPQL não é necessário usar o "JOIN", pois na a área de seleção dos campos já mapeia todos os campos das entidades relacionadas. Exemplo: Entidade Por exemplo, imagine que uma entidade A tem relação com B, a entidade B tem relação com C e C possui um campo chamado "nome", dessa forma, basta selecionar a entidade A e na área Campos (tópico abaixo) selecionar a opção "A.B.C.nome", criando um JOIN automaticamente. 


Image Modified

Figura 2.2 - Área de seleção das entidades

Botões:

  • Entidade:
    • Exibe
  • exibe a entidade recém selecionada.
  • " ... " :
    • Abre
  • abre a janela para seleção da entidade.
  • Alias:
    • Permite
  • permite adicionar um apelido.
  • + Adicionar:
    • Adiciona
  • adiciona a entidade selecionada a consulta.
  • Excluir:
    • Exclui
  • exclui entidade adicionada.

Destaques da figura 2.2:

  1. Exibe a entidade selecionada.
  2. Exibe o alias da configurado para a entidade selecionada,


Para adicionar as entidades que farão parte da consulta, clique no botão "..." do campo Entidade, selecione a classe desejada e finalize clicando em "+ Adicionar".

Âncora
Consulta_Campos
Consulta_Campos

Campos

Define quais campos serão buscados na consulta. Equivale a seleção dos campos das tabelas após a sentença "SELECT" em uma consulta SQL.


Image Modified

Figura 2.3 - Área de seleção dos campos


É possível adicionar os campos desejados através do botão "+ Novo Campo" ou adicionar todos os campos da entidade de uma só vez, clicando em "+ Adicionar Todos". 

Botões:

  • + Novo Campo:
    • Adiciona
  • adiciona um
    • novo campo na consulta
  • campo das entidades selecionadas ou de entidades relacionadas.
  • + Adicionar Todos:
    • Insere
  • insere todos os campos das entidades selecionadas.
  • Excluir:
    • Exclui
  • exclui o campo.

Destaques da figura 2.3:

  1. Tipo de retorno: 
    2. Define
  2. define como o valor do campo será retornado. Os tipos são:
    • Obter:
    3.   Retorna
    •  retorna o valor do campo como está no banco;  
    • MIN:
    4. Retorna
    •  retorna o menor valor
    5. dos campos
    • do campo selecionado;
    • MAX:
    6. Retorna
    •  retorna o maior valor
    7. dos campos
    • do campo selecionado;
    • AVG:
    8. Retorna
    •  retorna a média aritmética dos valores
    9. dos campos registrados no banco
    • do campo selecionado;
    • SUM:
    10. Retorna
    •  retorna a soma dos valores do campo selecionado;
    • COUNT:
    11. Retorna
    •  retorna a quantidade de registros do campo selecionado.
  12. Campo selecionado: Seleciona qual o campo será consultado. 

Ao selecionar somente o alias (exemplo do campo "lg" na imagem 2.3) a consulta retorna todos os campos, nesse caso, não seria necessário selecionar o segundo campo "lg.providerDisplayName".

Não é necessário fazer JOIN em consultas JPQL, o exemplo do campo "lg.user.name" retornará o nome do usuário que faz relação com o login selecionado.


Para retornar todos os campos de uma entidade, basta selecionar o alias da entidade desejada. Primeiro exemplo da figura 2.3: obter | lg.

Para retornar um campo específico, é necessário selecionar o alias da entidade com o campo desejado. Segundo exemplo da figura 2.3:  obter | lg.providerDisplayName.

Caso queira obter um campo de uma entidade relacionada (JOIN), selecione o alias da entidade, junto com o nome da entidade relacionada e o nome do campo. Terceiro exemplo da figura 2.3: obter | lg.user.name. 

Por padrão, a caixa de seleção dos campos só exibe relacionamentos até o terceiro nível. para relacionamentos maiores, informe manualmente. Exemplo: EntidadeA.EntidadeB.EntidadeC.EntidadeD.atributo.

Âncora

Âncora
Consulta_Regras
Consulta_Regras

Regras

Nessa propriedade é definida a regra que será considerada as regras que serão consideradas ao buscar os dados no banco. Por meio do botão "+ Nova Regra" é possível adicionar regras e selecionar um condicional único entre as regras, ou adicionar vários grupos de regras e selecionar condicionais para cada grupo individualmente através do botão "+ Novo Grupo".  Equivale As regras equivalem ao filtro após sentença "WHERE" em uma consulta SQL.


Image Modified

Figura 2.4 - Área de seleção das regras da consulta


Botões:

  • + Nova Regra: adiciona uma regra vinculada ao campo selecionado.
  • + Novo Grupo: insere um grupo com uma ou mais regras.
  • Excluir: exclui a regra ou grupo selecionado.

Destaques da figura 2.4:

  1. Negação: nega a Negação e operador lógico: nega a sentença vinculada, adicionando um "not" antes.
  2. Operador lógico: , e define se o operador lógico entre as sentenças vinculadas será "e" ou "ou".
  3. Inverter: alterna o operador lógico e os campos condicionais das sentenças vinculadas, por exemplo: se estiver selecionado "ou", será substituído por "e", isso também ocorrerá no campo condicional (campo 4 da figura 2.4), que alternará de "igual" para "diferente".
  4. Campo da entidade: campo da entidade que será utilizado para a na criação da regra.
  5. Condição: define a condição que deve existir entre o campo e o parâmetro, são elas
      Igual
      • igual;
      • diferente;
      • contido;
      • não contido;
      • iniciando com;
      • não iniciando com;
      • contém;
      • não contém;
      • terminando com;
      • terminado sem;
      • é vazio;
      • não é vazio;
      • é nulo;
      • não é nulo.
    • Parâmetro:
      • Define
    • define-se o nome do parâmetro que será comparado com o campo da entidade. É possível inserir o conteúdo literal, ou definir uma variável que será passada por parâmetro, adicionando ":" (dois pontos) na frente da variável.

    • ↑ ↓ : Permite arrastar clique e arraste o ícone ↑ ↓ para modificar a posição de uma regra ou grupo para dentro de um grupo ou ordená-los,. 


A regra (where) definido na figura 2.4 ficará da seguinte forma:

Bloco de código
title
languagesqlRegra
WHERE
usr.name = :name AND (NOT (lg.user.phoneNumber LIKE (CONCAT('%', '(71)', '%')) ))

Âncora
Consulta_Agrupar
Consulta_Agrupar

Agrupar

Possui a função de agrupar linhas que têm os mesmos valores em um ou mais campos específicos. Equivale a sentença "GROUP BY" em uma consulta SQL.


Image Modified

Figura 2.5 - Área de seleção do Agrupar


Destaques da figura 2.5:

  1. Campo a ser agrupado:
    2. Seleciona
  2. seleciona qual o campo será agrupado.

Botões:

  • + Novo Campo: Adiciona adiciona outro campo para agrupar.
  • Excluir: exclui o campo selecionado.

Âncora
Consulta_Having
Consulta_Having

Having

A propriedade having funciona de forma semelhante a propriedade Regra, entretanto ela cria uma regra para os grupos criados com a propriedade agrupar. Por isso, o having sempre deve ser usado junto com o agrupar. Possui a mesma função do Having em consultas SQL.


Image Modified

Figura 2.6 - Área de seleção das regras do Having

Botões:

  • + Novo Campo: adiciona outro campo para agrupar.
  • Excluir: exclui o campo selecionado.

Destaques da figura 2.6:

  1. Tipo de dados da condição: é
    2. Tipo de dados da condição: É
  2. definido qual o tipo será retornado do banco para ser comparado na regra criada pelo having. Os tipos são:
    • MIN:
    3. Retorna
    •  retorna o menor valor
    4. dos campos
    • do campo selecionado;
    • MAX:
    5. Retorna
    •  retorna o maior valor
    6. dos campos
    • do campo selecionado;
    • AVG:
    7. Retorna
    •  retorna a média aritmética dos valores do campo
    8. registrados no banco
    • selecionado;
    • SUM:
    9. Retorna
    •  retorna a soma dos valores
    10. dos campos e
    • do campo selecionado;
    • COUNT:
    11. Retorna
    •  retorna a quantidade de registros do campo selecionado.
  12. Campo:
    13. Campo
  13. campo usado para a comparação com o parâmetro.
  14. Condição:
    15. Condição
  15. condição que será utilizado para comparar o valor obtido no campo e o parâmetro. São eles:
    • Igual;
    • Diferente;
    • Menor;
    • Menor ou igual;
    • Maior;
    • Maior ou igual.
  16. Parâmetro:
    17. Valor
  17. valor que será comparado com o tipo de dado retornado.

Âncora
Consulta_Ordenar
Consulta_Ordenar

Ordenar

Nessa opção é definida define a ordem de retorno dos itens. Por exemplo, é possível trazer os dados organizados do menor id para o maior ou o contrárioa lista de funcionários ordenada pelos maiores salários. Possui a mesma função do Order by em consultas SQL.


Image Modified

Figura 2.7 - Área de ordenação da consulta


Botões:

  • + Novo Campo: adiciona outro campo para agrupar.
  • Excluir: exclui o campo selecionado.

Destaques da figura 2.7:

  1. Tipo de dado: define qual o tipo de dado
    2. Tipo de dado: Define qual o tipo de dado
  2. que será utilizado para ordenar os dados.
    • Obter:
    3.   Retorna
    •  retorna o valor do campo como está no banco;  
    • MIN:
    4. Retorna
    •  retorna o menor valor
    5. dos campos
    • do campo selecionado;
    • MAX:
    6. Retorna
    •  retorna o maior valor
    7. dos campos
    • do campo selecionado;
    • AVG:
    8. Retorna
    •  retorna a média aritmética dos valores
    9. dos campos registrados no banco
    • do campo selecionado;
    • SUM:
    10. Retorna
    •  retorna a soma dos valores do campo selecionado;
    • COUNT:
    11. Retorna
    •  retorna a quantidade de registros do campo selecionado.
  12. Campo:
    13. Campo
  13. campo que será utilizado para a ordenação.
  14. Tipo de ordenação:
    15. Define
  15. define o tipo de ordenação que será considerada na propriedade.
    • Asc:
    16. Ascendente
    • ascendente;
    • Desc:
    17. Descendente
    • descendente.

Diferença entre consultas: Visual, JPQL e SQL JPQL e SQL

Como informado anteriormente, o Assistente de consulta visual gera uma consulta em JPQL que se parece muito com consultas SQL. Veja abaixo uma imagem representando uma consulta usando o Assistente Visual (Figura 3.1), a consulta JPQL gerada pelo Assistente visual e o equivalente em MySQL.

O JPA/JPQL não possui suporte para UNION, INTERSECT e EXCEPT, dessa forma, para consultas mais complexas que necessitam dessas funcionalidades, use o modo high code (código), clicando no botão Visualizar como TextoSQL puro).


Image Modified

Figura 3.1 - Exemplo de consulta visual 


A consulta gerada pela configuração do assistente visual da Figura 3.1:

Bloco de código
languagesql
firstline1
linenumberstrue
SELECT		c.estado.nome FROM Cidade c
WHERE		c.quantidadeHabitantes <> :minimo
GROUP BY	c.nome
HAVING 		SUM(c.quantidadeHabitantes) > :quantidadeHabitantes
ORDER BY 	c.estado ASC


Exemplo da mesma consulta feita para o MySQL:

Bloco de código
languagesql
firstline1
linenumberstrue
SELECT      c.nome FROM db_componentesvisuais2.CIDADE c
JOIN		db_componentesvisuais2.ESTADO e on c.fk_estado = e.id
WHERE       c.quantidadehabitantes <> '%minimo%'
GROUP BY    c.nome
HAVING      SUM(c.quantidadehabitantes) > '%quantidadeHabitantes%'
ORDER BY    e.id ASC

Âncora

Diferença

Diferencas

Diferença

Diferencas

Fonte de dados vs Bloco de programação 

Existem duas formas de obter dados para alimentar uma Fonte de dados e em ambas é possível utilizar o Assistente de Consulta JPQL:

  • via Entidade (Figura 4.1):
    1. Selecione a opção Entidade;
    2. Selecione a entidade principal no botão "...";
    3. Abra
  • Selecionar uma Entidade e criar um filtro através do Assistente de consulta na aba Filtro da Fonte de dados ou
  • Alimentar a Fonte de dados através do bloco de programação Abrir consulta e usar
    1. o Assistente de consulta
    do próprio bloco (
    1. para personalizar através do botão Editar da aba Filtro.


Image Added

Figura 4.1

).

Image Removed

Figura 4.1 - Fonte de dados alimentada por bloco de programação com opção Habilitar paginação ativa

O Assistente de consulta visual possui duas funcionalidades a mais quando aberto pelo bloco de programação, essas duas funcionalidades são:  Aplicar Dados da Requisição e Habilitar Paginação. (Figuras

vinculada a uma entidade e sua consulta


  • Via Bloco de Programação (Figura 4.2)
.
  • :
    1. Selecione a opção Bloco de Programação;
    2. Selecione uma função já criada através do botão "....";
    3. Na função, utilize o ícone engrenagem do bloco Abrir consulta para abrir o Assistente de consulta visual do bloco.

Image Removed

Figura 4.2 - Assistente de Consulta Visual aberto via Bloco de programação


Image Modified

Figura 4.3 2 -  Assistente de Consulta Visual aberto via Fonte de dados

Aplicar dados da requisição

O Cronapp permite uso de um bloco como fonte de dados. Na maioria das vezes, o intuito é usar uma consulta com a função "Abrir Consulta". Nas versões anteriores existia uma opção chamada Paginação Automática. Essa opção aplicava os dados de paginação da requisição da fonte de dados à consulta. O Cronapp evoluiu essa opção que passou a se chamar Aplicar Dados da Requisição. Essa opção agora aplica paginação, ordenação, filtros e qualquer outro dado da requisição ODATA à consulta. Com isso, todas as operações de interface serão enviadas à consulta, fazendo com que a fonte de dados funcione integralmente com a consulta do Bloco de Programação.

Habilitar paginação

Caso queira paginar os dados exibidos na tela, utilize o bloco Abrir consulta e selecione a opção Habilitar paginação, ao fazer isso, o bloco exibirá os parâmetros limit e offset (Figura 4.1).

  • limit: define a quantidade de linhas retornadas na consulta;
  • offset: define a partir de qual linha retornará.

Exemplo: Em uma consulta com 100 registros, ao inserir os parâmetros limit com 20 e o offset com 10, o resultado retornará do registro 10 até o 30.

Blocos que utilizam o Assistente visual JPQL

A estrutura do Assistente visual da figura 3.1 é exibida apenas para o bloco Abrir consulta, os blocos Inserir, Atualizar e Remover possuem diferenças em sua estrutura. Acesse os links abaixo para mais detalhes.

Image Removed

Figura 5.1 - Blocos que utilizam o Assistente de consulta visual

Blocos do tipo servidor de acesso ao banco de dados:

  1. Inserir: Adiciona uma nova entidade ao banco de dados por meio do assistente visual do JPQL, para saber mais sobre o bloco clique aqui.
  2. Abrir consulta: Realiza uma consulta no banco de dados por meio do assistente visual do JPQL, para saber mais sobre o bloco clique aqui.
  3. Atualizar: Atualiza uma entidade no banco de dados por meio do assistente visual JPQL, para saber mais sobre o bloco clique aqui.
  4. Remover: Remove uma entidade do banco de dados por meio do assistente visual JPQL, para saber mais sobre o bloco clique aqui.
  5. Criar entidade: Cria um objeto para usar junto a um dos blocos acima. para saber mais sobre o bloco clique aqui.

Bloco Inserir

A inserção de um dado através do bloco pode ser de dois tipos: objeto (Figura 5.2.1 e 5.2.2) e campos (Figura 5.2.3 e 5.2.4). Para ela ocorrer por objeto, selecione a entidade, salve (Figura 5.2.1) e passe o objeto contendo os dados da entidade (Figura 5.2.2).

Image Removed

Figura 5.2.1 - Adicionando uma entidade como objeto

Image Removed

Figura 5.2.2 - Passando objeto ao bloco inserir

No caso da inserção através dos campos, clique no botão Novo Campo para adicionar os campos da entidade. Após a definição da entidade e dos campos, o bloco de programação exibido na função passa a apresentar parâmetros de entrada referentes ao campos adicionados (Figuras 5.2.3 e 5.2.4).

Image Removed

Figura 5.2.3 - Adicionando os campos da entidade

Image Removed

Figura 5.2.4 - Passando os dados para os parâmetros do bloco

Bloco Atualizar

Assim como a inserção, a atualização pode ser de dois tipos: objeto (Figura 5.3.1 e 5.3.2) e campos (Figura 5.3.3 e 5.3.4). Para a atualização ocorrer por objeto, selecione a entidade na janela de configuração do bloco (botão "..."), clique em OK e passe o objeto contendo os dados que serão atualizados.

Image Removed

Figura 5.3.1 - Adicionando uma entidade como objeto

Image Removed

Figura 5.3.2 - Passando objeto modificado ao bloco atualizar

Para que a atualização seja do tipo campos, será necessário definir os campos que serão atualizados (através do botão Novo Campo). Após a escolha da entidade e dos campos, existe a possibilidade da criação de regras que permitem que condições de filtro sejam aplicadas nas atualizações.

Image Removed

Figura 5.3.3 - Adicionando o campo que será atualizado e a regra

Image Removed

Figura 5.3.4 - Atualizando o campo name pelo ID do usuário

Informações
titleObservação

As regras definidas com valor dinâmico geram um parâmetro de entrada na função. No exemplo da figura 5.3.4, gerou o parâmetro id.

Bloco Remover

O bloco remover também apresenta dois tipos:  objeto (Figura 5.4.1) e campos (Figura 5.4.2). Para a remoção do tipo objeto ocorrer, é necessário indicar qual é o emento que será removido, seja ele pelo ID ou outro campo.

Image Removed

Figura 5.4.1 - Adicionando uma entidade como objeto

Image Removed

Figura 5.4.2 - Passando objeto que será removido através do ID

No caso da remoção pelos campos, será apresentado o campo para definir a regra que fará a exclusão do elemento da entidade, podendo ser o ID ou qualquer outro campo.

Image Removed

Figura 5.4.3 - Adicionando regra que fará um usuário ser removido

Image Removed

Figura 5.4.4 - Remoção de um usuário através do ID

Bloco Criar Entidade

Ele cria um objeto de uma entidade, permitindo selecionar os campos que serão alimentados via bloco. Após selecionada a entidade e seus campos (Figura 5.5.1), eles passam a ser parâmetros do bloco (Figura 5.5.2).

Image Removed

Figura 5.5.1 - Adicionar entidade e seus campos

Image Removed

Figura 5.5.2 - Campos viram parâmetros do bloco

Fonte de dados alimentada por bloco de programação com a opção Habilitar paginação ativa


Alimentar uma fonte de dados por bloco de programação permite que seja feito algum tratamento no conteúdo obtido antes de alimentar a fonte de dados. O Assistente de consulta visual do Bloco de programação possui duas funcionalidades a mais:  Aplicar Dados da Requisição e Habilitar Paginação. (Figuras 4.3 e 4.4).


Image Added

Figura 4.3 - Assistente de Consulta Visual aberto via Bloco de programação


Image Added

Figura 4.4 - Assistente de Consulta Visual aberto via Fonte de dados

Aplicar dados da requisição

Nas versões anteriores do Cronapp existia uma opção chamada "Paginação Automática". Essa opção aplicava os dados de paginação da requisição da fonte de dados à consulta. O Cronapp evoluiu essa opção que passou a se chamar Aplicar Dados da Requisição (Figura 4.3). Essa nova opção aplica paginação, ordenação, filtros e qualquer outro dado da requisição ODATA à consulta. Com isso, todas as operações de interface serão enviadas à consulta, fazendo com que a fonte de dados funcione integralmente com a consulta do Bloco de Programação.

Habilitar paginação

Caso queira paginar os dados exibidos na tela, utilize o bloco Abrir consulta e selecione a opção Habilitar paginação, ao fazer isso, o bloco exibirá os parâmetros limit e offset (Figura 4.2).

  • limit: define a quantidade de linhas retornadas na consulta;
  • offset: define a partir de qual linha retornará.

Exemplo: Em uma consulta com 100 registros, ao definir os parâmetros limit com '20' e o offset com '10', o resultado retornará do registro 10 até o 30.

Blocos que utilizam o Assistente visual JPQL

O bloco de banco de dados Abrir consulta exibe a mesma estrutura do Assistente visual como vimos acima. Já os blocos de manipulação de dados (DML - Data Manipulation Language) possuem algumas diferenças.


Image Added

Figura 5.1 - Blocos que utilizam o Assistente de consulta visual


Blocos do tipo servidor de acesso ao banco de dados:

  1. Criar nova Entidade: cria um objeto para usar junto a um dos blocos abaixo.
  2. Inserir: adiciona novo registro ao banco de dados por meio do assistente visual do JPQL.
  3. Abrir consulta: cria uma consulta no banco de dados por meio do assistente visual do JPQL.
  4. Atualizar: atualiza registros no banco de dados por meio do assistente visual JPQL.
  5. Remover: remove registros do banco de dados por meio do assistente visual JPQL.

Âncora
bloco_criar-nova-Entidade
bloco_criar-nova-Entidade

Bloco Criar nova Entidade

Utilize esse bloco para criar objetos de uma entidade e facilitar a manipulação de dados junto aos outros blocos de banco de dados. Selecione o ícone engrenagem para abrir a janela de configuração, escolha a entidade desejada no botão "..." (campo Entidade) e, por fim, marque os atributos (área Campos) que serão alimentados.

Acesse a documentação do bloco Criar entidade para mais detalhes.


Image Added

Figura 5.2 - Criando um objeto a partir do bloco Criar nova Entidade


Todos os demais blocos apresentados aqui podem ser alimentados a partir do objeto gerado pelo bloco Criar nova Entidade (Figura 5.2) ou diretamente pela seleção de campos (Figura 5.3).

Âncora
bloco_inserir
bloco_inserir

Bloco Inserir

Utilize o bloco Inserir para adicionar registros a partir de um objeto ou seus campos.

Acesse a documentação do bloco Inserir para mais detalhes.


Image Added

Figura 5.3 - Configuração do bloco Inserir


  1. Entidade: abre a janela de seleção de entidades.
  2. Tipo: informa se o bloco será alimentado a partir dos atributos "Campos" da entidade ou a partir do "Objeto", por exemplo, utilizando em conjunto com o bloco Criar Nova Entidade (Figura 5.2).
  3. + Novo Campo: clique para adicionar os campos da entidade.
  4. Campos: lista de campos adicionados.
  • Botão Excluir: apaga os campos inseridos. Exclua todos os campos para retornar ao tipo "Objeto".

Âncora
bloco_atualizar
bloco_atualizar

Bloco Atualizar

Utilize o bloco Atualizar para modificar registros em uma tabela a partir de um objeto ou seus campos.

Acesse a documentação do bloco Atualizar para mais detalhes.


Image Added

Figura 5.4 - Configuração do bloco Atualizar


  1. Entidade: abre a janela de seleção de entidades.
  2. Tipos: define como será atualizado o registro:
    • Campos: permite selecionar os campos que serão atualizados e criar regras para atualizar um ou vários registros ao mesmo tempo;
    • Objeto: esta opção não permite definir campos e regras, o bloco Atualizar modifica o registro com base no objeto informado.
  3. Área campos: seleciona os campos que serão alterados. Possui a mesma estrutura vista em Campos.
  4. Área regras: define o filtro dos registros que serão atualizados. Possui a mesma estrutura vista em Regras.
  • Botão Excluir: apaga os campos e regras inseridos. 

Acesse a figura 1.1 para obter informações sobre o campo Modo de consulta e os botões Testar Consulta, Editar Texto e Visualizar como Texto.

Âncora
bloco_remover
bloco_remover

Bloco Remover

O bloco Remover exclui um ou mais registros com base em filtros ou objeto.

Acesse a documentação do bloco Remover para mais detalhes.


Image Added

Figura 5.5 - Configuração do bloco Remover


  1. Entidade: abre a janela de seleção de entidades.
  2. Tipos: define como será configurado a seleção de registros:
    • Campos: permite criar regras para remover um ou vários registros ao mesmo tempo;
    • Objeto: esta opção não permite definir regras, o bloco Remover exclui o registro com base no objeto informado.
  3. Área regras: define o filtro dos registros que serão excluídos. Possui a mesma estrutura vista em Regras.
  • Botão Excluir: apaga as regras inseridas. 

Acesse a figura 1.1 para obter informações sobre o campo Modo de consulta e os botões Testar Consulta, Editar Texto e Visualizar como Texto.

Nesta Nessa página

Índice