批次掃描的運作方式
上次更新：2026/10/14QV2QS 透過遞迴掃描目錄來自動探索 QlikView 專案。
遞迴目錄掃描
QV2QS 會遞迴掃描批次目錄，遍歷每個子資料夾以尋找 QlikView 專案檔案。掃描器會尋找 .qvw 與 .qvf 檔案。QlikView 12.70 及更新版本預設可將文件儲存為 .qvf，因此掃描器會檢查這兩種副檔名，以避免在格式已變更的環境中遺漏檔案。如需關於 QVW 和 QVF 格式的詳細資訊，請參閱系統需求。
針對找到的每個 QVW 或 QVF 檔案，QV2QS 會在同一個目錄中尋找相符的 PRJ 成品：
- PRJ 資料夾 (
<Name>-prj/) - PRJ zip 檔案 (
<Name>-prj.zip)
名稱必須相符（不區分大小寫）。若同一個來源檔案同時存在 PRJ 資料夾與 PRJ zip 檔，則以該資料夾為優先。沒有相符 PRJ 成品的原始檔會在掃描結果中回報為遺失。
QV2QS 在掃描期間會略過常見的非專案目錄：.git、.svn、.hg、node_modules、build、dist、venv、__pycache__，以及以句點開頭的目錄。如果輸出路徑位於掃描根目錄內，輸出目錄也已排除。
結果會依相對目錄路徑和檔案名稱排序，以提供可預測的順序。
掃描多個目錄
使用分號分隔路徑以掃描多個目錄。QV2QS 會自動去除重複的巢狀路徑。若其中一個路徑是另一個路徑的子目錄，則只會掃描父路徑。
QV2QS.exe --batchDir "C:\Projects\Region1;C:\Projects\Region2" --outputDir C:\Output --unbuildOnly
在 Web UI 中掃描
Web UI 在專案步驟中提供視覺化批次掃描工作流程。在批次目錄欄位中輸入一個或多個資料夾路徑，然後按一下 掃描資料夾。掃描結果會顯示在具有兩個檢視的強制回應視窗中：
- 樹狀檢視 — 具有展開/摺疊功能的階層式資料夾樹。每個資料夾都會顯示 QVW 總數、已配對專案以及遺失的 PRJ 資料夾數量。使用 全部展開 與 全部收合 來導覽大型樹狀結構。
- 清單檢視 — 具有相同欄位的扁平表格，依資料夾路徑排序。底部的彙總列會顯示總計。
強制回應視窗標題會顯示 KPI 計數：配對總數、缺少的 PRJ 以及 QVW 總數。當啟用自動產生 PRJ 時，缺少的 PRJ 項目會顯示自動產生指示器。
使用搜尋欄位依名稱或路徑篩選結果。使用核取方塊選取特定子資料夾，以僅在批次中包含這些資料夾。未選取任何項目時會包含所有資料夾。按一下 接受 以套用選取項目 (當選取內容與原始掃描不同時，此按鈕會變更為 接受變更)。此強制回應視窗可最大化，以全螢幕檢視大型目錄樹狀結構。