一般的なワークフロー
最終更新日時: 2026/10/14以下の例は、最も頻繁なユースケースをカバーしています。それぞれが同じコアパターンに基づいて構築されています。QVWファイル、出力フォルダー、およびQlik Cloudコンテキストを指定します。すべての例において、--outputDir が出力ルートです。QV2QS は、QVWファイル名と同じ名前のサブフォルダーを自動的に作成します (例: ./output/Sales/)。これらのワークフローはすべて、ウェブベースのウィザードを通じて実行することもできます。ガイド付きアプローチについては、ウィザードの手順を参照してください。
データ付きで 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 の互換性を参照してください。
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 モードを使用します。ローカルのみの制限事項とユースケースの詳細については、変換の仕組みを参照してください。
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly