일반적인 워크플로
마지막 업데이트: 2026. 10. 14.다음 예시는 가장 자주 사용되는 사용 사례를 다룹니다.각각 동일한 핵심 패턴을 기반으로 합니다: QVW 파일, 출력 폴더 및 Qlik Cloud 컨텍스트를 지정하는 것입니다.모든 예시에서, --outputDir는 출력 루트입니다.QV2QS는 QVW 파일 이름을 따서 명명된 하위 폴더를 자동으로 생성합니다 (예: ./output/Sales/).이 모든 워크플로는 웹 기반 마법사를 통해서도 수행할 수 있습니다.안내 방식의 경우, 마법사 단계를 참조하십시오.
데이터와 함께 Qlik Cloud에 배포
표준 마이그레이션 워크플로.QV2QS는 PRJ 폴더를 생성하고, UI를 변환하며, 이진 데이터 로드를 위해 QVW를 업로드하고, Qlik Cloud에서 앱을 다시 로드하며, Excel 보고서를 생성합니다.업로드된 QVW가 삭제되고, 리로드 후 원래의 로드 스크립트가 복원됩니다.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
QVF 파일 내보내기
QV2QS는 Qlik Cloud 엔진을 사용하여 앱을 빌드하고, 결과를 QVF 파일로 내보낸 다음 클라우드 앱을 삭제합니다.내보낸 QVF는 다른 Qlik Cloud 테넌트로 가져올 수 있습니다.
QV2QS로 생성된 QVF 파일을 Qlik Sense Enterprise Client-Managed로 가져오는 것은 모든 버전에서 테스트되지 않았거나 공식적으로 지원되지 않으며 권장되지 않습니다.자세한 내용은 Qlik Sense Enterprise Client-Managed 호환성을(를) 참조하십시오.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
전체 QlikView 환경을 일괄 마이그레이션
하나 이상의 폴더에서 모든 QVW 및 PRJ 쌍을 스캔하여, 해당 쌍을 병렬로 변환하고, 각각을 Qlik Cloud에 배포합니다.--batchWorkers를 사용하여 동시성을 제어하십시오.
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
QlikView 픽셀 레이아웃 유지
고정 캔버스 모드를 활성화하여 정확한 QlikView 개체 위치 및 시트 배경화면을 유지합니다.배율 인수를 조정하여 레이아웃이 Qlik Sense 화면 크기에 매핑되는 방식을 제어합니다.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
이전에 변환된 앱 업데이트
새로운 앱을 만들지 않고 기존 Qlik Cloud 앱에 대해 변환을 다시 실행합니다.QV2QS는 이전 실행에서 앱 ID를 재사용합니다.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
로드 스크립트를 보존하면서 앱을 업데이트합니다.
로드 스크립트를 덮어쓰지 않고 기존 앱의 UI 레이어를 업데이트하도록 변환을 다시 실행합니다.대상 앱은 기존 데이터 연결과 새로 고침 로직을 유지합니다.업데이트 전에 데이터 없는 백업이 자동으로 내보내집니다.기존 스크립트를 실행하고 데이터를 새로 고치려면 --reload을(를) 추가합니다.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
변수를 유지하면서 앱 업데이트
변수를 덮어쓰지 않고 기존 앱의 UI 레이어와 로드 스크립트를 업데이트하려면 변환을 다시 실행하세요.대상 앱의 로드 스크립트와 변수 모두를 온전하게 유지하려면 --preserveTargetAppScript와(과) 결합하십시오.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
Qlik Cloud 인증 설정
어떤 변환이든 실행하기 전에 qlik-cli 컨텍스트를 구성하십시오.대화형 설정은 테넌트 URL 및 API 키를 요청하고 이후 실행을 위해 자격 증명을 저장합니다.
QV2QS.exe --setupQlikAuth
프로그래밍 방식 활용 (CI/CD)
QV2QS는 미리 생성된 qlik-cli 컨텍스트 없이 직접 인증을 지원합니다.테넌트 URL과 API 키를 인라인으로 전달합니다.QV2QS는 자격 증명을 확인하고 모든 qlik-cli 호출에 인증 헤더를 주입합니다.컨텍스트 파일이 생성되거나 수정되지 않습니다.대화형 프롬프트 없이 라이선스 계약에 동의하려면 --accept-eula을(를) 포함하세요.
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
이 모드는 여러 테넌트 및 사용자 간의 동시 실행에 안전합니다.API 키는 디스크에 기록되지 않으며 로그 파일에 나타나지 않습니다.
자격 증명은 환경 변수로도 설정할 수 있습니다:
set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com
set QV2QS_QLIK_API_KEY=eyJhbG...
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain
Qlik Cloud 없이 로컬 빌드
Qlik Cloud에 연결하지 않고 변환된 출력 및 변환 보고서를 디스크에 생성합니다.로컬 전용 모드는 마이그레이션 평가, 사전 배포 검토 및 오프라인 환경을 위해 고안되었습니다.로컬 빌드 출력에는 미디어 업로드, 배경 이미지 해상도, 대체 상태 생성 또는 시트 게시가 포함되지 않습니다.완전한 배포를 위해서는, Qlik Cloud로 빌드 또는 QVF 내보내기 모드를 사용하십시오.로컬 전용 제한 사항 및 사용 사례에 대한 자세한 내용은 변환 작동 방식을(를) 참조하십시오.
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly