Define como as alterações de dados serão enviadas para o banco de dados na unidades de persistência (Namespaces) selecionada, substituindo, apenas durante o fluxo de execução, a opção definida no campo Descarregar dados da transação das Configurações do projeto.


Figura 1 - Bloco Definir Modo de Descarga de Dados da Transação

Compatibilidade

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

Retorno

Bloco sem retorno.

Parâmetros

Unidade de persistência

Lista os namespaces contidos no projeto. Cada namespace é vinculado a um Banco de dados. Ver mais detalhes em Diagrama.

  • Posição: 1
  • Inglês: Persistence Unit
  • Tipo: Texto / String
  • Exemplo: "app"

Modo de Descarga

Lista as opções de descarga.

  • Posição: 2
  • Inglês: Flush Mode
  • Tipo: Texto / String
  • Exemplo: "Ao Comitar"
  • Opções:
    • Ao Comitar / On Commit: faz a descarga dos dados quando houver uma chamada de commit, flush ou quando acabar o fluxo.
    • Sempre / Always: faz com que o envio dos dados ocorra sempre antes de uma consulta ser executada ou após acabar o fluxo.

Exemplo - Sempre

No exemplo abaixo estamos alterando o modo de descarga dos dados desta transação para "Sempre", em seguida, obtemos e imprimimos no console todos os registros da tabela do banco de dados usada no exemplo, o bloco Inserir adiciona mais um registro na tabela ("Jiló") e, por fim, realizamos uma nova consulta para ver as alterações.

Como utilizamos a opção "Sempre" no parâmetro Modo de Descarga, o Cronapp efetuou o commit automaticamente antes de executar o último bloco Abrir consulta.


Figura 2 - Exemplo de uso do Modo de Descarga "Sempre"

Exemplo - Ao Comitar

No exemplo da figura 2.1 estamos alterando o modo de descarga dos dados desta transação para "Ao comitar", obtemos e imprimimos no console todos os registros da tabela do banco de dados usada no exemplo, em seguida, utilizamos o bloco Inserir para adicionar mais um registro ("Maxixe") e, por fim, obtemos e imprimimos novamente no console todos os registros, antes e após a execução do bloco Commit da Transação, demonstrando que o registro só foi obtido após o commit.

Como utilizamos a opção "Ao comitar" no parâmetro Modo de Descarga, o Cronapp não efetuou o commit automaticamente antes de executar o bloco Abrir consulta, isso só ocorreu com a execução do bloco Commit da Transação.


Figura 2.1 - Exemplo de uso do Modo de Descarga "Ao comitar"

Nesta página