# 批次掃描的運作方式

QV2QS 透過遞迴掃描目錄來自動探索 QlikView 專案。

## 遞迴目錄掃描

QV2QS 會遞迴掃描批次目錄，遍歷每個子資料夾以尋找 QlikView 專案檔案。掃描器會尋找 `.qvw` 與 `.qvf` 檔案。QlikView 12.70 及更新版本預設可將文件儲存為 `.qvf`，因此掃描器會檢查這兩種副檔名，以避免在格式已變更的環境中遺漏檔案。如需關於 QVW 和 QVF 格式的詳細資訊，請參閱[系統需求](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/system-requirements.htm)。

針對找到的每個 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 項目會顯示自動產生指示器。

使用搜尋欄位依名稱或路徑篩選結果。使用核取方塊選取特定子資料夾，以僅在批次中包含這些資料夾。未選取任何項目時會包含所有資料夾。按一下 接受 以套用選取項目 (當選取內容與原始掃描不同時，此按鈕會變更為 接受變更)。此強制回應視窗可最大化，以全螢幕檢視大型目錄樹狀結構。

## 瞭解詳情

* [自動產生 PRJ](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/batch-conversion/automatic-prj-generation.htm)
* [平行執行](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/batch-conversion/parallel-execution.htm)
* [輸出結構與應用程式命名](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)