# クイック スタート

ウィザードまたはコマンドラインを使用して、最初の変換をエンドツーエンドで実行します。

## 前提条件

* Windowsマシン (Windows 10、11、または Windows Server 2019、2022、2025)
* ローカル作業フォルダー内の QlikView ドキュメント (`.qvw` または QlikView で作成された `.qvf` ファイル) の コピー。Qlik Sense QVF ファイルは有効なソース入力ではありません。QV2QS を、共有ドライブ上の本番ファイルや QlikView Server のマウントポイントに指定しないでください。詳細については、[ソースファイルの安全性](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#source-file-safety)を参照してください。または、バンドルされているサンプルプロジェクトのいずれかを使用します。[サンプルプロジェクト](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)をご覧ください。
* API キーアクセスが有効になっている Qlik Cloud テナント (クラウド展開用)。セットアップ手順については、[Qlik Cloud アクセスのセットアップ](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)を参照してください。

## ウィザードの使用

次の手順に従ってください:

1. `QV2QS.exe` をダブルクリックします。初回起動時に、QV2QSはライセンス契約を表示します。続行するには、規約に同意してください。ウィザードはデフォルトのブラウザで開きます。
2. セットアップステップで、Qlik Cloudにビルドを選択します。
3. プロジェクトステップで、QVWファイルを選択します。PRJの自動生成を有効にします (QV2QSが変換中に読み込むXMLファイルとテキストファイルのセットにQVWを抽出します)。
4. 出力ステップで、出力ルートフォルダーを選択します。QV2QS は、QVWファイルの名前が付いたサブフォルダーを自動的に作成します。
5. Qlik Cloud 認証ステップで、テナントURLとAPIキーを入力します。ウィザードは接続を検証します。
6. Qlik Cloud アプリ ステップで、アプリ名を入力します。リロードと自動バイナリを有効にして、アプリにデータを入力します。
7. 「レビュー」ステップで、構成の概要を確認します。ウィザードには、スタイリング、詳細設定、および変換レポートの各ステップも含まれており、それぞれに適切なデフォルト値が設定されています。実行前に、必要に応じてこれらの手順を調整してください。
8. [実行] をクリックします。QV2QS は PRJ フォルダーを生成し、QlikView UI を変換し、アプリを Qlik Cloud にデプロイし、変換レポートを生成します。

変換が完了した後、エグゼクティブサマリーダッシュボードには変換メトリクスとフォローアップ項目が表示されます。概要から直接 Qlik Cloud アプリを開き、変換されたシートを確認します。

## コマンド ラインの使用

以下の例では、QVWファイルからPRJフォルダーを生成し、UIを変換し、データを伴ってアプリをQlik Cloudに展開し、Excelレポートを生成します。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
```

`--autoBinary` フラグは、QVW ファイルを一時的に Qlik Cloud にアップロードし、変換されたアプリが `Binary` ステートメントを介してデータをロードできるようにします。リロードが完了すると、QV2QS はアップロードされたファイルを削除し、クラウド アプリで元のロード スクリプトを復元します。

QV2QS は、コマンドラインで指定されていないオプションにデフォルト値を適用します。コンソール出力はダークモードでリッチな書式設定を使用し、変換レポートは自動的に生成され、固定キャンバスモードが有効になっていない限り、動的なグリッドレイアウトが使用されます。引数とデフォルト値の完全なリストについては、[引数リファレンス](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)を参照してください。

## 期待できること

単一アプリの変換とクラウド展開、およびデータのリロードは、通常、エンドツーエンドで2～5分で完了します。ローカル変換ステップ (PRJ抽出、XML解析、JSON生成) は、複雑なアプリケーションでも30秒未満で実行されます。クラウド展開とアプリの構築には1～3分かかります。リロード時間は、データ量とデータ ソースの構成に完全に依存します。パイプラインのステップごとの詳細なタイミング分析については、[コンバージョンが機能する仕組み](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm)を参照してください。

## 何が生産されますか

変換が成功すると、プロジェクトのサブフォルダー（例：`./output/Sales/`）には、変換されたアプリの構造、抽出されたメディア、変換レポート、および診断ログが含まれています。詳細な説明については、[変換のしくみ](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm)を参照してください。

## 詳細はこちら

* [ユーザーインターフェース](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/user-interface/index.htm)
* [一般的なワークフロー](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/common-workflows.htm)
* [変換レイアウト設定](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)
* [コンバージョンの成果](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/conversion-results/conversion-outcomes.htm)