BatchPaintTime: mudanças entre as edições

De CIGAM WIKI
Camila.Oliveira (discussão | contribs)
Administradores da interface, Administradores
5 242 edições
Criou página com '{{VoltarPagina}} <br> Como Fazer > Utilidades/Diversos > Magic.ini > Batc...'
 
 
(2 revisões intermediárias pela mesma usuária não estão sendo mostradas)
Linha 2: Linha 2:
<br>
<br>
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Magic.ini|Magic.ini]] > [[BatchPaintTime|Parâmetro BatchPaintTime]]
[[MediaWiki:Como_Fazer_sidebar|Como Fazer]] > [[Como_Fazer_Utilidades/Diversos|Utilidades/Diversos]] > [[GE - Como Fazer - Magic.ini|Magic.ini]] > [[BatchPaintTime|Parâmetro BatchPaintTime]]
=Objetivo=
Definir o intervalo de tempo (em milissegundos) em que o '''Magic xpa engine''' realiza o processamento (''polling'') de eventos pendentes durante a execução de processos batch.


=Descrição=
=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.<br>
O parâmetro '''BatchPaintTime''' controla o tempo em que o engine do Magic verifica e processa eventos internos enquanto uma tarefa batch está em execução.<br>
Esse parâmetro controla '''quando o engine processa eventos internos''', como atualizações de tela, timers e eventos de background.
Esses eventos incluem:
* Eventos de sistema
* Timers internos
* Processamento assíncrono necessário para fluxos de execução
* Funcionalidades dependentes de eventos, como '''A2F'''
 
De acordo com a documentação oficial do Magic xpa, o engine realiza o polling de eventos com base no '''Batch Event Interval''' e no '''Record Event Interval''', sendo acionado sempre que um desses intervalos é atingido.
 
Valor padrão do Magic xpa: '''1000 ms'''
 
=Impacto da configuração do NL = 0=
Quando o '''NL do BatchPaintTime é configurado com valor 0 no magic.ini''', o comportamento do engine é alterado de forma incorreta.
 
'''Efeitos observados:'''
* O mecanismo de polling de eventos batch é '''desativado'''
* Eventos internos deixam de ser processados no tempo esperado
* O engine não executa corretamente fluxos dependentes de eventos
* O comportamento assíncrono da aplicação é comprometido


No arquivo '''magic.ini''', esse parâmetro pode ser configurado através de um '''Logical Name (NL)'''.
=Impacto na funcionalidade A2F=
A funcionalidade '''A2F''' depende do correto processamento de eventos internos do Magic.


:Referência oficial:
Com o '''BatchPaintTime = 0''':
:Magic xpa 4.9.1 – ''Batch Event Interval''
* '''O NL não é iniciado corretamente''';
:Valor padrão: '''1000 ms'''
* O fluxo da A2F pode não ser disparado;
:Nome no ini / linha de comando: '''BatchPaintTime'''
* Podem ocorrer travamentos ou interrupções no processamento;
* O resultado do batch pode ser inconsistente ou incorreto.


=Comportamento padrão (valor > 0)=
=Impacto na recuperação de senha - Desktop=
Quando o '''BatchPaintTime''' está configurado com um valor maior que zero:
A funcionalidade de '''recuperação de senha no Desktop''' também depende do correto processamento de eventos internos do Magic para executar o fluxo de validação e envio de e-mail ao usuário.
:* 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=
Com o '''BatchPaintTime = 0''':
Quando o '''NL do BatchPaintTime é configurado como 0''', ocorre o seguinte comportamento:
* Eventos responsáveis pelo disparo do processo de recuperação de senha podem não ser processados;
:* ❌ O intervalo de polling de eventos fica '''desabilitado'''.
* O '''envio do e-mail de recuperação de senha pode falhar ou não ocorrer''';
:* ❌ O engine '''não processa eventos pendentes durante a execução batch'''.
* O fluxo de redefinição de senha pode ser '''interrompido ou não concluído corretamente''';
:* ❌ Eventos internos deixam de ser disparados no tempo esperado.
* O usuário pode ficar impossibilitado de recuperar o acesso ao sistema Desktop.
:* ❌ Impacto direto em funcionalidades que dependem de eventos assíncronos.


'''Impacto na A2F'''
=Conclusão=
:* A '''A2F''' depende do processamento correto de eventos internos.
A configuração do BatchPaintTime como <code>0</code> impacta não apenas processos batch e a funcionalidade '''A2F''', mas também '''funcionalidades críticas de autenticação''', como a '''recuperação de senha no Desktop''', reforçando que este valor '''não é suportado'''.
:* 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:'''
=Recomendação=
: Definir o NL do BatchPaintTime como 0 é considerado '''configuração incorreta'''.
Não utilizar o valor '''0''' para o parâmetro '''BatchPaintTime'''.


=Exemplo de configuração correta (magic.ini)=
=Exemplo de configuração correta (magic.ini)=
Linha 46: Linha 55:
   BatchPaintTime=1000
   BatchPaintTime=1000


'''Observações importantes'''
'''Observações'''
:* O valor <code>0</code> '''não significa execução imediata''' — significa '''desativar o mecanismo de polling'''.
:* O valor <code>0</code> '''não representa execução imediata''', mas sim a '''desativação do processamento de eventos batch'''.
:* Mesmo em processos batch sem interface gráfica, o Magic '''continua dependendo de eventos internos'''.
:* Mesmo processos batch sem interface gráfica dependem do processamento de eventos internos.
:* Alterações nesse NL devem ser feitas '''com cautela''', principalmente em ambientes produtivos.
:* Alterações nesse parâmetro devem ser realizadas com cautela em ambientes de produção.

Edição atual tal como às 19h21min de 2 de fevereiro de 2026

Voltar

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

Objetivo

Definir o intervalo de tempo (em milissegundos) em que o Magic xpa engine realiza o processamento (polling) de eventos pendentes durante a execução de processos batch.

Descrição

O parâmetro BatchPaintTime controla o tempo em que o engine do Magic verifica e processa eventos internos enquanto uma tarefa batch está em execução.
Esses eventos incluem:

  • Eventos de sistema
  • Timers internos
  • Processamento assíncrono necessário para fluxos de execução
  • Funcionalidades dependentes de eventos, como A2F

De acordo com a documentação oficial do Magic xpa, o engine realiza o polling de eventos com base no Batch Event Interval e no Record Event Interval, sendo acionado sempre que um desses intervalos é atingido.

Valor padrão do Magic xpa: 1000 ms

Impacto da configuração do NL = 0

Quando o NL do BatchPaintTime é configurado com valor 0 no magic.ini, o comportamento do engine é alterado de forma incorreta.

Efeitos observados:

  • O mecanismo de polling de eventos batch é desativado
  • Eventos internos deixam de ser processados no tempo esperado
  • O engine não executa corretamente fluxos dependentes de eventos
  • O comportamento assíncrono da aplicação é comprometido

Impacto na funcionalidade A2F

A funcionalidade A2F depende do correto processamento de eventos internos do Magic.

Com o BatchPaintTime = 0:

  • O NL não é iniciado corretamente;
  • O fluxo da A2F pode não ser disparado;
  • Podem ocorrer travamentos ou interrupções no processamento;
  • O resultado do batch pode ser inconsistente ou incorreto.

Impacto na recuperação de senha - Desktop

A funcionalidade de recuperação de senha no Desktop também depende do correto processamento de eventos internos do Magic para executar o fluxo de validação e envio de e-mail ao usuário.

Com o BatchPaintTime = 0:

  • Eventos responsáveis pelo disparo do processo de recuperação de senha podem não ser processados;
  • O envio do e-mail de recuperação de senha pode falhar ou não ocorrer;
  • O fluxo de redefinição de senha pode ser interrompido ou não concluído corretamente;
  • O usuário pode ficar impossibilitado de recuperar o acesso ao sistema Desktop.

Conclusão

A configuração do BatchPaintTime como 0 impacta não apenas processos batch e a funcionalidade A2F, mas também funcionalidades críticas de autenticação, como a recuperação de senha no Desktop, reforçando que este valor não é suportado.

Recomendação

Não utilizar o valor 0 para o parâmetro BatchPaintTime.

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

 [MAGIC_LOGICAL_NAMES]
 BatchPaintTime=1000

Observações

  • O valor 0 não representa execução imediata, mas sim a desativação do processamento de eventos batch.
  • Mesmo processos batch sem interface gráfica dependem do processamento de eventos internos.
  • Alterações nesse parâmetro devem ser realizadas com cautela em ambientes de produção.
Disponível em “https://www.cigam.com.br/wiki/index.php?title=BatchPaintTime&oldid=155149”