개발 이야기

상품등록 엑셀의 이미지 파일명과 ZIP 내용이 어긋나지 않게 하는 법

이미지 다운로드에 일부 실패해도 엑셀에 실제로 저장된 파일명만 남도록, 같은 이미지 목록에서 엑셀 셀과 ZIP을 함께 만든 과정이에요.

사이트 공개일
기록 수정일
기술과 주제
TypeScript · JSZip · Open XML
이 글의 목차

엑셀에 적힌 파일을 실제 폴더에서 찾아야 했어요

의뢰인은 이미 사용 중인 번개장터 상품등록 엑셀을 그대로 쓰고 싶었어요. 여러 상품의 이미지는 상품별 하위 폴더 없이 한곳에 모으되, 엑셀 각 행의 파일명으로 해당 상품의 이미지를 찾을 수 있어야 했어요. 한 상품의 여러 옵션을 따로 수집하기 때문에 상품 ID만으로 파일명을 만들면 같은 상품에서 가져온 이미지끼리 이름이 겹칠 수 있었어요.

다운로드에 성공한 목록으로 두 결과물을 만들었어요

수집할 때는 상품 정보와 이미지 주소를 목록에 담고, ZIP을 내보낼 때 이미지를 내려받아요. 저장할 파일명에는 엑셀에 넣을 상품 순번과 상품 식별값, 이미지 순번을 포함해요. 이미지가 준비되면 상품별로 원래 순서대로 정리해요. 이 목록의 파일명으로 엑셀을 채우고, 같은 목록의 파일을 images/ 폴더에 넣어요. 다운로드가 먼저 끝난 순서와 상관없이 엑셀의 이미지 순서가 유지돼요.

대표 이미지를 내려받지 못하면 결과 파일을 만들지 않고 다시 시도할 수 있게 안내해요. 추가 이미지만 실패했다면 누락 목록을 보여주고, 담당자가 확인했을 때 받은 파일만 내려받을 수 있어요. 예를 들어 두 번째 이미지가 빠져도 세 번째 이미지의 실제 파일명은 그대로 남아요. 엑셀에는 저장하지 못한 두 번째 파일의 이름이 들어가지 않아요.

기존 양식에서 상품 입력 영역만 갱신했어요

XLSX는 여러 XML 파일을 담은 ZIP 형식이에요. 기존 양식을 열어 첫 시트의 상품 입력 행만 갱신하고, 상단 안내 행과 서식·데이터 검증 설정을 보존했어요. 상품명·설명·판매가와 이미지 파일명은 지정된 열에 넣어요. 상품 상태와 수량은 정해 둔 값으로 채우고, 카테고리 ID는 담당자가 직접 입력하도록 비워 둬요.

출력 항목확인한 기준
판매가목록에 보이는 고정 금액·비율 마진 반영값이 엑셀과 일치
수량과 카테고리수량에 숫자 99 입력, 카테고리는 수기 입력용 빈칸 유지
이미지엑셀에 기재한 파일이 ZIP 안에 모두 존재하고, 실패한 추가 이미지는 기재하지 않음
대표 이미지 실패빠진 상태로 ZIP이 내려받아지지 않음

내보내기 테스트에서는 생성된 ZIP을 다시 열어 엑셀에 적힌 이미지 이름과 실제 파일을 대조했어요. 엑셀 검증에서는 안내 영역을 보존하면서 지정된 열에 값이 들어가는지 확인했어요. 이 두 검사가 함께 있어야 파일 두 종류가 각각 만들어진 것과 등록에 쓸 수 있게 서로 맞는 것을 구분할 수 있어요.