일괄 스캔 작동 방식
마지막 업데이트: 2026. 10. 14.QV2QS는 디렉터리를 재귀적으로 스캔하여 QlikView 프로젝트를 자동으로 감지합니다.
재귀적 디렉터리 스캔
QV2QS는 배치 디렉터리를 재귀적으로 스캔하여 모든 하위 폴더를 탐색하고 QlikView 프로젝트 파일을 찾습니다.스캐너는 .qvw 및 .qvf 파일을 모두 검색합니다.QlikView 12.70 이상에서는 기본적으로 문서를 .qvf(으)로 저장할 수 있으므로, 스캐너는 형식이 변경된 환경에서 파일이 누락되지 않도록 두 확장자를 모두 확인합니다.QVW 및 QVF 형식에 대한 자세한 내용은 시스템 요구 사항을 참조하십시오.
발견된 각 QVW 또는 QVF 파일에 대해, QV2QS는 동일한 디렉터리에서 일치하는 PRJ 아티팩트를 찾습니다:
- PRJ 폴더 (
<Name>-prj/) - PRJ zip 파일 (
<Name>-prj.zip)
이름이 일치해야 합니다(대소문자 구분 안 함).동일한 소스 파일에 대해 PRJ 폴더와 PRJ zip이 모두 존재하는 경우, 폴더가 우선 적용됩니다.일치하는 PRJ 아티팩트가 없는 소스 파일은 스캔 결과에 누락된 것으로 보고됩니다.
QV2QS는 스캔 시 일반적인 비프로젝트 디렉터리를 건너뜁니다: .git, .svn, .hg, node_modules, build, dist, venv, __pycache__ 및 마침표로 시작하는 디렉터리.출력 경로가 스캔 루트 내에 있는 경우 출력 디렉터리도 제외됩니다.
결과는 예측 가능한 순서를 위해 상대 디렉터리 경로 및 파일 이름순으로 정렬됩니다.
여러 디렉터리 스캔 중
세미콜론으로 경로를 구분하여 여러 디렉터리를 스캔합니다.QV2QS는 중첩된 경로의 중복을 자동으로 제거합니다.한 경로가 다른 경로의 하위 디렉터리인 경우 상위 경로만 스캔됩니다.
QV2QS.exe --batchDir "C:\Projects\Region1;C:\Projects\Region2" --outputDir C:\Output --unbuildOnly
웹 UI에서 스캔하기
웹 UI는 프로젝트 단계에서 시각적 일괄 스캔 워크플로를 제공합니다.배치 디렉터리 필드에 하나 이상의 폴더 경로를 입력하고 폴더 스캔을 클릭합니다.스캔 결과는 두 가지 뷰가 있는 모달에 표시됩니다:
- 트리 뷰 — 확장/축소 기능이 있는 계층적 폴더 트리입니다.각 폴더에는 총 QVW, 페어링된 프로젝트 및 누락된 PRJ 폴더의 수가 표시됩니다.큰 트리를 탐색하려면 모두 펼치기 및 모두 접기를 사용하세요.
- 목록 보기 — 폴더 경로별로 정렬된 동일한 열의 플랫 테이블입니다.하단의 요약 행에 합계가 표시됩니다.
모달 헤더에는 KPI 수가 표시됩니다: 총 쌍 수, 누락된 PRJ 및 총 QVW 수.자동 PRJ 생성이 활성화되어 있으면 누락된 PRJ 항목에 자동 생성 표시기가 표시됩니다.
검색 필드를 사용하여 이름이나 경로별로 결과를 필터링하세요.체크박스를 사용하여 특정 하위 폴더를 선택하면 해당 폴더만 배치에 포함됩니다.선택한 항목이 없으면 모든 폴더가 포함됩니다.선택 항목을 적용하려면 수락을 클릭합니다(선택 항목이 원본 스캔과 다를 경우 버튼이 변경 사항 수락으로 변경됩니다).대규모 디렉터리 트리에서는 전체 화면 보기를 위해 모달을 최대화할 수 있습니다.