출력 구조 및 앱 이름 지정

마지막 업데이트: 2026. 10. 14.

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

출력 구조

기본적으로 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에서 대표 샘플로 몇 분간 테스트를 진행하면 대규모 배치 작업 전반에서 상당한 노력을 절감할 수 있습니다.

배치 모드에서 앱 이름 지정

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

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

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

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

자세히 알아보기

• 병렬 실행
• 배치 보고
• 인수 참조