Atualizar 

Função que atualiza um registro no banco de dados.

Parâmetros

Nome	Tipo	Doc
Parâmetro 1	Objeto	Objeto contendo o registro com os dados atualizados

Nota
title Obs.:
Os parâmetros de entrada para função apresentam-se de acordo com as regras criadas no assistente de atualização 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.

Configuração do bloco

Para configurar o bloco Atualizar, clique no símbolo da engrenagem, isso fará com que a janela Configurar Bloco de Programação seja exibida, para entender mais um pouco sobre ela, acesse a documentação Assistente de consulta.

Image Added

Figura 1 - 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 no tópico "Campos" da documentação do Assistente de consulta.
4. Área regras: define o filtro dos registros que serão atualizados. Possui a mesma estrutura vista no tópico "Regras" da documentação do Assistente de consulta.
5. Botão Excluir: apaga os campos e regras inseridos. 

Acesse a figura 1.1 da documentação Assistente de consulta para entender melhor sobre a ações dos campo Modo de consulta e os botões Testar Consulta, Editar Texto e Visualizar como Texto.

Compatibilidade

Image Modified Servidor

Exemplo 1

A função abaixo em destaque permite a atualização de uma entidade em um banco de dados,

o bloco foi configurado com o Tipo Objeto (destaque 2 da figura 1), e o objeto em questão é passado com todos os parâmetros preenchidos diretamente na função Criar novo objeto. Os dados foram passados de forma estática, e não dinâmica, para simplificar o exemplo apresentado na figura 1.

Image Added

Figura 2- Bloco de programação Atualizar

Para nosso exemplo, estamos alterando os atributos email e nome do registro Pessoa através do atributo ID, dessa forma, somente o objeto que contiver este ID será afetado, As figuras 2.1 e 2.2 representam o estado do registro antes e depois da atualização, respectivamente, perceba que somente o objeto da linha 1 foi alterado.

Image Added

Figura 2.1- Registro Pessoa antes da atualização

Image Added

Figura 2.2- Registro Pessoa depois da atualização

Exemplo 2

Outra forma de atualizar os dados é utilizando o Tipo Campos (destaque 2 da figura 1), onde é possível criar uma consulta JPQL a partir do assistente visual, criando regras para o(s) registro(s) que será(ão) atualizado(s). No exemplo da figura 1 estamos atualizando o campo nome da entidade Contatos a partir de um ID passado como parâmetro. O resultado seria semelhante ao mostrado no exemplo 1.