빠른 시작
마지막 업데이트: 2026. 10. 14.마법사 또는 명령줄을 사용하여 첫 번째 변환을 처음부터 끝까지 실행합니다.
전제 조건
- Windows 머신 (Windows 10, 11 또는 Windows Server 2019, 2022, 2025)
- 로컬 작업 폴더에 있는 QlikView 문서(
.qvw또는 QlikView에서 생성된.qvf파일)의 사본.Qlik Sense QVF 파일은 소스 입력으로 유효하지 않습니다.QV2QS가 공유 드라이브 또는 QlikView Server 탑재 지점의 프로덕션 파일을 가리키도록 하지 마십시오.자세한 내용은 소스 파일 안전을(를) 참조하십시오.또는, 번들로 제공되는 예제 프로젝트 중 하나를 사용하세요.예제 프로젝트를 참조하세요. - API 키 액세스가 활성화된 Qlik Cloud 테넌트(클라우드 배포용).설정 지침은 다음을 참조하십시오. Qlik Cloud 액세스 설정.
마법사 사용
다음을 수행합니다.
- 두 번 클릭합니다.
QV2QS.exe.처음 실행 시, QV2QS는 사용권 계약을 표시합니다.계속하려면 동의서에 동의하십시오.마법사가 기본 브라우저에서 열립니다. - 설정 단계에서 Qlik Cloud로 빌드를 선택합니다.
- 프로젝트 단계에서 QVW 파일을 선택합니다.PRJ 자동 생성을(를) 활성화된 상태로 둡니다 (QVW를 QV2QS가 변환 중에 읽는 XML 및 텍스트 파일 세트로 추출합니다).
- 출력 단계에서 출력 루트 폴더를 선택합니다.QV2QS는 QVW 파일 이름을 따서 하위 폴더를 자동으로 생성합니다.
- Qlik Cloud 인증 단계에서 테넌트 URL과 API 키를 입력합니다.마법사가 연결의 유효성을 검사합니다.
- Qlik Cloud 앱 단계에서 앱 이름을 입력합니다.새로 고침 및 자동 이진을(를) 활성화하여 앱에 데이터를 채웁니다.
- 검토 단계에서 구성 요약을 확인합니다.마법사에는 스타일 지정, 고급, 및 변환 보고서 단계도 포함되어 있으며, 합리적인 기본값이 설정되어 있습니다.실행 전에 필요에 따라 이 단계를 조정하십시오.
- 실행을 클릭합니다.QV2QS는 PRJ 폴더를 생성하고, QlikView UI를 변환하며, 앱을 Qlik Cloud에 배포하고, 변환 보고서를 생성합니다.
변환이 완료되면 경영진 요약 대시보드에 변환 지표와 팔로우업 항목이 표시됩니다.요약에서 직접 Qlik Cloud 앱을 열어 변환된 시트를 검토합니다.
명령줄 사용
다음 예시는 QVW 파일에서 PRJ 폴더를 생성하고, UI를 변환하며, 데이터를 포함하여 앱을 Qlik Cloud에 배포하고, Excel 보고서를 생성합니다.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
--autoBinary 플래그는 QVW 파일을 Qlik Cloud에 임시로 업로드하여 변환된 앱이 Binary 문을 통해 데이터를 로드할 수 있도록 합니다.새로 고침이 완료되면, QV2QS는 업로드된 파일을 삭제하고 클라우드 앱에서 원래 로드 스크립트를 복원합니다.
QV2QS는 명령줄에 지정되지 않은 옵션에 대해 기본값을 적용합니다.콘솔 출력은 다크 모드에서 풍부한 서식을 사용하며, 변환 보고서가 자동으로 생성되고, 고정 캔버스 모드가 활성화되지 않는 한 동적 그리드 레이아웃이 사용됩니다.인수 및 기본값의 전체 목록은 인수 참조를 참조하십시오.
예상되는 내용
단일 앱 변환은 클라우드 배포 및 데이터 다시 로드와 함께 일반적으로 처음부터 끝까지 2분에서 5분 이내에 완료됩니다.로컬 변환 단계(PRJ 추출, XML 구문 분석 및 JSON 생성)는 복잡한 애플리케이션의 경우에도 30초 이내에 실행됩니다.클라우드 배포 및 앱 빌드에 1분에서 3분이 추가됩니다.새로 고침 시간은 데이터 양 및 데이터 소스 구성에 전적으로 좌우됩니다.파이프라인 단계별 자세한 타이밍 분할에 대해서는 변환 작동 방식을 참조하십시오.
무엇이 생산되나요?
성공적인 변환 후, 프로젝트 하위 폴더(예: ./output/Sales/)에는 변환된 앱 구조, 추출된 미디어, 변환 보고서 및 진단 로그가 포함됩니다.전체 설명은 전환 작동 방식을 참조하세요.