Executa comandos, como atualização e remoção, na linguagem JPQL. Para executar consultas, utilize o bloco Executar Consulta JQPL.
Figura 1 - Bloco Executar JPQL
Compatibilidade
- Bloco servidor: cronapi.database.Operations.execute()
Retorno
Bloco não possui retorno.
Características do bloco
Para configurar o bloco Executar JPQL, clique no ícone de engrenagem (seta da Figura 2). Após esta ação, a janela de "Configurar Bloco de Programação" será exibida permitindo a configuração do comando JPQL.
| Âncora | ||||
|---|---|---|---|---|
|
Figura 2 - Configuração do bloco Executar JPQL
Destaques da Figura 2:
- Entidade: abre a janela de seleção de entidades.
- Filtro: permite inserir o comando JPQL que será utilizado.
- Parâmetro: define o nome do parâmetro que será utilizado no comando. Deve seguir a estrutura:
<:parametro>. Cada valor inserido como parâmetro também será adicionado como um parâmetro no bloco.
- Parâmetro: define o nome do parâmetro que será utilizado no comando. Deve seguir a estrutura:
| Âncora | ||||
|---|---|---|---|---|
|
Parâmetros
Parâmetro "N"
Os parâmetros da função são exibidos de acordo com os parâmetro configurados no comando utilizado. Isso implica que a cada novo parâmetro definido, cujo valor não seja estático, um parâmetro é apresentado no bloco da função.
- Posição: 1 ou mais
- Tipo: Depende do tipo do dado do atributo.
Exemplo
A imagem abaixo apresenta um exemplo de uso do bloco Executar JPQL. O bloco foi configurado como exibido na Figura 2. Por meio dele, atualizaremos o campo "nota" do aluno que possui o nome informado no parâmetro "nome".
Figura 3 - Exemplo de uso do bloco Executar JPQL
As Figuras 3.1 e 3.2 apresentam os registros antes e depois da atualização, respectivamente. Observe que somente o registro da primeira linha (destaque 1 da Figura 3.1) foi alterado.
Figura 3.1 - Tabela "Aluno" antes da atualização
Figura 3.2 - Tabela "Aluno" depois da atualização
Nesta página
| Índice |
|---|
Executar Comando JPQL
Realiza consultas em um banco da dados.
Parâmetros de Entrada
Os parâmetros de entrada para função apresentam-se de acordo com as regras criadas no assistente de consulta visual, o que significa dizer que cada nova regra definida que tenha seu valor passado de forma não estática, se torna um parâmetro da função.
Retorno
Retorna uma tabela contendo os registros referente a consulta definida.
Compatibilidade
Servidor
Exemplo 1
A função abaixo em destaque permite a criação de uma consulta em um banco de dados, atribuindo a variável consul um conjunto de registros retornados de acordo com a consulta definida.
Sobre a JPQL (Java Persistence Query Language)
A JPQL é 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.
| Informações | ||
|---|---|---|
| ||
Sobre o bloco
A construção de uma instrução utilizando o bloco Executar Comando JPQL pode ser feita clicando-se no botão de configuração do bloco de programação.
Configuração do bloco de programação