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 de Colaborador) 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 de Colaborador — aparece bloqueado para planos sem acesso. |
| Botão “Limpar Histórico” | Abre um modal com opções para limpar a coleta desta pesquisa. | Recurso de Colaborador. Dois modos — “manter avaliados” ou “apagar tudo” — nunca apaga sua estratégia de busca. Veja detalhes no tópico logo abaixo. |
| 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. |
Cota da Chave de API no Card de Cada Base
No cabeçalho de cada card de base, ao lado dos chips de sucesso e erro, aparece um chip que mostra o consumo da cota da chave de API usada naquela base científica.
Informação
A cota pertence à chave de API, não à pesquisa: o mesmo saldo é compartilhado entre todas as suas pesquisas que usam a mesma chave — e qualquer outro uso dela, inclusive em outro computador. O consumo feito numa pesquisa é descontado do saldo que aparece nas demais.
O chip é atualizado de forma passiva, a partir dos cabeçalhos de resposta devolvidos pela própria base a cada busca real — não existe botão de atualização manual. Bases sem cota semanal, como CrossRef e PubMed, não exibem este chip (elas só têm limite de requisições por segundo).
Os 6 estados do chip
| Estado | Quando aparece | Texto do chip |
|---|---|---|
| Saudável (verde) | Restante acima de 20% do limite da chave | ”Cota da chave {restante}/{limite}“ |
| Alerta (âmbar) | Restante igual ou abaixo de 20% do limite | ”Cota da chave {restante}/{limite} · reset {data}“ |
| Esgotada (vermelho) | A base respondeu com erro de cota excedida | ”Cota esgotada · reset {data}” (ou só “Cota esgotada”, se a base não informar a data de reset) |
| Créditos/orçamento | Bases que cobram por crédito ou orçamento monetário (ex.: OpenAlex) | “Créditos/orçamento restantes: {valor}“ |
| Nunca observada (tracejado) | A chave ainda não fez nenhuma busca real nesta instalação | ”Cota documentada {valor}/semana · não observada” — mostra o teto informado pela base, não um valor medido |
| Contagem local (Web of Science) | A base não informa a cota restante da chave | ”Hoje via este app: {quantidade} req” — conta só as requisições enviadas por este app, hoje; uso da mesma chave em outro lugar não aparece aqui |
Ao passar o mouse sobre o chip, uma dica detalha o valor observado, a data do último registro e a data de reset (quando houver), reforçando que a cota é compartilhada entre pesquisas.
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.
Banner de erros classificados no topo do painel
Além do card “Erros”, determinados tipos de falha disparam um banner no topo da área de progresso, agrupando as bases afetadas por classe de erro:
- Expressão rejeitada: “N busca(s) rejeitada(s) pela(s) base(s) X — revise a expressão de busca.”
- Falha de autorização: “Falha de autorização em X — verifique a chave de API ou a rede institucional.”
- Cota/créditos esgotados: “Cota/créditos esgotados em X — a cota pertence à chave e é compartilhada entre todas as suas pesquisas.”
O banner aparece uma vez por classe de erro (bases repetidas são agrupadas) e continua visível mesmo depois que a coleta termina. Ao surgir um conjunto novo de erros, a tela rola até o banner e o foca automaticamente — isso acontece uma única vez por conjunto de erros, não a cada atualização de 3 segundos.
Atenção
Erros de limite de taxa, falha de rede ou “sem resultados” não geram este banner — eles aparecem só na coluna de status de cada busca, na tabela detalhada por base.
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 Colaborador. 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.
O que acontece ao clicar em “Limpar Histórico”?
O botão abre um modal de confirmação que mostra, antes de apagar, o que sai e o que fica. Há dois modos:
- Manter avaliados (recomendado): remove as buscas e os vínculos de documentos ainda não avaliados, mas preserva os documentos já triados por você ou pela IA.
- Apagar tudo: remove também os documentos avaliados, incluindo a triagem já feita. Por ser mais drástico, exige uma segunda confirmação explícita, com os números reais do que será apagado.
Em qualquer um dos dois modos, sua estratégia de busca (expressões, palavras-chave, bases, anos, tetos), o protocolo e os critérios de inclusão/exclusão nunca são apagados — “Limpar Histórico” afeta só a coleta.
Informação
No modo “Apagar tudo”, os documentos já avaliados não somem de vez: ao rodar uma nova coleta, o sistema tenta reencontrar e reconectar automaticamente a decisão de triagem de cada um. Os que não forem reencontrados aparecem numa lista de reconciliação, onde você decide mantê-los como “outra fonte” (contagem PRISMA) ou removê-los.
Já consolidei, mas coletei mais documentos depois — preciso fazer algo?
Se você coletar documentos novos (nova busca, retomada ou importação manual) depois de já ter rodado a Consolidação, um banner aparece avisando:
“Há N documentos coletados após a última consolidação — é fortemente sugerido executar a Consolidação novamente para evitar triagem duplicada.”
Isso acontece porque os documentos novos ainda não passaram pela deduplicação entre bases — seguir direto para a Triagem sem reconsolidar pode fazer você avaliar o mesmo documento mais de uma vez.
- O que fazer: volte para a aba Consolidação e rode a consolidação novamente antes de avançar para a Triagem.
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, Colaborador) 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.