본문으로 건너뛰기
인터페이스 언어: 한국어
디자인 / Signal

CSV 가져오기는 ‘가져오기’ 버튼을 누르기 전에 시작된다

CSV 열 매핑, 변경 미리보기와 갱신할 레코드의 식별을 설계합니다. 사용자는 카탈로그에 저장하기 전에 가져오기의 결과를 알아야 합니다.

본문 언어: 한국어

밤 정원에서 한 여성이 잠든 고양이 옆에 있는 빛나는 흰 꽃잎을 살펴봅니다.
목차

파일에 열두 행이 있다고 해서 새 상품이 열두 개라는 뜻은 아니다. 가상의 가져오기에서는 세 항목을 새로 만들고 네 항목을 갱신하며 두 항목은 그대로 둔다. 세 항목은 확인이 필요하다. ‘상품 12개 가져오기’라는 문구는 사용자가 결정하기 전에 이 모든 차이를 지워 버린다.

CSV는 표를 전달하는 형식이고 가져오기는 데이터를 바꾸는 작업이다. 저장하기 전에 열의 의미와 레코드의 동일성, 예상 결과를 알아야 한다. ‘유효한 파일’이라는 메시지만으로는 너비가 올바른 단위로 저장될지, 빈 셀이 기존 설명을 지울지 알 수 없다.

가상의 작업실 장비 카탈로그에 데이터를 가져오는 설계를 살펴보자. 예시의 숫자와 상태는 결정을 설명하기 위한 것이며 실제 구축이나 공급사 서비스 시험 결과가 아니다. 관심사는 받은 스프레드시트에서 사용자가 결과를 이해하고 변경을 받아들이기까지의 경로다.

선택한 파일을 먼저 살펴본다

첫 화면은 목적지를 밝혀야 한다. 데이터가 어느 카탈로그나 표로 들어가며 가져오기가 어떤 작업을 할 수 있는가? ‘새 항목 추가’와 ‘기존 항목 갱신’의 범위는 다르다. 제품이 두 작업을 동시에 허용한다면 사용자는 마지막 버튼을 누르기 전에 이를 알아볼 수 있어야 한다. 이는 작업의 일부이지 관리자만을 위한 고급 설정이 아니다.

공급사의 파일에는 ‘코드’, ‘설명’, ‘너비’, ‘상태’ 열이 있을 수 있다. 모두 익숙해 보이지만 ‘상태’는 재고 수량일 수도, 제품의 기술적 상태일 수도 있다. 대상 필드의 분명한 이름과 값의 예시가 차이를 찾는 데 도움이 된다. 비슷한 이름을 기준으로 한 자동 매핑은 검토할 제안으로 남아야 한다.

매핑 전에 애플리케이션이 파일을 어떻게 나눠 읽었는지 보여 준다. 첫 행을 머리글로 읽었는가? 한글이나 폴란드어 문자가 유지되고 설명 안의 구분자 때문에 값이 밀리지 않았는가? 사용자는 문자 저장 방식인 인코딩을 몰라도 이런 결과를 알아볼 수 있어야 한다. 한 행 전체가 한 열에 들어갔다면 그 열을 임의의 필드에 강제로 연결하고 계속 진행하게 해서는 안 된다.

머리글은 단서이지 데이터가 올바르다는 증거는 아니다. 첫 열의 이름이 ‘ID’여도 실제로는 스프레드시트의 연속 행 번호일 수 있다. 카탈로그에는 자체적인 식별자 정의가 필요하다. 상품 데이터 모델 (폴란드어)에서 이런 개념을 미리 정한다. 가져오기 도구는 파일마다 새 정의를 만들지 말고 이를 사용해야 한다.

미리보기의 범위도 알아볼 수 있어야 한다. ‘행 5개 예시’와 ‘전체 파일 검사 완료’는 다른 말이다. 애플리케이션이 앞부분만 보여 준다면 표 옆에 표시한다. 일부가 창에 잘 들어맞았다는 이유로 전체에 녹색 상태를 부여해서는 안 된다. 전체 검사는 정한 범위를 실제로 모두 다루는 방식이 필요하다.

파일을 교체할 때는 새 자료를 분명하게 식별하고 이전 검사 결과를 무효화한다. 앞선 매핑이 유용할 수는 있지만 현재 열과 비교해야 한다. 파일 B의 미리보기를 파일 A의 이름으로 보거나 예전 검사 결과를 새 결과로 받아들이게 해서는 안 된다. 화면을 백그라운드 처리와 연결하기 전에 이 상태를 그려 볼 만하다.

매핑은 머리글뿐 아니라 의미를 연결한다

각 원본 열마다 선택한 대상 필드, 몇 가지 값, 의도적으로 건너뛸 수 있는 선택지를 보여 준다. 필수 필드라면 무엇이 부족한지 설명해야 한다. 파일에 적절한 정보가 없다면 수정된 자료를 준비하러 돌아가는 것이 올바른 종료일 수 있다. 양식을 완성하려고 아무 열이나 연결하도록 강요할 필요는 없다.

Atlassian은 새로운 Jira Cloud 가져오기에서 자동 및 수동 열 매핑을 설명한다(영어). 자동 매핑을 확인하도록 권하고 매핑되지 않은 열은 제외된다고 안내한다. 파일에 정보가 있다는 것과 시스템에 그 정보가 반영된다는 것의 차이를 보여 주는 구체적인 예다.

예시 카탈로그에서 ‘너비’는 상품 너비의 센티미터 필드에 들어가야 한다. 공급 파일의 값은 밀리미터로 기록돼 있다. 입력된 120mm는 12cm에 해당해야 한다. 필드를 선택했다는 이유만으로 기본 변환이 조용히 실행돼서는 안 된다. 변환을 제공한다면 미리보기에 변환 전후 값을 보여 줘야 한다. 제공하지 않는다면 단위 이름만 맞춰 놓고 호환되는 척하지 말고 자료에서 무엇을 고쳐야 하는지 알려 준다.

숫자 값에서는 쉼표, 정밀도와 허용 범위도 중요하다. 숫자 입력 필드 설계 (폴란드어)는 입력 해석을 결정하는 데 도움이 되지만 가져오기는 그 해석을 열 전체에 적용해야 한다. ‘12,5’ 예시에서는 앱이 12와 2분의 1을 받았는지, 다른 방식으로 읽었는지 알아볼 수 있어야 한다. 입력 옆에 결과를 보여 주면 추측할 필요가 줄어든다.

목록형 값에도 별도의 매핑이 필요하다. 스프레드시트의 ‘준비됨’은 카탈로그의 ‘게시 준비’에 해당할 수 있지만 반드시 ‘게시됨’을 뜻하지는 않는다. 어느 값을 기존 목록으로 바꾸고 어느 값에 결정이 필요한지 보여 준다. 새 선택지를 자동으로 만드는 일도 팀의 작업 구조를 바꾼다. 모든 단어를 받아들이는 편이 쉽다는 이유만으로 일어나서는 안 된다.

열을 건너뛰는 것과 그 열의 셀에 값이 없는 것을 구분한다. 설명을 갱신할 때 빈 셀은 ‘새 정보가 없음’ 또는 ‘기존 내용을 지움’을 뜻할 수 있다. 사용자는 작업에 맞는 규칙을 선택해야 한다. 기존 설명이 비어 있지 않은 특정 레코드에서 어떤 결과가 나는지 미리보기에 보여 주면 더 좋다.

Shopify는 상품 덮어쓰기에서 필수가 아닌 열의 빈 값과 열 자체의 생략을 구분한다(영어). 전자는 기존 값을 비울 수 있고 후자는 유지할 수 있다. 문서는 필드 간 의존 관계도 설명한다. 따라서 자체 가져오기 도구는 빈칸이 항상 무해한 것처럼 보이게 하지 말고 규칙을 밝혀야 한다.

갱신에는 동일성 기준이 필요하다

예시 카탈로그에는 코드 PR-014인 상품이 이미 있다. 가져오기 대상이 같은 변형이라면 너비 변경을 제안할 수 있다. 새 상품의 제목이 비슷하다는 것만으로 기존 레코드를 갱신하기에는 부족하다. 미리보기는 매칭 근거와 알아볼 수 있는 대상 객체를 보여 줘 사용자가 무엇이 대체될지 확인할 수 있게 해야 한다.

Airtable의 CSV import extension에서는 기존 레코드와 합칠 필드를 선택할 수 있다(영어). 설명된 규칙은 대소문자를 구분하며 키가 비어 있으면 새 레코드가 만들어질 수 있다. 이는 해당 확장 기능의 동작이지 모든 가져오기 도구에 적용할 규칙이 아니다. 하지만 키 선택과 누락이 실제로 어떤 결과를 낳는지 보여 준다.

화면에는 새 레코드, 갱신과 미결정 사례를 따로 보여 준다. ‘비슷한 항목 발견’이 곧 ‘덮어쓰기’ 결정은 아니다. AI의 레코드 연결 평가 (폴란드어)에서는 이 경계에 별도 근거가 필요하다. 여기서는 어떤 방식으로 만들어진 제안이든 사람이 특정 제안을 이해하고 받아들이는 순간을 설계한다.

Aeneia 콘셉트 사진

파일의 두 행이 같은 상품을 가리킬 수 있다. 사용자는 거부, 하나의 합친 변경 또는 다른 합의된 처리 중 어떤 규칙이 적용되는지 알아야 한다. 마지막 행이 그냥 이긴다고 가정하지 않는다. 원본 값이 서로 충돌한다면 중복 표시는 결정을 돕는 방향으로 이어져야지 경고로 미리보기를 꾸미는 데 그쳐서는 안 된다.

반대로 입력 하나에 대상 레코드 여러 개가 맞을 수도 있다. 두 변형에서 상품 이름이 반복되는 것은 특이한 장애가 아니라 흔한 사례다. 올바른 식별자가 없다면 가져오기 도구가 편리한 순서대로 레코드를 골라서는 안 된다. 저장 전에 모호성과 보류된 범위를 보여 준다. 사람은 무엇이 아직 확인을 기다리는지 알아야 한다.

Aeneia Design에서 가져오기를 설계할 때 이런 예시는 매핑 화면, 변경 미리보기, 결과 보고서를 연결하는 데 도움이 된다. 빈 템플릿으로 시작하기보다 실제 열 이름 몇 개와 어려운 사례를 보여 주는 예시 값을 가져올 수 있다. 설계는 합의된 데이터 저장 규칙에 맞아야 한다.

일부 미리보기는 전체 파일 확인이 아니다

공급사는 첫 행들을 신중하게 준비했다. 뒤쪽에 가서야 코드 누락과 인식되지 않는 단위가 나타난다. 패널이 앞부분만 보여 준다면 사용자는 그런 문제를 스스로 짐작할 수 없다. 상태는 표시 형태의 미리보기와 전체 검사 결과를 구분해야 한다. 둘은 서로 다른 결정에 쓰이며 다른 시점에 나올 수 있다.

새 Jira Cloud 가져오기 문서는 매핑 중 처음 30개 행을 검사한다고 설명한다(영어). 이후 행의 오류가 실패나 부분 가져오기를 일으킬 수 있다고도 경고한다. 화면에서 계속 진행할 수 있다고 해서 표본의 한계가 사라지지는 않는다.

가상의 열두 항목 파일에서 요약은 새 항목 세 개, 갱신 네 개, 변경 없음 두 개, 확인 필요 세 개를 보여 줘야 한다. 이 예시에서는 숫자의 합이 입력 열두 행이다. 일반적으로 한 행이 언제나 한 상품이라고 가정하지는 않는다. 변형이나 관계 파일은 구조가 다를 수 있으며 설계가 그 구조를 밝혀야 한다.

갱신을 승인하기 전에 값의 차이를 살펴볼 수 있게 하는 편이 좋다. ‘너비 변경됨’만으로는 120이 12로 바뀌었는지 표기 형식만 달라졌는지 알 수 없다. 변경 화면에는 현재 값과 제안 값, 단위를 함께 보여 줘야 한다. 차이를 강조하지 않은 행 전체 미리보기는 비교를 담당자의 기억에 떠넘긴다.

매핑을 바꾸면 결과를 다시 계산해야 한다. ‘상태’를 다른 필드에 연결했다면 이전 갱신 건수가 여전히 최신 결과처럼 보여서는 안 된다. 대기 상태나 기존 요약을 새로 계산해야 한다는 표시가 필요하다. 그렇지 않으면 사용자는 마지막 수정 이전에 표시된 범위를 승인하게 된다.

승인은 선택한 버전과 정해진 결과에 적용된다

마지막 버튼에는 받아들일 범위를 명시해야 한다. 예시 파일에서 예외를 작업 밖에 남기고 일곱 건만 처리할 수 있다면 ‘3개 추가 및 4개 갱신’이라고 쓸 수 있다. 오류 하나가 파일 전체를 멈춘다면 다른 완료 방식이 필요하다. 애플리케이션이 하지 않는 부분 저장을 화면이 약속해서는 안 된다.

미리보기와 저장 사이에 누군가 기존 상품을 바꿀 수 있다. 구현 담당자와 재비교, 충돌 보류 또는 다른 버전 확인 규칙을 합의해야 한다. 확인 창 자체가 데이터를 고정하지는 않는다. 화면에는 실제 검사 결과와 가능한 다음 단계를 보여 줘야지 동의 질문만 반복해서는 안 된다.

시작 후에는 진행 중인 작업 상태와 취소할 수 있는 범위를 보여 준다. 창을 닫아도 화면만 숨겨질 뿐 저장은 멈추지 않을 수 있다. 특정 단계 이후 ‘취소’ 버튼을 사용할 수 없다면 그 결과를 분명하게 설명해야 한다. 패널 모서리에 닫기 표시가 있다는 이유만으로 모든 변경을 되돌릴 수 있는 것처럼 보여서는 안 된다.

특히 오래 걸리는 작업에서는 돌아온 뒤 결과를 찾을 방법이 필요하다. 파일 이름, 가져오기 목적지와 작업 식별 정보는 비슷한 두 실행을 구분하는 데 도움이 된다. 새로 실행하면 작업이 하나 더 만들어지는지, 이미 접수된 작업으로 돌아가는지 알아야 한다. 두 번 클릭하는 일이 우연히 상품 복사본 두 개를 추가하는 방법이 돼서는 안 된다.

예외를 고칠 수 있는 결과를 받는다

완료 후 요약은 실제로 저장한 것, 그대로 둔 것, 거부한 것을 보여 준다. 이전 예상과 다를 수 있지만 중요한 차이는 각각 설명해야 한다. 건수와 레코드 참조가 없는 ‘가져오기 완료’만으로는 카탈로그를 계속 쓸 수 있는지 알 수 없다. 전체 상태는 부분 결과도 드러내야 한다.

Airtable은 필드 값을 받아들이지 못해도 레코드 생성이나 갱신이 중단되지 않을 수 있다고 설명한다(영어). 설명된 가져오기 도구는 셀을 비워 둘 수 있고 요약에 건너뛴 값을 나열하지 않는다. 따라서 레코드 성공이 각 값의 반영까지 자동으로 확인해 주지는 않는다.

그래서 예시 보고서는 저장된 레코드와 수정이 필요한 필드를 구분해야 한다. 문제가 있으면 원본 행, 필드와 수정 가능한 원인을 알려 준다. 셀 텍스트에 줄바꿈이 있거나 파일에 머리글이 있을 때 특히 행 번호의 정의가 분명해야 한다. 사용자가 앱과 다르게 줄을 세지 않고 올바른 항목을 찾을 수 있어야 한다. 알아볼 수 있는 상품 코드는 올바른 사례를 고치고 있는지 확인하는 데 도움이 된다.

예외 파일은 필요한 열과 거부 이유를 보존한다면 후속 작업에 도움이 될 수 있다. 그 형식도 설계가 필요하다. 다른 프로그램으로 데이터 내보내기 (폴란드어)는 행 수만이 아니라 값의 의미를 보존해야 한다. 제대로 읽을 수 없는 보고서는 같은 여정에서 다음 문제를 만든다.

사용자가 전체 파일을 다시 보냈다는 이유만으로 수정한 항목의 재가져오기가 이미 추가한 상품의 복사본을 만들어서는 안 된다. 레코드 식별 규칙과 범위 선택 방식이 이를 결정해야 한다. 설계는 무엇을 다시 시도하고 무엇이 이전 결과로 남는지 보여 준다. 그렇지 않으면 세 가지 누락을 고치려다 열두 건의 작업이 다시 열릴 수 있다.

자료가 AI 과정에서 사용하는 스프레드시트 (폴란드어)에서 준비됐다면 편집 후 파일에 실제로 저장된 값도 확인한다. 표시된 상품 번호의 자료형이 바뀌거나 코드에서 0이 빠졌을 수 있다. 입력 데이터 검사는 레코드를 매칭하기 전에 이런 변화를 알아봐야 한다. 스프레드시트 미리보기에 대한 신뢰가 전달된 파일의 확인을 대신하지는 않는다.

제대로 받아들인 가져오기는 어떤 열을 수용했고 무엇을 기준으로 상품을 매칭했으며 각 그룹의 결과가 무엇인지 이해할 수 있는 결정을 남긴다. 그때 예시의 열두 행은 열두 개의 새 상품인 척하지 않게 된다. 사용자는 무엇이 카탈로그에 반영됐고 공급사가 다음번 ‘이번이 정말 최종’ 스프레드시트를 보내기 전에 무엇을 더 확인해야 하는지 알게 된다.

Aeneia / Aeneia 편집부

편집부의 글입니다. 본문에 출처 링크가 있습니다.

Aeneia 소개

함께한 브랜드

  • L’Oréal
  • Garnier
  • Netflix
  • Carrefour
  • Warner Bros. Discovery
  • Biedronka
  • HBO Max
  • Wolt
  • Żabka
  • COSRX
  • 주폴란드 중국대사관
  • Mixa
Aeneia / Initium

지식에서 결정으로

정리하고 싶은 과제를 알려 주세요. 어디서 시작할지 함께 정합니다.

Aeneia에 문의하기

파트너의 솔루션을 활용합니다

  • Google
  • OpenAI
  • Microsoft
  • Stripe
  • Anthropic
  • Linear