# QlikView Desktop 問題

## QlikView 實例衝突

可能的原因

另一個 QlikView 處理程序已在執行中。QV2QS 需要獨佔存取 QlikView Desktop 以進行 PRJ 產生。主控台顯示`Close any running QlikView instances and retry.`

建議的行動

關閉所有正在執行的 QlikView 實例。如果該處理程序沒有顯示在工作列中，請開啟工作管理員並結束任何 `Qv.exe` 處理程序。然後重試轉換。

## PRJ 產生逾時

可能的原因

QVW 檔案非常大或磁碟速度很慢。PRJ 生成的逾時時間固定為每個檔案 10 分鐘。逾時無法透過 CLI 或精靈設定。

建議的行動

請確認有足夠的磁碟空間，因為 PRJ 產生所需的暫存空間會與 QVW 檔案大小成比例。在 QlikView Desktop 中開啟 QVW 檔案，檢查其是否未損毀。在批次模式下，使用 `--batchWorkers 1` 減少平行工作者的數量，以釋放磁碟和 CPU 資源。使用 `--logLevel DEBUG` 以擷取記錄檔中詳細的 PRJ 產生時間。

## PRJ 生成在批次模式下失敗，沒有錯誤詳細資訊

可能的原因

QV2QS 無法找到 QlikView Desktop 引擎。捆綁的引擎可能未正確解壓縮，且沒有 QlikView Desktop 的系統安裝已註冊。批次 PRJ 產生會在處理任何檔案之前，檢查是否有可用的引擎。如果找不到引擎，所有檔案都會標記為失敗，且批次會繼續執行，但不包含 PRJ 資料夾。

建議的行動

打開系統日誌位於 `%LOCALAPPDATA%\QV2QS\qv2qs.log` 並搜尋 `No QlikView Desktop found` 或 `Batch PRJ prerequisites`。這些項目記錄了偵測到哪個引擎，以及先決條件檢查是否通過。如果沒有可用的引擎，請在系統上安裝 QlikView Desktop，或透過重新下載來驗證 QV2QS 可執行檔沒有損壞。搭配 `--logLevel DEBUG` 執行，以擷取完整的引擎探索路徑。

## 無法開啟 QVW 或 QVF

可能的原因

QV2QS 找到了 QlikView Desktop 引擎，但 QlikView 無法開啟文件。主控台顯示 `Could not open QVW` 或 `Could not open QVF`，後面接著診斷訊息。產生此錯誤有三個條件：

* 區段存取鎖定 — 文件使用區段存取，且執行 QV2QS 的 Windows 帳戶在區段存取表格中沒有 ADMIN 存取權限，或具有 USER 存取權限，但未在「文件屬性」>「安全性」中啟用存取文件屬性 (使用者)。QV2QS 在錯誤訊息中顯示執行帳戶 (`DOMAIN\USER`)。QVF 檔案不強制執行文件屬性限制，因此此原因主要適用於 QVW 檔案。
* 未授權的 QlikView Desktop — 偵測到系統已安裝 QlikView Desktop，但未授權。QlikView 靜默地拒絕開啟任何文件。這會覆寫隨附的預授權引擎，因為 QV2QS 在有註冊時會偏好系統安裝。
* 損毀或無法讀取的檔案 — QVW 或 QVF 檔案已損壞、已由其他程序鎖定，或儲存在無法存取的網路共用上。

建議的行動

檢查錯誤訊息以找出最可能的原因。如果指示區段存取：

1. 使用在區段存取表格中具有 ADMIN 存取權的帳戶，在 QlikView Desktop 中開啟 QVW。
2. 前往 文件屬性 > 安全性 並確認 存取文件屬性 (使用者) 已啟用。
3. 或者，在具有管理員級別區段存取的帳戶下執行 QV2QS。

如果顯示需要授權，請解除安裝或授權 QlikView Desktop，或在未安裝 QlikView 的機器上執行 QV2QS 以使用隨附的預先授權引擎。

如果檔案可能已損毀，請嘗試直接在 QlikView Desktop 中開啟檔案以驗證檔案。執行 `--logLevel DEBUG` 並查看日誌以取得詳細診斷資訊。

## 了解更多

* [QlikView 桌面引擎](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/qlikview-desktop-engine.htm)
* [自動 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/command-line-interface/logging-and-diagnostics.htm)