Permite atualizar um ou mais registros vinculados ao Banco de dados ou gerar uma requisição PUT a partir de uma Fonte de dados.

Figura 1 - Bloco Atualizar

Compatibilidade

• Bloco servidor: cronapi.database.Operations.update()

Retorno

O bloco não possui retorno.

Características do bloco

Para configurar o bloco Atualizar, clique no ícone de engrenagem (seta da Figura 2). Após esta ação, a janela do Assistente de consulta será exibida permitindo a configuração dos campos de forma visual, não necessitando de uma interação direta com códigos na linguagem JPQL ou SQL. As instruções geradas pelo Assistente podem ser configuradas a partir de uma Entidade, Fonte de dados ou SQL Nativo. Para mais detalhes da estrutura do Assistente do bloco (Figura 2), consulte a documentação Assistente de consulta.

Figura 2 - Configuração do bloco Atualizar

Destaques da Figura 2:

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 modifica o registro com base no objeto informado. Veja o Exemplo 1 para mais detalhes de configuração.
3. 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. Regras: define as regras 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. 

Para informações das demais opções exibidas no Assistente do bloco Atualizar, consulte a documentação Assistente de consulta.

Parâmetros

Parâmetro "N"

Os parâmetros da função são exibidos de acordo com as regras criadas no Assistente de consulta. Isso implica que a cada nova regra definida, 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 1 - Atualização por objetos

A função a seguir apresenta um exemplo de uso do bloco Atualizar configurado com o Tipo "Objeto" (destaque 2 da Figura 2) a partir da classe "Aluno" do Diagrama de dados. O objeto em questão é passado com todos os parâmetros preenchidos diretamente no bloco Criar novo objeto. Os dados foram passados de forma estática para simplificar o exemplo.

Figura 3 - Exemplo de uso do bloco Atualizar passando um objeto como parâmetro

Para este exemplo, vamos alterar os atributos "nome", "email" e "nota" da tabela "Aluno", através do atributo "id". Desta forma, somente o objeto que contém "id" especificado será afetado. 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

Exemplo 2 - Atualização por campos

A imagem abaixo apresenta um exemplo de uso do bloco Atualizar configurado com o Tipo "Campos" (destaque 2 da Figura 2). O bloco foi configurado com os mesmos campos da Figura 2. Por meio dele, atualizaremos o campo "nome" do aluno que possui o "id" informado no parâmetro.

Figura 4 - Exemplo de uso do bloco Atualizar utilizando o tipo "Campos"

A imagem a seguir apresenta o registro atualizado da função. Observe que apenas o campo "nome" (destaque 1 da Figura 4.1) foi atualizado.

Figura 4.1 - Tabela "Aluno" depois da atualização

Ao clicar no botão "Editar como Texto" (Figura 2), poderemos observar que a consulta definida ficará da seguinte forma:

UPDATE Aluno SET nome = :nome WHERE id = :id

Exemplo 3 - Utilizando uma Fonte de dados

A função a seguir apresenta um exemplo de uso do bloco Atualizar em que foi selecionado uma Fonte de dados no campo Entidade (destaque 1 da Figura 2). Diferente dos exemplos anteriores, nos quais ao selecionar uma classe é possível utilizar tanto o Tipo "Campos" como "Objeto" (2 da Figura 2), ao utilizar uma Fonte de dados apenas o Tipo "Campos" é permitido.

Figura 5 - Exemplo de uso do bloco Atualizar utilizando uma Fonte de dados

Ao clicar no botão "Editar como Texto" (Figura 2), poderemos observar que a consulta definida gera a requisição REST abaixo. Para mais detalhes, consulte o tópico REST da documentação Assistente de consulta.

PUT app/query156543(id=:id)