배치 보고
마지막 업데이트: 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
|
Boolean. 앱 빌드 시간에 다시 로드가 포함된 경우 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} 플레이스홀더를 지원합니다. |
프로젝트 이름 |