How batch scanning works
QV2QS discovers QlikView projects automatically by scanning directories recursively.
Recursive directory scanning
QV2QS scans the batch directory recursively, traversing every subfolder to find QlikView project files. The scanner looks for both .qvw and .qvf files. QlikView 12.70 and later can save documents as .qvf by default, so the scanner checks for both extensions to avoid missing files in environments where the format has been changed. For more detail on QVW and QVF formats, see System requirements.
For each QVW or QVF file found, QV2QS looks for a matching PRJ artifact in the same directory:
- A PRJ folder (
<Name>-prj/) - A PRJ zip file (
<Name>-prj.zip)
The names must match (case-insensitive). If both a PRJ folder and a PRJ zip exist for the same source file, the folder takes priority. Source files without a matching PRJ artifact are reported in the scan results as missing.
QV2QS skips common non-project directories during scanning: .git, .svn, .hg, node_modules, build, dist, venv, __pycache__, and directories starting with a period. The output directory is also excluded if the output path falls inside the scan root.
Results are sorted by relative directory path and file name for predictable ordering.
Scanning multiple directories
Scan multiple directories by separating paths with a semicolon. QV2QS deduplicates nested paths automatically. If one path is a subdirectory of another, only the parent path is scanned.
QV2QS.exe --batchDir "C:\Projects\Region1;C:\Projects\Region2" --outputDir C:\Output --unbuildOnly
Scanning in the web UI
The web UI provides a visual batch scan workflow on the Project step. Enter one or more folder paths in the batch directory field and click Scan folder(s). The scan results appear in a modal with two views:
- Tree view — A hierarchical folder tree with expand/collapse. Each folder displays counts for total QVWs, paired projects, and missing PRJ folders. Use Expand all and Collapse all to navigate large trees.
- List view — A flat table with the same columns, sorted by folder path. A summary row at the bottom shows totals.
The modal header displays KPI counts: total pairs, missing PRJ, and total QVWs. When automatic PRJ generation is enabled, missing PRJ entries display an auto-generate indicator.
Use the search field to filter results by name or path. Select specific subfolders using the checkboxes to include only those folders in the batch. An empty selection includes all folders. Click Accept to apply the selection (the button changes to Accept changes when the selection differs from the original scan). The modal can be maximized for a full-screen view on large directory trees.