# 출력 구조 및 앱 이름 지정

QV2QS는 배치 출력을 디렉터리 계층 구조로 구성하고 Qlik Cloud 배포를 위한 유연한 앱 명명 기능을 제공합니다.이 항목에서는 디렉터리 레이아웃 옵션, 설정 권장 사항 및 명명 템플릿을 다룹니다.

정보 메모

단일 프로젝트 모드는 출력 루트 아래에 프로젝트별 하위 폴더도 생성합니다.자세한 내용은 [전환 작동 방식](https://help.qlik.com/ko-KR/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm)을 참조하세요.

## 출력 구조

기본적으로 QV2QS는 출력 루트 아래에 소스 디렉터리 계층 구조를 미러링합니다.각 프로젝트는 빌드 출력, 보고서 및 로그가 포함된 하위 폴더를 생성합니다.

계층 구조 유지(기본값)

```
<outputDir>/
  <RelativePath>/
    <ProjectName>/
      build/
      images/
      reports/
      logs/
```

계층 구조 평탄화 (`--batchFlatOutput`)

```
<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/
```

계층 구조 유지는 원본 폴더 구조가 조직별 그룹화(부서, 지역 또는 사업 부문별)를 반영하고 있으며 출력 결과에도 해당 구조를 그대로 반영해야 할 때 유용합니다.계층 구조를 평탄화하는 것은 폴더 구조가 의미가 없거나 다운스트림에서 플랫 목록으로 작업하는 것이 더 쉬울 때 유용합니다.

두 프로젝트에서 동일한 출력 폴더 이름이 생성되는 경우(예: 서로 다른 하위 디렉터리에 있는 이름이 `Sales`인 두 프로젝트), QV2QS는 충돌을 방지하기 위해 `_2`, `_3` 및 후속 번호를 추가합니다.

## 배치 모드 설정

모든 변환 설정은 배치의 모든 프로젝트에 동일하게 적용됩니다.프로젝트별 재정의를 위한 메커니즘이 없습니다.고정 캔버스 배율, 오브젝트 배율, 크기 제약 조건, 자르기 치수, 레이아웃 축소, 배경 처리 및 기타 모든 설정은 해당 실행의 모든 앱에 동일하게 적용됩니다.

이러한 일관된 적용에는 중요한 실무적 시사점이 있습니다: 일괄 변환을 실행할 때 유사한 애플리케이션을 함께 그룹화하십시오.화면 해상도, 배경 이미지 레이아웃 및 개체 크기가 유사한 애플리케이션은 단일 배치에서 잘 작동합니다.레이아웃이나 디자인 패턴이 크게 다른 애플리케이션은 서로 다른 설정을 사용하여 별도로 배치를 실행하는 것이 유리합니다.

일괄 변환을 위한 권장 워크플로:

1. 모든 소스 QVW 및 QVF 파일을 로컬 작업 폴더로 복사합니다.프로덕션 디렉터리 또는 네트워크 공유를 대상으로 일괄 변환을 실행하지 마십시오.
2. 유사한 레이아웃 특성(해상도, 배경 이미지, 개체 밀도)을 공유하는 QlikView 애플리케이션 그룹을 식별합니다.
3. 각 그룹의 대표 애플리케이션을 단일 프로젝트 모드로 로드합니다.
4. Mockup Studio를 열고 레이아웃이 만족스러울 때까지 고정 캔버스, 배율, 자르기 및 크기 제한 설정을 조정해 보세요.
5. 해당 그룹에 최상의 결과를 내는 설정을 기록해 두십시오.
6. 배치 모드로 전환하고 해당 그룹이 포함된 폴더를 지정한 후 동일한 설정을 적용합니다.
7. 각 애플리케이션 그룹에 대해 반복합니다.

이러한 접근 방식은 일반적인 설정으로 대규모 배치를 실행한 후 나중에 개별 앱을 수동으로 조정하는 데 시간을 소비하는 흔한 실수를 방지합니다.Mockup Studio에서 대표 샘플로 몇 분간 테스트를 진행하면 대규모 배치 작업 전반에서 상당한 노력을 절감할 수 있습니다.

팁 메모

전체 세트로 확장하기 전에 3~5개의 애플리케이션으로 구성된 소규모 배치로 시작하여 설정을 검증하세요.

## 배치 모드에서 앱 이름 지정

Qlik Cloud에 일괄 변환을 배포할 때 `--qsAppName`은(는) 각 앱의 이름 지정 방식을 제어합니다:

* 지정되지 않음 — 각 앱은 프로젝트(`<Name>`)의 이름을 따서 명명됩니다.
* 일반 텍스트 — 이 값은 접두사로 사용됩니다: `<prefix> - <Name>`.
* 자리 표시자가 있는 템플릿 — 값이 형식 문자열로 처리됩니다.

템플릿 문자열에서 다음 플레이스홀더를 사용할 수 있습니다.

| 자리 표시자 | 설명 |
| --- | --- |
| `{name}` | 프로젝트 이름 |
| `{rel}` | 스캔 루트 기준 상대 디렉터리 경로 |
| `{index}` | 순차적 프로젝트 번호 (1부터 시작) |

예를 들어, `--qsAppName "Migrated {name} ({rel})"`은 `Migrated Sales (region1/finance)`와 같은 앱 이름을 생성합니다.

## 자세히 알아보기

* [병렬 실행](https://help.qlik.com/ko-KR/migration/Content/Qv2qsMigration/batch-conversion/parallel-execution.htm)
* [배치 보고](https://help.qlik.com/ko-KR/migration/Content/Qv2qsMigration/batch-conversion/batch-reporting.htm)
* [인수 참조](https://help.qlik.com/ko-KR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)