마법사 단계
마지막 업데이트: 2026. 10. 14.사용자 인터페이스는 전체 변환 프로세스를 위한 마법사 스타일 인터페이스입니다.마법사는 QV2QS.exe을(를) 두 번 클릭하거나 --ui 플래그와 함께 실행 파일을 실행하면 기본 브라우저에서 열립니다.현재 버전 번호는 정보 대화 상자에 표시됩니다.오른쪽 상단에 있는 테마 토글 버튼은 라이트 모드와 다크 모드 사이를 전환합니다.자세한 내용은 다크 모드를 참조하십시오.
마법사가 다음 단계를 순서대로 제시합니다.선택한 워크플로 모드에 적용되지 않는 단계는 자동으로 숨겨집니다.
설정
워크플로 모드를 선택하세요 (필수).선택한 모드에 따라 다음 단계가 결정됩니다.
- Qlik Cloud로 빌드 (기본값) — QlikView UI를 변환하고 결과 앱을 Qlik Cloud 테넌트에 직접 배포합니다.변환된 앱을 Qlik Cloud에서 즉시 보려면 이 모드를 선택하세요.이 모드는 마이그레이션을 위한 권장 워크플로입니다.
- QVF 내보내기 — Qlik Cloud 엔진을 사용하여 QlikView UI를 변환하고, 결과 앱을 QVF 파일로 내보낸 다음, 클라우드 앱을 삭제합니다.이 모드를 선택하여 다른 팀과 공유하거나 다른 테넌트로 가져올 파일을 생성할 수 있습니다.이 모드는 여전히 Qlik Cloud 테넌트와 API 키가 필요합니다.Qlik Sense Enterprise Client-Managed로 가져오는 것은 모든 버전에서 테스트되지 않았으며 공식적으로 지원되지 않습니다.자세한 내용은 Qlik Sense Enterprise Client-Managed 호환성을(를) 참조하십시오.
- 로컬 전용 — Qlik Cloud에 연결하지 않고 디스크에서 변환을 수행합니다.Qlik Cloud 테넌트 또는 API 키는 필요하지 않습니다.로컬 전용 모드는 평가, 검토 또는 오프라인 사용을 위해 전체 변환 보고서 및 빌드 출력을 생성합니다.로컬 빌드 출력에는 미디어 업로드, 배경 이미지 해상도, 대체 상태 생성 또는 시트 게시가 포함되지 않습니다. — 이러한 작업에는 배포 단계가 필요합니다.완전한 배포를 위해서는, Qlik Cloud로 빌드 또는 QVF 내보내기 모드를 사용하십시오.로컬 전용 제한 사항에 대한 자세한 내용은 변환 작동 방식을(를) 참조하십시오.빌드 출력으로 QSECM을 타겟팅하는 것은 모든 버전에서 테스트되지 않았으며 공식적으로 지원되지 않습니다.자세한 내용은 Qlik Sense Enterprise Client-Managed 호환성을(를) 참조하십시오.
프로젝트
입력 소스를 구성합니다.다음 중 하나를 수행합니다.
- 단일 프로젝트 (기본값): QVW 파일을 제공합니다 (필수).PRJ 자동 생성은 기본적으로 활성화되어 있으며, QVW 파일에서 PRJ 폴더를 자동으로 생성합니다.PRJ 폴더 또는 ZIP 파일을 수동으로 제공하려면 이 옵션을 비활성화하세요.예제 사용해보기를 클릭하여 탐색 없이 번들된 예제 프로젝트를 로드하세요.버튼은 QVW 필드가 비어 있을 때만 표시됩니다.예제 프로젝트를 참조하십시오.
- 배치: 스캔할 폴더를 하나 이상 제공합니다 (필수).QV2QS는 일치하는 모든 QVW 및 PRJ 쌍을 재귀적으로 찾습니다.예시 사용해 보기를 클릭하여 번들로 제공되는 예시 폴더로 폴더 필드를 채우세요.배치 작업자는 동시에 실행되는 변환 수를 제어합니다 (기본값: CPU 코어 기반 자동 감지).자세한 내용은 일괄 변환을(를) 참조하십시오.
QV2QS는 QlikView Server 또는 공유 네트워크 드라이브에 있는 프로덕션 파일이 아닌, 로컬 작업 폴더에 있는 원본 문서의 복사본을 항상 가리키도록 하십시오.QlikView Desktop 엔진은 PRJ 생성 중에 파일 잠금을 획득하며, 이는 활성 QlikView 세션과 충돌할 수 있습니다.자세한 내용은 소스 파일 안전을(를) 참조하십시오.
출력
출력 루트 폴더를 설정합니다 (필수).QV2QS는 출력 루트 내부에 프로젝트 이름을 딴 하위 폴더를 자동으로 생성합니다 (예: <outputDir>/Sales/).두 프로젝트가 같은 이름을 공유하는 경우, 충돌을 피하기 위해 _2, _3 접미사가 추가됩니다.실행 전에 기존 로그 파일을 삭제하려면 로그 정리를 활성화하세요.
Qlik Cloud 인증
이 단계는 Qlik Cloud로 빌드 및 QVF 내보내기 모드에서만 나타납니다.
Qlik Cloud 테넌트로 인증하기 위해 qlik-cli 컨텍스트를 선택하거나 생성합니다 (필수).테넌트 URL 및 API 키를 제공하여 새 컨텍스트를 생성합니다.마법사가 진행하기 전에 연결의 유효성을 검사합니다.
Qlik Cloud 앱
이 단계는 Qlik Cloud로 빌드 및 QVF 내보내기 모드에서만 나타납니다.
| 설정 | 설명 | 기본값 |
|---|---|---|
| 앱 이름 | Qlik Cloud에서 Qlik Sense 앱의 이름 | QVW 파일 이름, PRJ 폴더 이름, 또는 출력 폴더 이름 |
| 다시 로드 | 빌드한 후 앱을 다시 로드하여 로드 스크립트를 실행합니다. | 켜기 |
| 자동 이진 | 바이너리 데이터 로드를 위해 QVW 파일을 임시로 업로드한 다음, 다시 로드한 후 파일을 삭제합니다.새로고침이 필요합니다. | 켜기 |
| 바이너리 앱 ID | 업로드하는 대신, 이진 로드를 위해 Qlik Cloud에 있는 기존 QVW 또는 QVF 앱을 사용하십시오.새로고침이 필요합니다.찾아보기 버튼을 클릭하여 QVW 선택기를 엽니다. | — |
| 기존 앱 재사용 | 새로운 앱을 생성하는 대신, 이전에 생성된 앱을 업데이트합니다.활성화되면, QV2QS는 출력 폴더에서 선택한 QVW 파일과 일치하는 이전 배포를 확인하고 앱 ID를 자동으로 채웁니다.이전 배포를 찾을 수 없는 경우, 앱 ID를 수동으로 입력하거나 찾아보기 버튼을 클릭하여 QVF 선택기를 엽니다. | 꺼짐 |
| 로드 스크립트 유지 | 대상 앱에서 기존 로드 스크립트를 유지합니다.변환된 스크립트가 적용되지 않았습니다.기존 앱 재사용이 필요합니다.기본적으로 다시 로드를 끕니다. 기존 스크립트를 실행하려면 다시 활성화하십시오. | 꺼짐 |
| 변수 보존 | 대상 앱에서 기존 변수를 유지하세요.변환된 변수가 적용되지 않습니다.필요합니다 기존 앱 재사용. | 꺼짐 |
| 배포 전 백업 건너뛰기 | 앱을 덮어쓰기 전에 QVF 백업을 내보내지 마십시오.기본적으로 데이터 없는 백업은 cloud/backups/에 저장됩니다.필요합니다 기존 앱 재사용. |
꺼짐 |
| 시트 게시 | 빌드 후 변환된 모든 시트를 기본 시트로 게시합니다.기본 시트는 앱에 액세스할 수 있는 모든 사용자에게 표시됩니다.이 설정을 비활성화하면 시트가 개인(미게시) 개체로 유지됩니다.기존 앱 재사용이 활성화되면, 이 설정은 새 시트에만 적용됩니다.이전에 게시된 시트는 이 설정과 관계없이 자동으로 복원됩니다. | 켜기 |
| 데이터 없이 빌드 | 빌드 단계에서 데이터 로딩 건너뛰기.앱은 데이터 없이 테넌트에 조립되어, 새로고침을 기다릴 필요 없이 UI 구조를 테스트할 수 있습니다. | 꺼짐 |
| 데이터 없이 내보내기 | 내보낸 QVF 파일에서 데이터를 제거합니다.클라우드 앱은 빌드에서 가져온 데이터를 여전히 포함할 수 있지만, 다운로드된 QVF는 더 작습니다.QVF 모드에서만 내보내기. | 꺼짐 |
바이너리 앱 ID 및 기존 앱 재사용 필드에는 클라우드 앱 선택 모달을 여는 찾아보기 버튼이 포함되어 있습니다.각 선택기는 연결된 테넌트에서 앱을 로드하며, 이름, 소유자, 공간 또는 앱 ID로 검색 필터링을 제공합니다.QVW 선택기에서도 앱 유형 필터(QVW, QVF 또는 모두)를 제공합니다.목록에서 앱을 선택하면 필드가 자동으로 채워집니다.
표현 조정
스타일링
다음 설정은 시트 모양 및 레이아웃 동작을 제어합니다.
테마
| 설정 | 설명 | 기본값 |
|---|---|---|
| 앱 테마 | 변환된 앱에 적용된 Qlik Sense 테마.드롭다운에 4가지 기본 제공 Qlik 테마가 나열됩니다.Qlik Cloud 컨텍스트가 구성되면 새로 고침 버튼을 클릭하여 테넌트에 설치된 사용자 지정 테마를 가져옵니다.Sense 클래식은 QlikView와 가장 높은 1:1 충실도를 제공합니다.비고전 테마는 개체 테두리, 배경색, 글꼴 및 안쪽 여백을 변경할 수 있습니다.테마는 기본값만 설정합니다. 사용자는 Qlik Sense 클라이언트에서 언제든지 테마를 전환할 수 있습니다. | Sense 클래식 |
배경
| 설정 | 설명 | 기본값 |
|---|---|---|
| 시트 배경 이미지 | QlikView 시트 배경화면 추출 및 적용 | 켜기 |
| 문서 배경으로 대체 | 배경이 없는 시트에 문서 수준 배경을 사용합니다. | 켜기 |
| 배경색 재정의 | 모든 시트에 단색 채우기 적용됨 (#RRGGBB) |
— |
레이아웃
| 설정 | 설명 | 기본값 |
|---|---|---|
| 시트 머리글 표시 | 변환된 시트에 헤더 영역 추가 | 꺼짐 |
| 숨겨진 시트 건너뛰기 | 표시 조건이 항상 거짓인 시트 생략 | 꺼짐 |
목록 상자 및 정렬
| 설정 | 설명 | 기본값 |
|---|---|---|
| QV 목록 상자 색상 유지 | 원래의 QlikView 목록 상자 배경색 및 투명도 적용 | 켜기 |
| 날짜 필드 정렬 가드 | 연도, 분기, 월 등 날짜와 유사한 목록 상자 필드는 선택 상태 대신 시간순으로 정렬하여 유지합니다.자세한 내용은 인수 참조를 참조하십시오. | 켜기 |
고급
| 설정 | 설명 | 기본값 |
|---|---|---|
| 고정된 시트 캔버스 | 픽셀 단위로 정확한 QlikView 스타일의 위치 지정을 활성화합니다.배율 요소, 최소 치수 및 캔버스 자르기 옵션을 표시합니다.캔버스 배율과 개체 배율은 기본적으로 연결되어 있습니다. 독립적인 값을 설정하려면 체인 아이콘을 클릭하세요.자세한 내용은 전환 레이아웃 설정을 참조하세요. | 켜기 |
| 동적 시트 자동 확장 | 시트가 기본 그리드 높이를 초과하여 수직으로 확장되도록 허용 | 켜기 |
| 미디어 업로드 작업자 | Qlik Cloud에 미디어 파일(배경화면 및 이미지) 업로드를 위한 병렬 작업자 수.Qlik Cloud로 빌드 및 QVF 내보내기 모드에 적용됩니다. | 2
|
| 스크립트 교체 | 스크립트 교체 처리를 켜거나 끄고 개별 규칙을 관리합니다.자세한 내용은 인수 참조를 참조하십시오. | 켜기 |
스크립트 교체 섹션에는 인라인 규칙 편집기가 포함되어 있습니다.마스터 스위치를 토글하여 모든 스크립트 처리를 활성화하거나 비활성화합니다.섹션을 확장하여 개별 규칙을 보거나, 추가하거나, 편집하거나, 삭제할 수 있습니다.각 규칙은 독립적으로 켜거나 끌 수 있습니다.여덟 가지 기본 제공 규칙을 복원하려면 기본값으로 재설정을 클릭하세요.요약 배지는 활성화된 규칙의 개수를 표시합니다.
실행 순서를 변경하려면 규칙의 위아래 화살표 버튼을 클릭하세요.실행 순서가 낮을수록 먼저 실행됩니다.내보내기를 클릭하여 모든 규칙을 JSON 파일로 다운로드하세요.Import를 클릭하여 JSON 파일에서 규칙을 로드하고 현재 세트를 대체합니다.가져온 파일은 각 규칙에 description, pattern, 그리고 search 필드를 포함하는 JSON 배열이어야 합니다.
가져오기용 사용자 지정 규칙 파일을 만들려면, 먼저 내장 규칙을 올바른 형식으로 가져오기 위해 Export를 클릭하십시오.내보낸 파일을 편집하여 규칙을 추가, 제거 또는 수정한 다음, 가져오기를 클릭하여 업데이트된 세트를 로드합니다.
사용자 지정 규칙 또는 비활성화된 기본값이 구성된 경우, 명령 미리 보기에 알림이 표시됩니다.복사된 명령에는 사용자 지정 규칙이 포함되어 있지 않습니다.규칙을 JSON 파일로 내보내고 --scriptReplacements <path>를 명령에 추가하여 명령줄에 사용자 지정 규칙을 포함합니다.
규칙이 작동하는 방식, 즉 2단계 매칭 프로세스와 내장 규칙 목록에 대한 설명은 인수 참조를 참조하십시오.
고급 단계에서 Mockup Studio를 열어 고정 캔버스 및 동적 그리드 레이아웃을 대화형으로 미리 보고, 배율을 조정하고, 설정을 마법사로 다시 적용합니다.
전환 보고서
다음 설정은 변환 보고서 출력을 제어합니다.
| 설정 | 설명 | 기본값 |
|---|---|---|
| 보고서 생성 | 콘솔 변환 보고서 생성 | 켜기 |
| 엑셀 보고서 | 보고서를 개체별 세부 정보 및 자동화 점수를 포함하는 XLSX 파일로 내보내기.파일 이름을 입력하세요 (예:MyReport) 또는 전체 경로..xlsx 확장이 자동으로 추가됩니다.비워두면 reports/에서 자동으로 이름이 지정됩니다. |
켜기 |
| 선택 항목 및 검색 개체 포함 | 보고서에 현재 선택 상자 및 검색 개체를 포함합니다.이것들은 Qlik Sense에 의해 자동으로 추가되며 기본적으로 제외됩니다. | 꺼짐 |
검토
실행하기 전에 모든 설정을 확인하십시오.검토 단계에서는 프로젝트, 워크플로, 클라우드 및 출력 구성에 대한 요약 카드를 표시합니다.배치 모드에서는 발견된 모든 프로젝트가 테이블에 나열됩니다.
사이드바의 필수 작업 체크리스트는 실행 전에 구성해야 하는 항목을 추적합니다.항목은 다음 범주로 그룹화됩니다: 워크플로, 입력, 출력, 및 클라우드 인증.각 항목은 구성된 경우 확인됨으로 표시되거나, 값이 누락된 경우 설정 필요로 표시됩니다.항목을 클릭하여 관련 마법사 단계로 바로 이동합니다.
명령 미리 보기 패널은 현재 마법사 구성에 해당하는 CLI 명령을 표시합니다.PowerShell 및 Bash 구문 간 전환명령어를 클립보드로 복사하려면 복사를 클릭합니다.명령 미리 보기는 CLI 인수를 학습하거나 스크립트 재실행을 위해 정확한 명령을 저장하는 데 유용합니다.
변환을 시작하려면 실행을 클릭하세요.
실행
변환이 실행되는 동안 실시간 콘솔 출력을 표시합니다.실행 중인 변환을 중지하고, 실시간으로 로그를 팔로우하며, 실행이 완료되면 출력 폴더 또는 Qlik Cloud 앱을 엽니다.