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.
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â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