バッチレポート | 移行センター ヘルプ
メイン コンテンツをスキップする 補完的コンテンツへスキップ

バッチレポート

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

QV2QSはバッチ実行後にプロジェクト単位のレポートと集計レポートの両方を生成し、あらゆるレベルで詳細な変換結果を提供します。

プロジェクト別レポート

バッチ内の各プロジェクトでは、単一プロジェクトモードと同様に、個別のExcel変換レポートとエグゼクティブサマリーJSONファイルが生成されます。これらのファイルは、各プロジェクト出力ディレクトリ内の reports/ サブフォルダーに書き込まれます。

集計レポート

QV2QS は、出力ルート ディレクトリに次の集計ファイルを書き込みます:

  • batch_summary.json — プロジェクト数、成功/失敗ステータス、タイミング、および集計されたKPI(合計シート数、オブジェクト、オートメーション率)を含む機械可読サマリー。
  • batch_summary.html — すばやく確認するための自己完結型HTMLレポート。
  • batch_conversion_report_<timestamp>.xlsx — サマリーシート、プロジェクトごとの分析、およびすべてのプロジェクトにわたる結合されたオブジェクトの詳細を含む統合Excelワークブック。

batch_summary.json の構造

batch_summary.jsonファイルには、CI/CD統合およびプログラムによる解析のための以下のトップレベルフィールドが含まれています。

フィールド 説明
schema スキーマバージョン (現在は 1)。
kind 常にqv2qs_batch_summary。
version QV2QS バージョン文字列。
timestamp_utc バッチ実行の ISO 8601 タイムスタンプ。
batch.total_projects 検出されたプロジェクトの総数。
batch.succeeded 正常に完了したプロジェクトの数。
batch.failed 失敗したプロジェクトの数。
batch.wall_clock_sec 合計経過時間 (秒)。
batch.cumulative_sec すべての個別プロジェクト期間の合計。
aggregated_kpis 成功したすべてのプロジェクトの合計: sheets, objects_in_scope, auto, follow_up, errors, images_unique, auto_pct, follow_up_pct.
projects プロジェクトごとのエントリの配列。各エントリには、name、ok (ブール値)、duration_sec、および output_dir が含まれます。成功したプロジェクトには、シート/オブジェクト数を含む summary オブジェクトが含まれます。失敗したプロジェクトには、error 文字列が含まれます。
exec_summaries 成功したすべてのプロジェクトの完全なエグゼクティブサマリーオブジェクトの配列。

各個別プロジェクトの executive_summary.json ファイルは同じスキーマ(kind: qv2qs_exec_summary)を使用し、project メタデータ、kpis(シート、オブジェクト、オートメーションスコア、オーバーフロー数)、breakdowns(タイプごとの結果、オーバーフローアクション)、および object_details(タイプ別にグループ化されたプレースホルダー、エラー、調整)が含まれています。シングルプロジェクトモードでは、ファイルにはフィールド数とテーブル数、バイトサイズ、およびアプリケーションプロパティを含むdata_modelセクションも含まれています。アプリケーション プロパティには、最終リロード時刻、ウィンドウ タイトル、セクション アクセス ステータス、およびデータ系列接続タイプが含まれます。data_model セクションは、バッチモードのプロジェクト別ファイルには含まれません。

kpis オブジェクトには、次のタイミングフィールドが含まれています:

フィールド 説明
kpis.duration_sec ローカル変換の所要時間(秒)(PRJ解析およびJSON生成のみ)。
kpis.app_build_sec クラウドアプリのビルド時間 (秒単位) (qlik app build)。クラウド展開が実行された場合にのみ存在します。
kpis.app_build_included_reload ブール値。アプリのビルド時間にリロードが含まれる場合は true、それ以外の場合は false。クラウド展開が実行された場合にのみ存在します。
kpis.total_duration_sec エンドツーエンドの経過時間(秒単位)(変換 + クラウド展開)。クラウド展開が実行された場合にのみ存在します。ローカルのみで実行する場合は、duration_sec を使用します。

コンソール出力

すべてのプロジェクトが完了すると、コンソールにプロジェクトの総数、成功数、失敗数、ウォールクロック時間、および累積処理時間を示すサマリーテーブルが表示されます。失敗したプロジェクトは、エラーメッセージとともに個別に一覧表示されます。

Batch CLI リファレンス

次の引数はバッチモード固有です。バッチモードにも適用される一般的な変換引数については、引数リファレンスを参照してください。

引数 説明 初期設定
--batchDir PATH QVW/QVF プロジェクトをスキャンするルート ディレクトリ(またはセミコロン区切りのパス)。 必須
--batchWorkers N 同時に変換するプロジェクトの最大数 (0 = 自動: CPUコア数マイナス1)。 0
--batchFlatOutput ソース階層をミラーリングする代わりに、出力ディレクトリ構造をフラット化します。 オフ
--generatePrj PRJフォルダーがないソースファイルに対してPRJフォルダーを自動生成します。 オフ
--qsAppName TEMPLATE Qlik Cloud 展開用のアプリ命名テンプレート。{name}、{rel}、および {index} のプレースホルダーをサポートしています。 プロジェクト名

詳細を見る

Visit the discussion forum at community.qlik.com

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。