# バッチレポート

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 リファレンス

次の引数はバッチモード固有です。バッチモードにも適用される一般的な変換引数については、[引数リファレンス](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)を参照してください。

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

## 詳細を見る

* [出力構造とアプリの命名](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)
* [変換レポート](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [エグゼクティブサマリーダッシュボード](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)