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...')
Voltar
Como Fazer > Utilidades/Diversos > Magic.ini > Parâmetro BatchPaintTime
Índice
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
0nã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.
- O valor