# 一般的なワークフロー 以下の例は、最も頻繁なユースケースをカバーしています。それぞれが同じコアパターンに基づいて構築されています。QVWファイル、出力フォルダー、およびQlik Cloudコンテキストを指定します。すべての例において、`--outputDir` が出力ルートです。QV2QS は、QVWファイル名と同じ名前のサブフォルダーを自動的に作成します (例: `./output/Sales/`)。これらのワークフローはすべて、ウェブベースのウィザードを通じて実行することもできます。ガイド付きアプローチについては、[ウィザードの手順](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm)を参照してください。 ## データ付きで Qlik Cloud に展開 標準の移行ワークフロー。QV2QS は PRJ フォルダーを生成し、UI を変換し、バイナリデータロード用に QVW をアップロードし、Qlik Cloud でアプリをリロードし、Excel レポートを作成します。アップロードされたQVWは削除され、リロード後に元のロード スクリプトが復元されます。 ``` QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx ``` ## QVFファイルをエクスポート QV2QSはQlik Cloudエンジンを使用してアプリを構築し、結果をQVFファイルとしてエクスポートした後、クラウドアプリを削除します。エクスポートされた QVF は、別の Qlik Cloud テナントにインポートできます。 警告メモ Qlik Sense Enterprise Client-ManagedにQV2QSで生成されたQVFファイルをインポートすることは、すべてのバージョンでテストされておらず、公式にはサポートされておらず、推奨されません。詳細については、[Qlik Sense Enterprise Client-Managed の互換性](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm)を参照してください。 ``` QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx ``` ## QlikView資産全体を一括移行する 1つ以上のフォルダーをスキャンしてすべてのQVWおよびPRJペアを検索し、それらのペアを並行して変換し、それぞれをQlik Cloudに展開します。並行処理を制御するために`--batchWorkers`を使用します。 ``` QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx ``` ## QlikView ピクセルレイアウトを保持する 固定キャンバスモードを有効にすると、QlikViewオブジェクトの正確な位置とシートの壁紙が保持されます。スケール係数を調整して、レイアウトがQlik Senseの画面寸法にどのようにマッピングされるかを制御します。 ``` QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5 ``` ## 以前に変換されたアプリを更新する 新しいアプリを作成せずに、既存のQlik Cloudアプリに対して変換を再実行します。QV2QS は前回の実行からアプリIDを再利用します。 ``` QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx ``` ## ロード スクリプトを保持したままアプリを更新する ロード スクリプトを上書きせずに、既存のアプリのUI レイヤーを更新するために、変換を再実行します。ターゲットアプリは、既存のデータ接続とリロードロジックを保持します。アップデートの前に、データを含まないバックアップが自動的にエクスポートされます。`--reload` を追加して、既存のスクリプトを実行し、データを更新します。 ``` QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx ``` ## アプリの変数を保持したまま更新する 変数を上書きせずに、既存のアプリのUI レイヤーとロード スクリプトを更新するために、変換を再実行します。ターゲット アプリのロード スクリプトと変数の両方をそのまま維持するために、`--preserveTargetAppScript` と組み合わせます。 ``` QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx ``` ## Qlik Cloud 認証を設定 変換を実行する前に、qlik-cliコンテキストを構成してください。対話型セットアップは、テナントURLとAPIキーの入力を求め、以降の実行のために認証情報を保存します。 ``` QV2QS.exe --setupQlikAuth ``` ## プログラマティックな利用 (CI/CD) QV2QSは、事前に作成されたqlik-cliコンテキストなしで直接認証をサポートします。テナントURLとAPIキーをインラインで渡します。QV2QS は資格情報を検証し、すべての qlik-cli 呼び出しに認証ヘッダーを挿入します。コンテキストファイルは作成または変更されません。`--accept-eula` を含めると、対話型プロンプトなしでライセンス契約に同意できます。 ``` QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain ``` このモードは、複数のテナントやユーザー間で同時に実行しても安全です。APIキーはディスクに書き込まれず、ログファイルにも表示されません。 認証情報は環境変数として設定することもできます。 ``` set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com set QV2QS_QLIK_API_KEY=eyJhbG... QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain ``` ## Qlik Cloud なしでのローカルビルド Qlik Cloud に接続せずに、変換された出力と変換レポートをディスクに生成します。ローカル専用モードは、移行評価、展開前レビュー、およびオフライン環境を目的としています。ローカルビルドの出力には、メディアのアップロード、背景画像の解像度、代替状態の作成、またはシートの公開は含まれません。完全な展開には、Build to Qlik Cloud または Export QVF モードを使用します。ローカルのみの制限事項とユースケースの詳細については、[変換の仕組み](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode)を参照してください。 ``` QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly ``` ## 詳細はこちら * [引数参照](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm) * [ユーザーインターフェース](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/user-interface/index.htm)