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 |
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.
Figura 1 - Configuração do bloco Atualizar
- Entidade: abre a janela de seleção de entidades.
- 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.
- Á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.
- Á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.
- 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
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.
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.
Figura 2.1- Registro Pessoa antes da atualização
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.
Sobre o bloco
O comando de atualização de um registro utilizando o bloco Atualizar pode ser criado clicando-se no botão de configuração do bloco de programação.
Sobre Atualização(Update SQL)
Update é uma declaração da linguagem SQL, “Structured QueryLanguage” ou, em Português, Linguagem de Consulta Estruturada, que altera os dados de um ou mais registros em uma tabela em um banco de dados.
Utilizando o bloco de atualização
A atualização de campos de uma entidade pode ser feita através do modo visual, permitindo que o usuário não necessite de uma interação direta com códigos na linguagem SQL.
Para mais informações sobre como construir de forma visual uma instrução capaz de atualizar campos de uma entidade em bancos de dados acesse o link abaixo.