가져오기 부분 실패 안내, 성공한 행과 다시 처리할 행 나누기

기준일 2026-10-21 · AZET 운영팀 작성

이 글은 AZET 운영팀의 실무 참고용 제안입니다. 예시는 설명을 위한 가상 상황이며 특정 제품의 현재 기능이나 운영 조건을 뜻하지 않습니다.

‘일부 항목을 가져오지 못했습니다’라는 문구를 보고 고객이 파일 전체를 다시 올립니다. 이미 들어간 항목까지 다시 처리되는지 알 수 없다면 결과가 더 복잡해질 수 있습니다. 부분 실패 안내는 현재 반영된 범위와 다음에 처리할 범위를 나누는 데 초점을 둡니다.

결과의 상태를 먼저 설명합니다

성공, 실패, 미처리가 실제로 어떻게 구분되는지 확인합니다. 검토 단계에서 걸러진 행과 저장을 시도하다 실패한 행은 처리 상태가 다를 수 있습니다. 결과 화면이 제공하지 않는 세부 원인을 임의로 덧붙이지 않습니다.

가상 예시로 여러 행 가운데 일부가 형식 오류로 제외되었다고 가정해 봅니다. 고객에게는 처리된 행의 수만 보여 주기보다 어떤 항목을 다시 봐야 하는지 찾을 수 있는 목록이 필요합니다. 아래 표는 그 안내의 구성 예시입니다.

결과 항목	보여 줄 정보	고객의 다음 행동
성공	반영된 대상의 식별값	결과 화면에서 확인
실패	원본 위치와 확인된 이유	해당 값을 검토
미처리	실행되지 않은 범위	재시도 조건 확인
확인 중	아직 판단되지 않은 상태	확인 경로에서 상태 조회

원본의 위치와 수정 대상을 연결합니다

행 번호를 제시한다면 제목 행을 포함하는지부터 명확하게 씁니다. 사용자가 파일을 정렬한 뒤 번호만 보고 다른 항목을 고칠 수 있으므로, 안전하게 표시할 수 있는 항목 식별값도 함께 제공하는 구성을 검토합니다.

오류 설명은 ‘잘못된 값’보다 어떤 입력 조건과 맞지 않았는지 구체적으로 적습니다. 허용되는 형식은 실제 기준을 확인한 내용만 씁니다. 원본 값을 바꾸는 과정에서 의미가 달라질 수 있다면 자동으로 고치기보다 담당자가 판단할 질문을 남깁니다.

재시도 전에 반영 범위를 확인합니다

실패한 행만 다시 올릴 수 있는지, 전체 파일을 쓰면 기존 항목을 갱신하는지, 새 항목을 만드는지는 제품 동작에 따라 다릅니다. 이 부분이 확인되지 않았다면 ‘다시 업로드하세요’라는 한 문장으로 끝내지 않습니다.

중복 판정에 쓰이는 값이 있다면 어떤 값인지 확인해 안내합니다. 같은 이름이라는 이유만으로 같은 항목으로 취급된다고 가정하지 않습니다. 다시 처리한 뒤에는 최초 결과와 재시도 결과를 연결해 아직 남아 있는 항목을 확인합니다.

고객에게 전달할 결과 파일은 수정에 필요한 범위로 구성합니다. 원본의 모든 열을 오류 메일 본문에 복제하면 업무 정보가 불필요하게 퍼질 수 있습니다. 오류 위치와 이유를 중심으로 정리하고 상세 자료를 확인할 적절한 경로를 안내합니다.

자주 묻는 질문(FAQ)

Q1. 실패한 행을 지우면 작업이 끝나나요? 그 행이 업무에 필요한지 먼저 확인합니다. 제외할지 수정할지 결정하고 남은 처리 범위를 기록합니다.

Q2. 같은 파일을 다시 올려도 괜찮나요? 기존 항목을 처리하는 방식을 확인해야 합니다. 재시도 범위와 중복 처리 조건을 알아본 뒤 안내합니다.

Q3. 전체 완료 시점을 어떻게 설명하나요? 필요한 항목이 모두 확인되었거나 제외 사유가 정리된 상태로 기준을 잡습니다. 성공 메시지 한 번만으로 판단하지 않습니다.

AZET 관련 안내는 azet.io에서 확인하세요.