引數參考

上次更新：2026/10/14

下表列出所有可用的引數，並依類別分組。

輸入與輸出

批次模式

Qlik Cloud

驗證

版面配置與樣式

關於固定畫布和動態格線模式的詳細說明，請參閱轉換版面配置設定。

轉換報告

主控台報告和 Excel 報告在 CLI 模式和使用者介面中預設皆已啟用。

主控台與記錄

QV2QS 支援四種主控台輸出模式。

• 美觀 — 格式豐富的輸出，具備色彩、動畫旋轉器、進度條和主題面板。美觀模式是互動式終端機使用的預設值。需要支援彩色的終端機 (Windows 10 以上、PowerShell 5 以上，或類 Unix 的 Shell)。
• 純文字 — 附帶時間戳記的文字輸出，不含 ANSI 跳脫碼。每一行都以耗時戳記和階段標籤為前綴，其格式為 [MM:SS] [phase] message。標頭和表格使用 ASCII 字元。適用於 CI/CD 管線、日誌檔案以及不支援 ANSI 格式的終端機。
• 靜默 — 抑制所有標準輸出。僅顯示錯誤。適用於自動化批次處理和不需要主控台輸出的指令碼工作流程。
• UI — 逐行輸出，不含時間戳記或 ANSI 碼。使用者介面會在啟動轉換子程序時自動設定此模式。此格式已針對內嵌記錄檢視器進行最佳化。從終端機執行 --console ui 會產生可讀但未經格式化的輸出；若要直接在終端機中使用，請改用 --plain 或 --console pretty。

--dark 和 --light 旗標選擇一個顏色佈景主題。深色佈景主題 (預設) 使用深海軍藍 Qlik 風格的調色盤。淺色佈景主題使用淺灰色調色盤。--surface 旗標會為每個輸出行啟用一個細微的背景填充。在美觀模式下，表面填充預設為啟用。使用 --noSurface 以停用背景填色。

在單一專案模式下，日誌檔案依預設會寫入至 %LOCALAPPDATA%\QV2QS\logs\。在批次模式下，日誌檔案會寫入到輸出目錄中的 logs/ 子資料夾。覆寫位置為 --logDir。設定 --logLevel DEBUG 以擷取詳細診斷輸出，用於疑難排解轉換問題。在每次執行前，使用 --cleanLogs 刪除逾 30 天的日誌檔案。如需日誌檔案位置、輪替和格式的完整說明，請參閱日誌記錄與診斷。

載入指令碼

依預設，QV2QS 會套用八個內建規則，可將 Windows 反斜線路徑標準化為正斜線，以符合 Qlik Cloud 相容性。下表列出每個內建規則。

每條規則都使用兩階段比對程序。「pattern」欄位是一個正規表示式，用於選取載入指令碼的區域。該 search 欄位接著只會套用在每個符合的區域內。這種方法可避免在目標情境之外發生非預期的替換。

此 --scriptReplacements 引數接受一個 JSON 檔案，該檔案將成為所有替換規則的唯一真實來源。當提供檔案時，內建預設值不會自動載入。若要將內建規則與自訂規則一併納入，請從精靈匯出完整的規則集並編輯匯出的檔案。規則以 execution_order 順序執行。

提供三種 CLI 行為：

• 沒有旗標 — 八個內建規則執行。
• --scriptReplacements <file> — 檔案中的規則才會執行。內建預設值不會自動載入。
• --noScriptReplacements — 沒有規則執行。

此 --scriptReplacements 檔案是一個規則物件的 JSON 陣列：

[
  {
    "description": "Replace server path with lib connection",
    "pattern": "FROM\\s+'[^']*'",
    "search": "\\\\\\\\server\\\\share\\\\",
    "replace": "lib://DataFiles/",
    "is_regex": true,
    "case_sensitive": false,
    "enabled": true,
    "execution_order": 1
  }
]

每個規則都有以下欄位：

其他

日期欄位排序防護

依預設，Qlik Sense 會將選取的值排序到清單方塊的頂端。對於日期類型的欄位，例如季度、月份或年份，這種重新排序打破了預期的時間順序。QV2QS 會套用啟發式方法來偵測日期類型的欄位名稱，並抑制這些欄位上的狀態式排序，讓值保持其自然順序，無論選取狀態為何。

該啟發式方法會透過分割非英數字元和駝峰式大小寫邊界來標記化每個欄位名稱 (例如，OrderDate 會變成 order 和 date)。所有權杖皆為小寫。欄位符合，如果任何 Token 等於下列其中一個：date、dates、month、months、year、years、quarter、quarters、qtr、qtrs、week、weeks、day、days、fiscal、fy、period、calendar。如果任何 Token 結尾為 date、month 或 year，該欄位也會符合 (例如 OrderDate、FiscalMonth)。權杖update、candidate及validate已排除，以避免誤判。比對不區分大小寫，且僅使用英文詞元。非英文欄位名稱（例如，Monat 或 Fecha）無法偵測。

符合啟發式規則的欄位已移除基於狀態的排序，並停用自動排序。

使用 --disableDateStateStickySort 關閉此啟發式。停用時，所有清單方塊欄位會使用預設的 Qlik Sense 排序行為，包括根據狀態的重新排序。

集合分析引號修正

QlikView 和 Qlik Sense 對於集合分析修飾符中的引號有不同的解讀方式。QV2QS 在轉換期間應用兩項獨立的修正。單引號搜尋修正預設為啟用。未加引號的設定值修復為實驗性，且預設為停用。

修復單引號搜尋值 (--fixSingleQuotedSearch)

包含搜尋語法的單引號值會轉換為雙引號。偵測到的搜尋模式包括萬用字元 (*, ?, ^)、比較運算子 (>, >=, <, <=)、模糊搜尋 (~)、運算式搜尋 (=)、搜尋修飾詞 (+, -) 以及複合搜尋 ((…|…), (…&…))：

• {<Year={'2*'}>} 變成 {<Year={"2*"}>}
• {<Amount={'>100'}>} 變成 {<Amount={">100"}>}
• {<Customer={'~company'}>} 變成 {<Customer={"~company"}>}

單引號純文字常值（例如 'USA'）以及數值欄位上的單引號值不受影響。使用 --noFixSingleQuotedSearch 來停用此修正。

修復未加上引號的設定值 (--fixUnquotedSetValues) — 實驗性

未加引號的純字串值會以單引號括起來：

• {<Country={USA}>} 變成 {<Country={'USA'}>}

數值 (2024)、美元符號變數 ($(vYear)) 以及雙引號字串均維持不變。依照預設，此修正為停用。傳入 --fixUnquotedSetValues 以將其啟用。使用 --noFixUnquotedSetValues 來明確停用它。

這兩項修正僅適用於維度與量值運算式。不支援的函式發現項目不會被修改。當停用修復時，標記的模式會保留在 Expression_Findings 工作表中以供手動檢閱。

瞭解更多

• 常見工作流程
• 記錄與診斷
• 版面配置模式