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:
- 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 modifica o registro com base no objeto informado. Veja o Exemplo 1 para mais detalhes de configuração.
- Campos: seleciona os campos que serão alterados. Possui a mesma estrutura vista no tópico "Campos" da documentação do Assistente de consulta.
- 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.
- 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
Atualizar
Permite a atualização de campos de uma entidade em um banco da dados.
Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | Objeto | Objeto contendo o registro com os dados atualizados |
| title | Obs.: |
|---|
, 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.
| Âncora | ||||
|---|---|---|---|---|
|
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:
| Bloco de código | ||
|---|---|---|
| ||
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.
| Bloco de código | ||
|---|---|---|
| ||
PUT app/query156543(id=:id) |
Nesta página
| Índice |
|---|
Compatibilidade
Servidor
Exemplo 1
A função abaixo em destaque permite a atualização de uma entidade em um banco de dados, recebendo como parâmetro um objeto com o campo de email alterado.
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.
| Informações | ||
|---|---|---|
| ||
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.
Configuração do bloco de programação
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.
| Informações | ||
|---|---|---|
| ||
Utilizando o assistente de atualização visual |