BatchPaintTime

De CIGAM WIKI
Revisão de 12h21min de 28 de janeiro de 2026 por Camila.Oliveira (discussão | contribs) (Criou página com '{{VoltarPagina}} <br> Como Fazer > Utilidades/Diversos > Magic.ini > Batc...')
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)

Voltar

Como Fazer > Utilidades/Diversos > Magic.ini > Parâmetro BatchPaintTime

Descrição

O BatchPaintTime define o intervalo de tempo (em milissegundos) em que o Magic xpa engine executa o polling de eventos pendentes durante a execução de tarefas batch.
Esse parâmetro controla quando o engine processa eventos internos, como atualizações de tela, timers e eventos de background.

No arquivo magic.ini, esse parâmetro pode ser configurado através de um Logical Name (NL).

Referência oficial:
Magic xpa 4.9.1 – Batch Event Interval
Valor padrão: 1000 ms
Nome no ini / linha de comando: BatchPaintTime

Comportamento padrão (valor > 0)

Quando o BatchPaintTime está configurado com um valor maior que zero:

  • O Magic executa o polling de eventos em intervalos regulares.
  • Eventos são processados:
  • Pelo Batch Event Interval
  • Pelo Record Event Interval
  • A aplicação mantém comportamento assíncrono esperado.
  • Processos que dependem de eventos internos (ex: A2F) funcionam corretamente.

Configuração incorreta – NL = 0

Quando o NL do BatchPaintTime é configurado como 0, ocorre o seguinte comportamento:

  • ❌ O intervalo de polling de eventos fica desabilitado.
  • ❌ O engine não processa eventos pendentes durante a execução batch.
  • ❌ Eventos internos deixam de ser disparados no tempo esperado.
  • ❌ Impacto direto em funcionalidades que dependem de eventos assíncronos.

Impacto na A2F

  • A A2F depende do processamento correto de eventos internos.
  • Com o BatchPaintTime = 0, o NL não é iniciado corretamente.
  • O fluxo da A2F pode:
  • Não disparar
  • Ficar travado
  • Não executar etapas dependentes de eventos
  • Resultado: processamento inconsistente ou incorreto.

⚠️ Conclusão:

Definir o NL do BatchPaintTime como 0 é considerado configuração incorreta.

Exemplo de configuração correta (magic.ini)

 [MAGIC_LOGICAL_NAMES]
 BatchPaintTime=1000

Observações importantes

  • O valor 0 não significa execução imediata — significa desativar o mecanismo de polling.
  • Mesmo em processos batch sem interface gráfica, o Magic continua dependendo de eventos internos.
  • Alterações nesse NL devem ser feitas com cautela, principalmente em ambientes produtivos.