Permite a atualização do campo atual em uma Fonte de dados presente no contexto da aplicação.


Figura 1 - Bloco Atualizar campo


A atualização de um campo em uma fonte de dados no contexto da aplicação significa que a alteração não é realizada imediatamente no banco de dados, mas sim em um objeto que representa uma ou mais tabelas. Esse objeto pode, então, ser persistido no banco de dados em um momento posterior.

Compatibilidade

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

Retorno

O bloco não possui retorno.

Parâmetros

Fonte de dados

Fonte de dados contendo os registros no padrão de retorno do bloco Abrir consulta.

  • Posição: 1
  • Inglês: Datasource
  • Tipo: Objeto / Object
  • Exemplo: retorno do bloco Abrir consulta.

Nome do campo

Nome do campo a ter o valor obtido. Todos os campos disponíveis da Fonte de dados, configurada no bloco Abrir consulta, serão exibidos na caixa de seleção deste parâmetro.

  • Posição: 2
  • Inglês: Field name
  • Tipo: Texto / Text

  • Exemplo: "nota"

Valor do campo

Novo valor a ser atribuído ao campo selecionado no parâmetro anterior.

  • Posição: 3
  • Inglês: Field value
  • Tipo: Texto / Text

  • Exemplo: "10"

Exemplo

A função a seguir apresenta um exemplo de uso do bloco Atualizar campo. Neste exemplo, a variável "consulta" foi configurada com o bloco Abrir consulta, utilizando a fonte de dados "Aluno". Utilizando o bloco Obter objeto da fonte de dados, imprimimos no console do depurador o valor atual do campo "nota".

Em seguida, no bloco Atualizar campo, o parâmetro "Fonte de dados" recebe a variável "consulta", enquanto o parâmetro "Nome do campo" é configurado com o campo "nota" e "Valor do campo" com o novo valor. Após a execução, o campo "nota" do registro atual é atualizado e o novo valor é impresso no console.


Figura 2 - Exemplo de uso do bloco Atualizar campo

Nesta página