Coleta de Dados — Busca Automática
Esta é a aba de coleta automática do painel de Coleta de Dados (Etapa 3). Aqui o sistema executa as expressões de busca que você montou nas etapas anteriores diretamente nas bases científicas configuradas, e você acompanha o progresso em tempo real.
Sobre este painel: A Etapa 3 tem três abas — Coleta Automática (esta tela), Bases Manuais e Consolidação. O painel de Coleta de Dados é o mesmo para as três; você alterna entre as abas conforme a necessidade.
📸 Clique para ver o painel de Coleta Automática
O que você pode fazer nesta tela?
- Iniciar e acompanhar a busca automática nas bases científicas cadastradas nas suas expressões.
- Pausar a coleta se precisar interrompê-la temporariamente.
- Monitorar o progresso por meio de quatro contadores (Coletados, Concluídas, Erros e Pendentes) e do funil de coleta.
- Visualizar o funil e as estatísticas de documentos por base e por expressão.
- Concluir a coleta quando todas as buscas estiverem finalizadas, habilitando a próxima etapa.
- Exportar o funil como imagem (PNG ou SVG) para uso em relatórios.
- Acessar o Visualizador de Dados (recurso premium) para inspecionar os documentos coletados antes da consolidação.
Elementos da Interface
| Elemento | O que é / Para que serve | Observações Importantes |
|---|---|---|
| Card "Coletados" | Total de documentos recuperados das bases até o momento. | Aumenta em tempo real durante a coleta. |
| Card "Concluídas" | Quantas buscas (combinação de expressão + base) já foram finalizadas. | Uma busca "concluída" pode ter retornado zero resultados — isso é normal para algumas bases. |
| Card "Erros" | Buscas que falharam por algum problema de comunicação com a base. | Erros pontuais são comuns; buscas com erro podem ser reprocessadas em uma nova coleta. |
| Card "Pendentes" | Buscas ainda na fila, aguardando processamento. | Quando chegar a zero, a coleta terminou. |
| Botão "Iniciar Coleta" | Dispara o processo de busca automática em todas as bases pendentes. | Fica bloqueado por 10 segundos após o clique (proteção contra duplo clique). |
| Botão "Pausar Coleta" | Solicita a pausa do processo em andamento. | Após o clique, o sistema aguarda até 15 segundos para sincronizar os dados antes de parar de fato. |
| Botão "Concluir Coleta" | Registra a etapa como concluída e libera a aba de Consolidação. | Só aparece quando não há buscas pendentes e o histórico tem ao menos um registro. |
| Botão "Ver Dados" | Abre o Visualizador de Coleção em janela separada. | Recurso premium — aparece bloqueado para planos sem acesso. |
| Botão "Limpar Histórico" | Remove o histórico de chamadas às bases. | Recurso premium. Não apaga os documentos coletados, apenas o log das chamadas. |
| Seção Funil | Gráfico e tabela que mostram os documentos em cada estágio da coleta por base. | Pode ser exportado como PNG ou SVG. |
| Tabela de status por base | Lista cada base com o status atual da busca (pendente, em andamento, concluída, erro). | Útil para identificar quais bases tiveram problemas. |
Cenários de Erro e Estados Especiais
A coleta está demorando muito
📸 Ver coleta em progresso
O tempo de coleta depende do número de bases, da quantidade de expressões e da disponibilidade de cada base científica. Buscas com muitos resultados ou bases com latência elevada naturalmente levam mais tempo. Enquanto houver pendentes, o sistema continua trabalhando.
- O que fazer: Aguarde o card "Pendentes" chegar a zero. Você pode deixar o aplicativo aberto em segundo plano — a coleta continua rodando.
Apareceu um número alto de Erros
Erros indicam que uma ou mais chamadas à base científica falharam (timeout, base indisponível, limite de requisições etc.).
- O que fazer: Após a coleta terminar, você pode clicar em "Iniciar Coleta" novamente — o sistema reprocessará apenas as buscas que falharam, sem duplicar os documentos já coletados.
Pausei a coleta — posso retomar sem perder ou duplicar documentos?
Sim. A coleta é retomável e segura: ao clicar em "Iniciar Coleta" novamente (após uma pausa, um erro ou até depois de fechar e reabrir o aplicativo), cada base continua de onde parou, não recomeça do zero.
- Sem perda: o progresso de cada busca é registrado a cada página de resultados processada. O ponto de retomada só avança depois que os documentos daquela página são efetivamente salvos.
- Sem duplicatas: se uma página chegou a ser buscada novamente (por exemplo, após uma queda no meio do processo), o sistema reconhece os documentos repetidos e não os duplica.
- Vale para todas as bases (PubMed, Scopus, Web of Science, OpenAlex etc.) — o mecanismo de retomada é o mesmo para todas.
Observação técnica: em casos raros, se o conteúdo da base científica mudar entre a pausa e a retomada (um novo artigo indexado, por exemplo), pode haver uma pequena variação de 1 ou 2 registros na fronteira da página retomada. É uma característica inerente à paginação das bases, não uma falha do aplicativo.
O botão "Concluir Coleta" não aparece
O botão só fica visível quando todas as condições abaixo são atendidas simultaneamente:
- Não há buscas pendentes (card "Pendentes" = 0).
- A coleta não está em andamento.
- Há ao menos um registro no histórico de chamadas.
Se o botão não aparece mesmo após a coleta terminar, verifique se ainda há pendentes ou se a coleta foi pausada antes de terminar.
O botão "Ver Dados" está bloqueado
O Visualizador de Coleção é um recurso do plano premium. Se o seu plano atual não inclui este recurso, o botão aparece desabilitado.
- O que fazer: Consulte a página de Planos e Perfis para ver as opções disponíveis.
Comportamentos Automáticos
- Atualização em tempo real: Os cards de estatísticas e a tabela de status são atualizados automaticamente a cada 3 segundos enquanto a coleta está em andamento. Você não precisa recarregar a tela.
- Parada automática: Quando todas as buscas pendentes são processadas, a coleta se encerra sozinha — mesmo que você não clique em pausar. O sistema detecta que não há mais trabalho e para.
- Auditoria pós-pausa: Ao pausar a coleta, o sistema aguarda 15 segundos e depois compara internamente o total de documentos registrados com o histórico de chamadas, para garantir que nenhum registro foi perdido.
Como as informações são processadas?
Como a coleta automática funciona
Cada expressão de busca que você montou na Etapa 2 é enviada para cada base científica que você configurou. O resultado é uma fila de tarefas (uma por combinação expressão × base). O sistema processa essa fila em paralelo, buscando e salvando os documentos retornados.
O progresso que você vê nos cards reflete:
- Coletados: documentos efetivamente salvos no seu projeto.
- Concluídas: tarefas da fila que foram processadas (com ou sem resultado).
- Erros: tarefas que falharam e precisam ser reprocessadas.
- Pendentes: tarefas ainda aguardando processamento.
O funil de coleta
O funil mostra quantos documentos foram recuperados em cada base e em cada expressão, permitindo comparar o rendimento relativo das suas estratégias de busca. Ele é uma ferramenta útil para a documentação metodológica da sua revisão (incluindo relatórios no estilo PRISMA).
Fluxo de Passos
- Abra a Etapa 3 a partir do painel da sua pesquisa. Você estará automaticamente na aba de Coleta Automática.
- Clique em "Iniciar Coleta" para disparar as buscas nas bases científicas.
- Acompanhe o progresso pelos cards de estatísticas e pela tabela de bases. O sistema atualiza sozinho a cada 3 segundos.
- Aguarde o card "Pendentes" chegar a zero. Se houver erros, clique em "Iniciar Coleta" novamente para reprocessar as buscas que falharam.
- Revise o funil e as estatísticas para entender a distribuição dos documentos por base.
- (Opcional, premium) Clique em "Ver Dados" para abrir o Visualizador de Coleção e inspecionar os documentos antes de consolidar.
- Clique em "Concluir Coleta" quando estiver satisfeito com os resultados. Isso registra a etapa e habilita a aba de Consolidação.