# ウィザードのステップ

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

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

## セットアップ

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

* 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 の互換性](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm)を参照してください。
* ローカルのみ — Qlik Cloud に接続せずにディスク上で変換を実行します。Qlik Cloud テナントまたは API キーは不要です。ローカル専用モードは、評価、レビュー、またはオフラインでの使用のために、完全な変換レポートとビルド出力を生成します。ローカルビルドの出力には、メディアのアップロード、背景画像の解像度、代替状態の作成、またはシートの公開は含まれません。これらの操作にはデプロイフェーズが必要です。完全な展開には、Build to Qlik Cloud または Export QVF モードを使用します。ローカルのみの制限の詳細については、[変換の仕組み](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode)を参照してください。ビルド出力でQSECMをターゲットにすることは、全てのバージョンでテストされておらず、公式にはサポートされていません。詳細については、[Qlik Sense Enterprise Client-Managed の互換性](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm)を参照してください。

## プロジェクト

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

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

警告メモ

QV2QSは、QlikView Server上または共有ネットワークドライブ上の本番ファイルではなく、ローカルの作業フォルダー内にあるソースドキュメントのコピーを常に指すようにしてください。QlikView Desktop エンジンは、PRJ 生成中にファイルロックを取得します。これは、アクティブな QlikView セッションと競合する可能性があります。詳細については、[ソースファイルの安全性](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#source-file-safety)を参照してください。

## アウトプット

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

## Qlik Cloud 認証

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

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

## Qlik Cloud アプリ

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

| 設定 | 説明 | 初期設定 |
| --- | --- | --- |
| アプリ名 | Qlik Cloud 内の Qlik Sense アプリの名前 | QVWファイル名、PRJフォルダー名、または出力フォルダー名 |
| リロード | ビルド後にアプリをリロードしてロード スクリプトを実行します | オン |
| 自動バイナリ | バイナリデータロード用にQVWファイルを一時的にアップロードし、リロード後にファイルを削除します。リロードが必要です。 | オン |
| バイナリ アプリID | アップロードする代わりに、Qlik Cloudの既存のQVWまたはQVFアプリをバイナリ ロードに使用します。リロードが必要です。参照ボタンをクリックしてQVWピッカーを開きます。 | — |
| 既存のアプリを再利用する | 新しいアプリを作成するのではなく、以前に作成したアプリを更新します。有効にすると、QV2QS は出力フォルダーをチェックし、選択した QVW ファイルと一致する以前の展開があるかどうかを確認し、アプリ ID を自動的に入力します。以前の展開が見つからない場合、アプリIDを手動で入力するか、または参照ボタンをクリックしてQVFピッカーを開きます。 | オフ |
| ロード スクリプトを保持する | ターゲットアプリに既存のロード スクリプトを保持します。変換されたスクリプトは適用されていません。既存のアプリを再利用するが必要です。デフォルトでリロードをオフにします。既存のスクリプトを実行するには、再度有効にしてください。 | オフ |
| 変数を保持 | 対象アプリで既存の変数を保持します。変換された変数は適用されていません。既存のアプリを再利用する必要があります。 | オフ |
| 展開前バックアップをスキップ | アプリを上書きする前に、QVFバックアップをエクスポートしないでください。既定では、データなしのバックアップは `cloud/backups/` に保存されます。既存のアプリを再利用する必要があります。 | オフ |
| シートを公開 | ビルド後、変換されたすべてのシートをベースシートとして公開します。ベースシートは、アプリへのアクセス権を持つすべてのユーザーに表示されます。この設定を無効にすると、シートは個人的な（未公開の）オブジェクトとして保持されます。既存のアプリを再利用が有効になっている場合、この設定は新しいシートにのみ適用されます。以前に公開されたシートは、この設定に関わらず自動的に復元されます。 | オン |
| データなしでビルド | ビルドフェーズ中のデータ読み込みをスキップします。アプリはデータなしでテナントにアセンブルされ、リロードを待つことなくUI構造をテストできます。 | オフ |
| データを除いてエクスポート | エクスポートされたQVFファイルからデータを削除します。クラウドアプリはビルドからのデータがまだ含まれている可能性がありますが、ダウンロードされたQVFはより小さくなります。QVFモードでのエクスポートのみ。 | オフ |

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

表現の調整

| 設定 | 説明 | 初期設定 |
| --- | --- | --- |
| 単一引用符で囲まれた検索値を修正 | セット分析式で、単一引用符のワイルドカードと比較を二重引用符に変換します。詳細については、[引数リファレンス](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)を参照してください。 | オン |
| 引用符なしのセット値を修正 (試験段階) | セット分析式では、引用符で囲まれていない裸の文字列値をシングルクォートで囲みます。詳細については、[引数リファレンス](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)を参照してください。 | オフ |

## スタイル指定

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

テーマ

| 設定 | 説明 | 初期設定 |
| --- | --- | --- |
| アプリのテーマ | 変換されたアプリにQlik Senseのテーマが適用されました。ドロップダウンには、4つの組み込みQlikテーマが一覧表示されます。Qlik Cloud コンテキストが構成されている場合、更新ボタンをクリックして、テナントにインストールされているカスタムテーマを取得します。Sense Classic は QlikView と最高の 1:1 の忠実度を実現します。非クラシックテーマでは、オブジェクトの境界線、背景色、フォント、およびパディングが変更される場合があります。テーマは既定値のみを設定します。ユーザーはQlik Senseクライアントでいつでもテーマを切り替えることができます。 | Sense クラシック |

背景

| 設定 | 説明 | 初期設定 |
| --- | --- | --- |
| シートの背景画像 | QlikView シートの壁紙を抽出して適用する | オン |
| ドキュメントの背景にフォールバック | 背景が設定されていないシートには、ドキュメントレベルの背景を使用します | オン |
| 背景色の上書き | すべてのシートに単色塗りつぶしが適用されました (`#RRGGBB`) | — |

レイアウト

| 設定 | 説明 | 初期設定 |
| --- | --- | --- |
| シートヘッダーを表示 | 変換されたシートにヘッダー領域を追加します | オフ |
| 非表示のシートをスキップ | 表示条件が常にfalseであるシートを除外する | オフ |

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

| 設定 | 説明 | 初期設定 |
| --- | --- | --- |
| QVリストボックスの色を保持する | 元の QlikView リストボックスの背景色と透明度を適用する | オン |
| 日付フィールドのソートガード | 日付形式のリストボックスフィールド（年、四半期、月など）は、選択状態ではなく、時系列順に並べ替えるようにしてください。詳細については、[引数リファレンス](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)を参照してください。 | オン |

## 詳細設定

| 設定 | 説明 | 初期設定 |
| --- | --- | --- |
| 固定シートキャンバス | ピクセル単位で正確なQlikViewスタイルの配置を有効にします。拡大縮小率、最小寸法、およびキャンバスのトリップオプションを表示します。キャンバスのスケールとオブジェクトのスケールは、デフォルトでリンクされています。チェーンアイコンをクリックして、個別の値を設定します。詳細については、[変換レイアウト設定](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)を参照してください。 | オン |
| 自動拡張動的シート | シートを、デフォルトのグリッド高さを超えて垂直方向に拡張できるようにする | オン |
| メディアアップロードワーカー | Qlik Cloud へメディアファイル (壁紙や画像) をアップロードするための並行ワーカー数。Qlik CloudへのビルドおよびQVFエクスポートモードに適用されます。 | `2` |
| スクリプトの置換 | スクリプト置換処理のオン/オフを切り替え、個別のルールを管理します。詳細については、[引数リファレンス](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)を参照してください。 | オン |

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

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

ヒント メモ

インポート用のカスタムルールファイルを作成するには、組み込みルールを正しい形式で取得するため、最初にExportをクリックします。エクスポートされたファイルを編集してルールを追加、削除、または変更し、その後、インポートをクリックして更新されたセットを読み込みます。

情報メモ

カスタムルールまたは無効化されたデフォルトが設定されている場合、コマンドプレビューに通知が表示されます。コピーされたコマンドにはカスタムルールは含まれていません。JSONファイルにルールをエクスポートし、コマンドラインでカスタムルールを含めるために、コマンドに`--scriptReplacements <path>`を追加します。

ルールの仕組み、2段階のマッチングプロセス、組み込みルールリストについて詳しくは、[引数リファレンス](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)を参照してください。

ヒント メモ

「詳細」ステップからMockup Studioを開き、固定キャンバスと動的グリッドレイアウトを対話的にプレビューし、スケーリングを調整して、設定をウィザードに適用します。

## コンバージョンレポート

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

| 設定 | 説明 | 初期設定 |
| --- | --- | --- |
| レポートを生成 | コンソール変換レポートを生成する | オン |
| Excel レポート | レポートを、オブジェクトごとの詳細情報とオートメーションスコアリングを含むXLSXファイルとしてエクスポートします。ファイル名を入力してください (例:`MyReport`) またはフルパス。`.xlsx` 拡張は自動的に追加されます。空欄のままにすると、`reports/`で自動的に名前が付けられます。 | オン |
| 選択項目と検索オブジェクトを含める | レポートに「現在の選択」ボックスと検索オブジェクトを含める。これらはQlik Senseによって自動的に追加され、デフォルトで除外されます。 | オフ |

## レビュー

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

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

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

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

## 実行

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

## 詳細はこちら

* [エグゼクティブサマリーダッシュボード](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)
* [コマンドラインインターフェース](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/index.htm)
* [変換レイアウト設定](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)
* [Qlik Cloud へのデプロイ](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)