Como funciona a digitalização em lote
Última atualização: 14/10/2026O QV2QS descobre projetos do QlikView automaticamente ao escanear diretórios recursivamente.
Varredura recursiva de diretórios
O QV2QS varre o diretório de lote recursivamente, percorrendo todas as subpastas para encontrar arquivos de projeto do QlikView. O scanner procura tanto arquivos .qvw quanto .qvf. O QlikView 12.70 e versões posteriores podem salvar documentos como .qvf por padrão, portanto, o scanner verifica ambas as extensões para evitar ignorar arquivos em ambientes onde o formato foi alterado. Para mais detalhes sobre os formatos QVW e QVF, consulte Requisitos do sistema.
Para cada arquivo QVW ou QVF encontrado, o QV2QS procura um artefato PRJ correspondente no mesmo diretório:
- Uma pasta PRJ (
<Name>-prj/) - Um arquivo ZIP PRJ (
<Name>-prj.zip)
Os nomes devem coincidir (sem distinção entre maiúsculas e minúsculas). Se existirem uma pasta PRJ e um arquivo zip PRJ para o mesmo arquivo de origem, a pasta terá prioridade. Arquivos de origem sem um artefato PRJ correspondente são relatados nos resultados da verificação como ausentes.
O QV2QS ignora diretórios comuns que não são do projeto durante a verificação: .git, .svn, .hg, node_modules, build, dist, venv, __pycache__ e diretórios que começam com um ponto. O diretório de saída também é excluído se o caminho de saída estiver dentro da raiz da varredura.
Os resultados são ordenados por caminho relativo do diretório e nome do arquivo para uma ordenação previsível.
Verificando vários diretórios
Analise vários diretórios separando os caminhos com ponto e vírgula. O QV2QS desduplica caminhos aninhados automaticamente. Se um caminho for um subdiretório de outro, apenas o caminho pai é escaneado.
QV2QS.exe --batchDir "C:\Projects\Region1;C:\Projects\Region2" --outputDir C:\Output --unbuildOnly
Varredura na interface Web
A interface web fornece um fluxo de trabalho visual de varredura em lote na etapa Projeto. Insira um ou mais caminhos de pasta no campo de diretório em lote e clique em Verificar pasta(s). Os resultados da varredura aparecem em um modal com duas visualizações:
- Visualização em árvore — Uma árvore hierárquica de pastas com expandir/recolher. Cada pasta exibe as contagens do total de QVWs, projetos emparelhados e pastas PRJ ausentes. Use Expandir tudo e Recolher tudo para navegar em árvores grandes.
- Visualização em lista — Uma tabela plana com as mesmas colunas, ordenada pelo caminho da pasta. Uma linha de resumo na parte inferior exibe os totais.
O cabeçalho do modal exibe contagens de KPI: total de pares, PRJs ausentes e total de QVWs. Quando a geração automática de PRJ estiver ativada, as entradas de PRJ ausentes exibem um indicador de geração automática.
Use o campo de busca para filtrar os resultados por nome ou caminho. Selecione subpastas específicas usando as caixas de seleção para incluir apenas essas pastas no lote. Uma seleção vazia inclui todas as pastas. Clique em Aceitar para aplicar a seleção (o botão muda para Aceitar alterações quando a seleção for diferente da digitalização original). O modal pode ser maximizado para uma visualização em tela cheia em grandes árvores de diretórios.