Fase 3 — Coleta
A Coleta é o momento em que as expressões de busca definidas na Fase 2 saem do papel e são efetivamente enviadas às bases científicas selecionadas. O Tykyra orquestra essa execução de forma automática e monitora o progresso em tempo real, produzindo um registro auditável de cada chamada realizada. Para bases que não possuem integração direta via API, a importação manual de arquivos permite que os documentos sejam incorporados ao mesmo fluxo, garantindo que toda a evidência relevante parta de um ponto único e rastreável.
Coleta Automática nas Bases Científicas
A aba de coleta automática exibe quatro indicadores que acompanham o estado do processo em tempo real: Coletados (documentos armazenados com sucesso), Concluídas (expressões já executadas), Erros (chamadas que falharam) e Pendentes (expressões ainda na fila). O sistema realiza polling a cada três segundos enquanto a execução está ativa e para automaticamente quando não restam itens pendentes ou em processamento.
O pesquisador pode iniciar e pausar a coleta a qualquer momento. Ao pausar, o Tykyra aguarda 15 segundos para sincronizar os dados e executa uma auditoria automática de consistência: compara o somatório do histórico de chamadas com a contagem de documentos efetivamente gravados no banco, detectando discrepâncias antes de qualquer avanço.
O funil de coleta — disponível como gráfico e tabela, exportável em PNG ou SVG — apresenta o volume retornado por cada base e por cada expressão de busca. Esse funil compõe a seção de resultados da busca exigida pelo PRISMA 2020 no relato final.
O botão "Concluir Coleta" só é habilitado quando não há expressões pendentes e o histórico de chamadas contém ao menos um registro. Não há validação de contagem mínima de documentos — é possível concluir com zero retornos caso as expressões não tenham produzido resultados nas bases configuradas.
Tela correspondente: Coleta
Importação de Bases Manuais
Algumas bases científicas relevantes não oferecem API de busca direta. Para esses casos, o Tykyra permite importar os resultados exportados diretamente dessas plataformas, nos formatos CSV, XLS, XLSX, RIS e BIB, integrando-os ao mesmo fluxo da coleta automática.
O processo de importação segue três passos:
- Configuração da base manual: o pesquisador define o nome da base, o formato do arquivo e realiza o mapeamento de colunas — indicando quais colunas do arquivo correspondem a Título, Resumo, Autores, Ano, DOI e demais campos disponíveis. O Tykyra exibe uma pré-visualização dos dados para confirmar o mapeamento antes de salvar. São campos obrigatórios para salvar uma configuração: nome, coluna de título, coluna de ano e coluna de DOI.
- Associação a expressões de busca: cada importação é vinculada a uma ou mais expressões da Fase 2, com a opção de registrar um ano de referência específico ou usar "Geral" (sem filtro de ano). "Geral" não pode coexistir com anos específicos na mesma importação.
- Processamento e importação: o Tykyra processa os arquivos selecionados e incorpora os documentos ao banco da pesquisa. Se o volume de documentos atingir o limite do plano, o sistema realiza uma importação parcial — incorpora o que cabe dentro do orçamento restante do projeto e informa o pesquisador, em vez de rejeitar o arquivo inteiro.
O histórico de importações manuais registra, por base, cada lote processado: expressão vinculada, número de documentos coletados, data e status. Para limites de bases e de documentos por upload, consulte Planos e Perfis de Acesso.
Tela correspondente: Bases Manuais
Entradas, Processamento e Saídas
- Entradas: expressões de busca salvas na Fase 2 (já traduzidas para a sintaxe de cada base); opcionalmente, arquivos exportados de bases manuais (CSV, XLS, XLSX, RIS, BIB) com mapeamento de colunas configurado.
- Processamento: execução orquestrada das buscas nas bases selecionadas com polling de progresso e auditoria de consistência pós-pausa; importação e conciliação de bases manuais, com importação parcial ao atingir o limite do plano.
- Saídas: documentos brutos coletados, organizados por base e por expressão de busca, prontos para a Fase 4 (Consolidação); histórico de chamadas auditável por base.
Decisões Metodológicas
| Decisão | Justificativa |
|---|---|
| Auditoria automática de consistência ao pausar a coleta | Detectar discrepâncias entre chamadas realizadas e documentos gravados antes de avançar, evitando que falhas silenciosas de sincronização comprometam a base de dados |
| Importação parcial ao atingir o limite de documentos | Manter o comportamento consistente com a coleta automática (que já limitava por expressão e por projeto) e evitar que o pesquisador perca dados importáveis por ultrapassar o teto global por uma margem pequena |
| Registro do histórico de chamadas por base e por expressão | Garantir rastreabilidade completa da estratégia de busca executada, exigida para o relato de métodos no PRISMA 2020 |
Próximos Passos
Com a coleta concluída — automática, manual ou a combinação das duas —, o pesquisador avança para a Fase 4 — Consolidação e Enriquecimento, onde os documentos coletados nas diferentes bases são deduplicados e, opcionalmente, enriquecidos com metadados adicionais. Veja Fase 4 — Consolidação.
Referências
O registro do histórico de chamadas por base e expressão — quantos documentos cada combinação retornou, quais falharam e por quê — é parte do relato de estratégia de busca exigido pelo PRISMA 2020 (itens 7 e 8), permitindo que terceiros avaliem a abrangência e a consistência da coleta.