Capturador
Capturador Manual
O Capturador Manual é utilizado quando o processo precisa ser acionado de forma pontual por outro mecanismo, como uma ação específica do sistema ou uma intervenção operacional. Nesse modo, o componente executa a captura de maneira controlada, processando no máximo um registro por chamada.
Cada execução depende de um identificador explícito — normalmente um parâmetro como token — que define exatamente qual item deve ser capturado. Essa abordagem é especialmente indicada para cenários de correção, reprocessamento ou tratamento direcionado de registros específicos, sem depender do ciclo automatizado.
Capturador Automático
O Capturador Automático é executado periodicamente por um agendador de tarefas (cron) e tem como responsabilidade identificar e capturar múltiplos registros novos ou alterados com base em critérios predefinidos.
Para garantir continuidade segura entre execuções, o componente mantém mecanismos de controle de estado, como offset, chave de posição, filtros e status de processamento. Isso assegura que o fluxo avance sem perdas de posição ou duplicidades.
Durante o processamento, os registros são consultados de forma paginada, tratados conforme as regras definidas e encaminhados para a Queue, onde aguardam processamento assíncrono. Essa estratégia reduz sobrecarga, melhora a estabilidade e permite escalabilidade do fluxo.
Capturador Manual / Automático
O Capturador Manual / Automático representa um modelo híbrido em que o mesmo componente pode operar nos dois modos.
Quando acionado manualmente, realiza capturas pontuais e controladas, geralmente limitadas a um único registro identificado por token. Quando executado automaticamente, processa registros em lote de forma contínua via agendamento.
Essa combinação oferece flexibilidade operacional, permitindo tanto a automação do processamento regular quanto intervenções específicas quando necessário, sem a necessidade de componentes distintos.