引数リファレンス

最終更新日時: 2026/10/14

以下の表に、カテゴリ別にグループ化された利用可能なすべての引数を一覧表示します。

入力および出力

バッチモード

Qlik Cloud

認証

レイアウトとスタイリング

固定キャンバスと動的グリッドモードの詳細については、変換レイアウト設定を参照してください。

コンバージョンレポート

コンソールレポートとExcelレポートは、CLIモードとユーザーインターフェースの両方で、デフォルトで有効になっています。

コンソールとロギング

QV2QSは4つのコンソール出力モードをサポートしています。

• 見栄えの良い — 色、アニメーションスピナー、プログレスバー、テーマ付きパネルを備えたリッチフォーマット出力。プリティモードは、対話型ターミナルで使用する際のデフォルトです。カラー対応ターミナルが必要です (Windows 10以降、PowerShell 5以降、またはUnix系シェル)。
• プレーン — タイムスタンプ付きテキスト出力（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 を設定します。各実行前に、30日以上前のログファイルを削除するには、--cleanLogsを使用します。ログファイルの場所、ローテーション、形式の詳細については、ログと診断を参照してください。

スクリプトを読み込み

既定では、QV2QS は、Qlik Cloud の互換性のために、Windows のバックスラッシュパスをフォワードスラッシュに正規化する 8 つの組み込みルールを適用します。次の表に、組み込みルールを一覧表示します。

各ルールは2段階のマッチングプロセスを使用します。pattern フィールドは、ロード スクリプトの領域を選択する正規表現です。searchフィールドは、その後、一致した各領域内でのみ適用されます。このアプローチにより、対象となるコンテキスト外での意図しない置換が防止されます。

--scriptReplacements引数は、すべての置換ルールに対する唯一の信頼できる情報源となるJSONファイルを受け入れます。ファイルが提供されると、組み込みの既定値は自動的に読み込まれません。組み込みルールをカスタムルールと合わせて含めるには、ウィザードから完全なルールセットをエクスポートし、エクスポートしたファイルを編集します。ルールはexecution_orderの順序で実行されます。

3つのCLI動作が利用可能です:

• フラグなし — 8つの組み込みルールが実行されます。
• --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 になります)。すべてのトークンは小文字です。フィールドが一致するのは、いずれかのトークンが次のいずれかに等しい場合です。date, dates, month, months, year, years, quarter, quarters, qtr, qtrs, week, weeks, day, days, fiscal, fy, period, calendar。フィールドは、いずれかのトークンがdate、month、またはyearで終わる場合にも一致します (例えば、OrderDate、FiscalMonth)。トークンupdate、candidate、およびvalidateは、誤検知を避けるために除外されます。照合は、大文字と小文字を区別せず、英語のトークンのみを使用します。英語以外のフィールド名 (例えば、Monat または Fecha) は検出されません。

ヒューリスティックに一致するフィールドでは、状態ベースの並べ替えが削除され、自動並べ替えが無効になります。

--disableDateStateStickySort を使用して、このヒューリスティックをオフにします。無効にすると、すべてのリストボックスフィールドは、状態ベースの並べ替えを含め、デフォルトのQlik Senseソート動作を使用します。

セット分析のクォーテーション修正

QlikView と Qlik Sense では、セット分析修飾子における引用符の解釈が異なります。QV2QS は変換中に2つの独立した修正を適用します。単一引用符検索の修正は、既定で有効になっています。引用符なしのセット値の修正は試験段階であり、デフォルトでは無効になっています。

シングルクォートされた検索値の修正 (--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 ワークシートで手動レビュー用に残ります。

詳細はこちら

• 一般的なワークフロー
• ロギングおよび診断
• レイアウトモード