프로그램 설치 및 환경설정

기존 주차 관리 웹에 등록되어 있던 정기권 차량 정보들을 신규 웹 서비스로 한 번에 이전하기 위해 PC용 정기차량 일괄등록 프로그램(Batch Registration)을 설치하여 대량 업로드 작업을 수행할 수 있습니다. 이 프로그램은 Windows 10 이상 운영체제에서 구동 가능합니다.

설치 및 경로 설정

다운로드한 BatchRegistrationSetup.exe 파일을 실행한 뒤, [다음] 버튼을 클릭하고 설치 경로를 설정하여 설치를 완료합니다.

사전 요구 사항 (.NET Runtime 설치)

프로그램 실행 시 'Runtime' 관련 안내 알림창이 나타난다면, [Download it now] 버튼을 클릭하여 필수 시스템 런타임 환경을 다운로드하여 먼저 설치한 후 재실행해야 정상 구동됩니다.

서버 연결 설정 (IP 주소 설정)

설치가 완료된 후 바탕화면의 바로가기 아이콘을 더블 클릭하여 실행합니다. 만약 프로그램 실행 중 'DB 접속에 실패하였습니다' 오류창이 뜬다면, 프로그램 설치 PC와 주차시스템의 데이터베이스(DB) 서버가 분리 구동 중인 상태이므로 주소 매핑 작업이 필요합니다.

오류창의 [확인]을 눌러 프로그램을 닫은 뒤, 아래 순서에 따라 통신 설정을 수동으로 수정합니다.

• ① 기본 설치 경로(C:\Parking\BatchRegistration) 폴더로 이동합니다.
• ② 해당 폴더에서 ParkingConfig.ini 구성 파일을 찾아 엽니다.
  
• ③ 파일 내용 중 IP=127.0.0.1로 지정된 부분의 주소를 실제 구동 중인 주차시스템 DB 서버의 IP 주소로 수정한 후 저장(Ctrl + S)하고 창을 닫습니다.
  
• ④ 바탕화면의 실행 아이콘을 다시 더블 클릭하여 로그인 접속을 재시도합니다.

정기권 그룹 사전 등록

최초 구동 시 '정기권 그룹 정보가 없습니다' 오류창이 뜬다면, 데이터를 임포트하기 전 관리자 웹(PAA)상에 매칭할 정기권 출입 그룹이 하나도 없기 때문입니다. 관리자 웹(PAA)의 [정기권 관리 > 정기권 그룹] 메뉴에서 최소 하나 이상의 그룹을 선행 생성한 후 재시작해야 합니다.

정기권 차량 일괄등록 방법

정기권 데이터 불러오기

프로그램 화면 좌측 상단의 [엑셀파일 선택] 버튼을 클릭합니다.

미리 준비해 둔 차량 데이터 엑셀(Excel) 파일(.xlsx 또는 .xls)을 선택하여 가져옵니다.

항목 매핑

엑셀 열 데이터와 시스템 데이터베이스(DB) 테이블 필드를 매칭하는 작업입니다. 업로드된 그리드의 각 열 상단 콤보 박스를 각각 클릭하여 알맞은 필드명(차량번호, 시작일자, 종료일자, 동, 호 등)을 선택해 줍니다.

매핑할 열들이 올바르게 설정되었는지 전체 필드 목록 및 제어 영역을 확인합니다.

[데이터 검수 및 세부 규격]

• 필수 항목: 차량번호, 시작일자, 종료일자는 필수 항목으로, 하나라도 매핑이 누락되거나 내용이 공란일 경우 등록이 불가능합니다.
• 차량번호: 차량번호 열의 데이터는 중간 공백(띄어쓰기)이 없이 입력되어 있어야 합니다.
• 일자 논리 오류 방지: 시작일자보다 더 이전 날짜를 종료일자로 지정할 수 없습니다.
• 날짜 허용 규격: 'YYYY-MM-DD' (예: 2026-05-12) 또는 'YYYY.MM.DD' (예: 2026.05.12) 형태로 입력되어야 합니다. 슬래시(/) 형태의 일자 포맷은 인식되지 않으므로 유의하십시오.
• 세대(동/호) 입력: 세대 지정을 병행 등록하는 경우, 동과 호 정보가 둘 다 입력되어 있어야 연동되며, 필드 매핑 시 실제 명칭 변경 여부와 무관하게 콤보 박스에서 각각 '동'과 '호'를 정확히 매핑하여 지정해야 합니다.
• 명칭 변경 동기화: 관리자 웹(PAA)에서 기본 필드 명칭을 수정한 경우, 수정 사항을 적용하기 위해 일괄등록 프로그램을 반드시 완전히 종료한 후 재구동하여 임포트를 재수행하십시오.

데이터 수정

불러온 전체 데이터 중 실제 등록에서 제외해야 하는 행이 있거나 잘못 표기된 오타 정보가 있다면, 임포트 직후 화면 상에서 일부 편집할 수 있습니다. 불필요한 열을 클릭한 후 상단 [선택한 줄 제거] 버튼을 누르면 일괄 제거되며, 그리드의 개별 셀 값을 직접 클릭하여 수동 수정할 수 있습니다.

데이터 저장 및 완료

검수가 완료된 최종 리스트를 실제로 서버에 밀어 넣어 반영하려면 우측 상단의 [저장] 버튼을 클릭합니다.

• ❶ 중복 차량인 경우 Skip 체크 기능: 기존에 이미 서버에 등록되어 구동 중인 중복 차량 데이터가 존재할 때, 이 기존 등록 상태를 그대로 보호하고 업데이트를 스킵하려면 '중복 차량인 경우 Skip'에 반드시 체크하고 저장을 누릅니다. 이를 선택하지 않고 진행 시 기존 차량 정보 및 만료 주기가 새로 업로드한 엑셀 행 데이터로 완전히 덮어씌워지므로 각별한 주의가 요구됩니다.
• ❷ 등록 결과 알림: 저장이 무사히 끝나면 성공, 중복, 오류 카운트가 표시된 알림 결과창이 나타납니다. 이때 임포트 행 중 노란색으로 하이라이트 경고가 쳐지며 정상 등록되지 못한 항목들은 다음 장인 데이터 검증 오류 내용을 확인하여 조치하십시오.

등록 시 유의사항

설치 전 유의사항

본 프로그램은 Windows 10 이상의 데스크톱 PC 환경에서 구동하는 단독 설치형 실행 프로그램입니다. 업로드하려는 소스 파일의 포맷은 Excel 표준 통합 문서 형식이어야 하며, csv 형식의 텍스트 파일은 등록을 지원하지 않으므로 사전에 파일 형식을 .xlsx 혹은 .xls로 변환하여 준비하십시오.

데이터 검증 오류

임포트 및 저장 중 아래 예시처럼 노란색 경고 표시와 함께 팝업 메시지가 뜬다면, 형식에 맞지 않는 텍스트가 삽입된 셀이 존재한다는 것을 의미합니다. 노란색으로 강조된 해당 열의 데이터 값을 직접 더블 클릭하여 올바른 값으로 가공하여 저장해 주어야 합니다.

[주요 오류 발생 유형 및 해결 조치 사항]

• ❶ 필수 항목 공란 및 공백 누락: 차량번호, 시작일자, 종료일자 컬럼은 한 칸도 공백이 있어서는 안 됩니다. 차량번호의 띄어쓰기는 백스페이스로 붙여서 입력해 주시고, 일자 정보가 누락된 경우 올바른 기간을 지정해 줍니다. 시작일보다 종료일이 앞설 수 없으며 날짜 형식을 'YYYY-MM-DD' 또는 'YYYY.MM.DD'로 명확하게 일치시킵니다.
• ❷ 정기권 그룹 부재: 업로드하려는 데이터 중 특정 그룹명이 지정되어 있으나 관리자 웹(PAA)에 사전에 동명의 정기권 그룹이 등록되어 있지 않은 경우 오류가 발생합니다. 사전에 관리자 웹(PAA) 접속하여 일치하는 정기권 그룹을 추가해 주시거나, 별도 분리가 불필요하면 웹 콘솔에서 '[기본그룹]'을 하나 추가한 후 일괄등록을 수행하십시오.
• ❸ 세대(동/호) 및 상세 유의사항:
    • 입력 양식: 동과 호는 반드시 세트로 기입되어야 하며 둘 중 하나만 빈칸일 수 없습니다.
    • 세대 자동 등록: 세대 정보(동/호)가 엑셀 데이터에 포함되어 있으면, 주차시스템 관리자 웹(PAA)에 사전에 해당 동/호 세대가 생성되어 있지 않더라도 업로드 프로세스 도중 자동으로 신규 세대가 생성되면서 차량과 매핑됩니다.
    • 세대 호출 여부: 사용 여부의 텍스트 값은 Y 또는 N 대소문자 구분 없이 1글자로 정확히 입력해 줍니다.