# 배치 보고

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` | Boolean. 앱 빌드 시간에 다시 로드가 포함된 경우 `true`, 그렇지 않은 경우 `false`입니다.클라우드 배포가 수행된 경우에만 표시됩니다. |
| `kpis.total_duration_sec` | 초 단위 엔드투엔드 경과 시간(변환 + 클라우드 배포).클라우드 배포가 수행된 경우에만 표시됩니다.로컬 전용 실행의 경우 `duration_sec`을 사용하세요. |

## 콘솔 출력

모든 프로젝트가 완료되면 콘솔에 총 프로젝트 수, 성공한 수, 실패한 수, 실제 경과 시간, 누적 처리 시간이 포함된 요약 표가 표시됩니다.실패한 프로젝트는 오류 메시지와 함께 개별적으로 나열됩니다.

## Batch CLI 참조

다음 인수는 배치 모드 전용입니다.배치 모드에도 적용되는 일반 변환 인수는 [인수 참조](https://help.qlik.com/ko-KR/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/ko-KR/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)
* [변환 보고서](https://help.qlik.com/ko-KR/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [경영진 요약 대시보드](https://help.qlik.com/ko-KR/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)