Atualizar 

Função que atualiza um registro no banco Permite atualizar um ou mais registros vinculados ao Banco de dados ou gerar uma requisição PUT a partir de uma Fonte de dados.

Parâmetros

Image Added

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

Image RemovedImage Added

Figura 1 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 Atualizar modifica o registro com base no objeto informado. Veja o Exemplo 1 para mais detalhes de configuração.
3. CamposÁ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 regrasRegras: define o filtro 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. 

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 Removed Servidor

Exemplo 1

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 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çãono bloco 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 Removed

Image Added

Figura 23 - Bloco Exemplo de programação Atualizaruso do bloco Atualizar passando um objeto como parâmetro

Para nosso este exemplo, estamos alterando vamos alterar os atributos "nome", "emaile nome do registro Pessoa " e "nota" da tabela "Aluno", através do atributo ID, dessa "id". Desta forma, somente o objeto que contiver este ID contém "id" especificado será afetado, . As figuras 2Figuras 3.1 e 23.2 representam o estado do registro apresentam os registros antes e depois da atualização, respectivamente, perceba . Observe que somente o objeto registro da primeira linha (destaque 1 da Figura 3.1) foi alterado.

Image RemovedImage Added

Figura 23.1 - Registro Pessoa Tabela "Aluno" antes da atualização

Image RemovedImage Added

Figura 23.2 - Registro Pessoa 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" 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.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.

Image Added

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.

Image Added

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.

Image Added

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)