ウィザードのステップ

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

ユーザーインターフェースは、完全な変換プロセスに対応したウィザード形式のインターフェースです。QV2QS.exe をダブルクリックするか、--ui フラグを指定して実行可能ファイルを実行すると、ウィザードがデフォルトのブラウザで開きます。現在のバージョン番号は、バージョン情報ダイアログに表示されます。右上隅にあるテーマ切り替えボタンで、ライトモードとダークモードを切り替えます。詳細については、ダークモードを参照してください。

ウィザードは次のステップを順に提示します。選択したワークフローモードに適用されないステップは自動的に非表示になります。

セットアップ

ワークフローモードを選択してください (必須)。選択したモードによって、その後の手順が決まります。

• Qlik Cloud へのビルド (既定) — QlikView UI を変換し、結果のアプリを Qlik Cloud テナントに直接展開します。このモードを選択すると、変換されたアプリをQlik Cloudですぐに確認できます。このモードは、移行に推奨されるワークフローです。
• QVF をエクスポート — Qlik Cloud エンジンを使用して QlikView UI を変換し、結果のアプリを QVF ファイルとしてエクスポートし、その後、クラウドアプリを削除します。別のチームと共有したり、別のテナントにインポートしたりするファイルを作成するには、このモードを選択してください。このモードでも、Qlik Cloud テナントとAPI キーが必要です。Qlik Sense Enterprise Client-Managed へのインポートは、すべてのバージョンでテストされておらず、公式にはサポートされていません。詳細については、Qlik Sense Enterprise Client-Managed の互換性を参照してください。
• ローカルのみ — Qlik Cloud に接続せずにディスク上で変換を実行します。Qlik Cloud テナントまたは API キーは不要です。ローカル専用モードは、評価、レビュー、またはオフラインでの使用のために、完全な変換レポートとビルド出力を生成します。ローカルビルドの出力には、メディアのアップロード、背景画像の解像度、代替状態の作成、またはシートの公開は含まれません。これらの操作にはデプロイフェーズが必要です。完全な展開には、Build to Qlik Cloud または Export QVF モードを使用します。ローカルのみの制限の詳細については、変換の仕組みを参照してください。ビルド出力でQSECMをターゲットにすることは、全てのバージョンでテストされておらず、公式にはサポートされていません。詳細については、Qlik Sense Enterprise Client-Managed の互換性を参照してください。

プロジェクト

入力ソースを設定します。以下のいずれかを行います。

• シングルプロジェクト (デフォルト): QVWファイルを提供します (必須)。PRJ の自動生成はデフォルトで有効になっており、QVW ファイルから PRJ フォルダーを自動的に生成します。このオプションを無効にすると、PRJフォルダーまたはZIPを手動で提供できます。参照せずにバンドルされたサンプルプロジェクトを読み込むには、例を試すをクリックします。ボタンは、QVWフィールドが空の場合にのみ表示されます。サンプルプロジェクトをご覧ください。
• バッチ: スキャンするフォルダーを1つ以上指定してください（必須）。QV2QS は、一致するすべての QVW と PRJ のペアを再帰的に検出します。例を試す をクリックすると、フォルダーフィールドにバンドルされているサンプルフォルダーが入力されます。バッチワーカーは、並行して実行される変換の数を制御します（デフォルト：CPUコアに基づいて自動検出）。詳細については、バッチ変換を参照してください。

アウトプット

出力ルートフォルダーを設定します (必須)。QV2QS は、出力ルート内にプロジェクト名でサブフォルダーを自動的に作成します (例: <outputDir>/Sales/)。2つのプロジェクトが同じ名前を共有している場合、衝突を避けるために_2、_3のサフィックスが追加されます。実行前に既存のログファイルを削除するには、ログのクリーンアップを有効にします。

Qlik Cloud 認証

このステップは、Qlik CloudへのビルドモードおよびExport QVF モードの場合にのみ表示されます。

Qlik Cloud テナントで認証するための qlik-cli コンテキストを選択または作成します (必須)。テナントのURLとAPIキーを提供して、新しいコンテキストを作成します。ウィザードは続行する前に接続を検証します。

Qlik Cloud アプリ

このステップは、Qlik CloudへのビルドモードおよびExport QVF モードの場合にのみ表示されます。

バイナリアプリIDおよび既存のアプリを再利用フィールドには、クラウドアプリピッカーモーダルを開く参照ボタンが含まれています。各ピッカーは、接続されているテナントからアプリを読み込み、名前、所有者、スペース、またはアプリ IDで検索フィルターを適用して絞り込みます。QVWピッカーは、アプリタイプフィルター (QVW、QVF、またはすべて) も提供します。リストからアプリを選択すると、フィールドが自動的に入力されます。

表現の調整

スタイル指定

以下の設定は、シートの外観とレイアウトの動作を制御します。

テーマ

背景

レイアウト

リストボックスと並べ替え

詳細設定

スクリプトの置換セクションには、インラインのルールエディターが含まれています。マスター スイッチを切り替えて、すべてのスクリプト処理を有効または無効にします。セクションを展開して、個別のルールを表示、追加、編集、または削除します。各ルールは個別にオン/オフを切り替えることができます。8つの組み込みルールを復元するには、既定値にリセットをクリックします。サマリーバッジには、有効なルールの数が表示されます。

実行順序を変更するには、ルール上の上下矢印ボタンをクリックします。実行順序が低いルールが最初に実行されます。エクスポート をクリックして、すべてのルールをJSONファイルとしてダウンロードします。JSONファイルからルールを読み込み、現在のセットを置き換えるには、インポートをクリックします。インポートされたファイルには、各ルールにdescription、pattern、およびsearchというフィールドが含まれるJSON配列が必要です。

ルールの仕組み、2段階のマッチングプロセス、組み込みルールリストについて詳しくは、引数リファレンスを参照してください。

コンバージョンレポート

以下の設定は変換レポート出力を制御します。

レビュー

実行する前に、すべての設定を確認してください。レビュー手順では、プロジェクト、ワークフロー、クラウド、および出力構成の概要カードが表示されます。バッチモードでは、検出されたすべてのプロジェクトがテーブルに一覧表示されます。

サイドバーにある必須アクションのチェックリストは、実行前に構成する必要がある項目を追跡します。項目はカテゴリ別にグループ化されています: ワークフロー、入力、出力、およびクラウド認証。各項目は、設定済みの場合に正常、または値が不足している場合に未設定と表示されます。項目をクリックすると、関連するウィザードステップに直接移動します。

コマンドプレビューパネルは、現在のウィザード構成に対応するCLIコマンドを表示します。PowerShellとBashの構文を切り替えます。コマンドをクリップボードにコピーするには、コピー をクリックします。コマンドプレビューは、CLI引数を学習したり、スクリプトによる再実行のために正確なコマンドを保存したりするのに役立ちます。

変換を開始するには、実行をクリックします。

実行

変換の実行中に、ライブコンソール出力を表示します。実行中の変換を停止し、ログをリアルタイムでフォローし、実行が完了したら出力フォルダーまたはQlik Cloudアプリを開きます。

詳細はこちら

• エグゼクティブサマリーダッシュボード
• コマンドラインインターフェース
• 変換レイアウト設定
• Qlik Cloud へのデプロイ