ViewCSVCSV를 열거나 붙여넣으면 각 열이 출력될 순서대로 한 줄씩 나타납니다. 열 이름을 바꾸려면 그 줄의 ‘출력 열’ 칸에 새 머리글을 입력하고, 순서를 바꾸려면 위로 이동과 아래로 이동을, 열을 지우려면 제거를 누르세요. 열 추가로는 원본 열을 복사한 열이나 (고정 값) 열을 만들 수 있습니다. 편집하는 동안 결과가 바로 바뀌고, CSV 다운로드를 누르면 모든 값을 그대로 복사해 저장합니다. 매달 같은 형식의 내보내기 파일을 받는다면 매핑 저장으로 양식을 JSON 파일로 남겨 두었다가 다음 파일에 불러오세요. 파일은 업로드되지 않고 브라우저 안에서 처리됩니다.
열 이름·순서를 바꾸고 열을 지우는 방법
.csv,.tsv,.txt파일을 열거나 도구 위에 끌어다 놓거나 행을 붙여넣으세요. 구분 기호는 자동으로 감지됩니다. 필요하면 가져오기 설정에서 구분 기호, 인코딩, 첫 행이 열 이름(머리글)임을 지정하세요.- 목록을 편집합니다. 한 줄이 출력 열 하나입니다. ‘출력 열 1’, ‘출력 열 2’… 칸에 새 머리글을 입력하고, 원본 열에서 가져올 열을 고르고, 위로 이동과 아래로 이동으로 줄 순서를 바꾸세요.
- 필요 없는 줄은 지우세요. 어디에도 쓰이지 않게 된 열은 목록 아래에 출력하지 않는 열로 표시됩니다.
- 결과 탭을 확인한 뒤 CSV 다운로드, 복사를 누르거나, 매핑한 표를 계속 다듬으려면 편집기에서 열기를 누르세요.
열 매핑으로 할 수 있는 일
| 이름 변경 | ‘출력 열’ 이름을 바꿉니다. 이름은 공백과 대소문자까지 입력한 그대로 쓰이며, 원본 파일은 바뀌지 않습니다. |
|---|---|
| 순서 변경 | 출력은 목록의 위에서 아래 순서를 따릅니다. |
| 삭제 | 줄을 제거하면 그 열은 출력에서 빠집니다. 다른 열에는 영향이 없습니다. |
| 열 복사 | 원본 열이 같은 줄을 하나 더 추가합니다. 예를 들어 email을 그대로 두면서 login으로도 쓸 수 있습니다. |
| 고정 값 열 추가 | 원본 열에서 (고정 값)을 고르고 값을 입력합니다. 모든 행에 그 값이 들어가며, 예를 들면 channel = webshop입니다. 받는 시스템이 빈 열을 요구한다면 값을 비워 두세요. |
| 빈 셀 채우기 | 원본 열에서 가져오는 열이라면 비었을 때 값이 완전히 빈 셀을 대신 채웁니다. 예를 들어 비어 있는 status를 pending으로 채울 수 있습니다. 공백만 있는 셀은 빈 셀이 아니므로 그대로 둡니다. |
| 초기화 | 원래의 열, 이름, 순서로 되돌립니다. |
내보낼 때마다 같은 양식 다시 쓰기
매핑 저장을 누르면 양식이 viewcsv-mapping.json으로 다운로드됩니다. 다음에는 새 파일을 열고 매핑 불러오기를 고르세요. 열은 원본 이름으로 연결되므로 새로 내보낸 파일의 열 순서가 달라도 같은 양식이 적용됩니다.
회계 프로그램 가져오기, 쇼핑몰 상품 업로드, CRM처럼 받는 쪽 시스템은 정해진 열 이름을 요구하는데 원본 내보내기 파일의 열 이름이 다를 때 특히 유용합니다. 새 파일에 없는 원본 열은 매핑을 불러온 뒤 목록으로 표시되고 (고정 값) 줄로 바뀌므로, 줄마다 확인하고 원본 열에서 올바른 열을 고르세요.
매핑이 확인하는 규칙
- 모든 출력 열에는 이름이 있어야 하고, 이름은 서로 달라야 합니다. 정확히 비교하므로
Email과email은 다른 이름입니다. - 열이 하나 이상 남아 있어야 하며, 매핑 결과는 최대 250열, 200만 셀입니다.
- 결과는 원본 파일의 형식으로 다운로드됩니다. 구분 기호, 줄 바꿈 문자, BOM, 그리고 브라우저가 쓸 수 있는 인코딩이면 인코딩도 같고, 따옴표는 필요한 곳에만 붙습니다. EUC-KR 같은 그 밖의 레거시 인코딩은 UTF-8로 저장합니다. 복사는 항상 쉼표 구분 텍스트입니다.
- 원본의 빈 머리글이나 중복 머리글은 가져올 때 이미 고유한 이름(
Column 3,name (2))으로 바뀌었으므로 다른 열과 똑같이 매핑할 수 있습니다. - 값의 공백을 자르거나 유형을 바꾸지 않습니다.
001041은001041로 남습니다.
두 열을 하나로 합치거나 한 열을 여러 열로 나누는 작업은 매핑 기능에 없습니다. 매핑 전후에 CSV 편집기에서 처리하세요. 열 이름이 서로 다른 파일들을 위아래로 이어 붙이려면 각 파일을 같은 양식으로 매핑한 다음 CSV 파일 합치기 도구에서 합치세요.
매핑 오류와 해결 방법
- 모든 출력 열에 이름이 필요하다고 나옵니다. ‘출력 열’ 칸이 빈 줄이 있습니다. 이름을 입력하거나 그 줄을 지우세요.
- 같은 이름이 두 번 쓰였다고 나옵니다. 두 줄의 출력 이름이 같습니다. 하나의 이름을 바꾸세요.
- 불러온 매핑에 없는 열 목록이 표시됩니다. 그 원본 이름이 이 파일에 없어서 해당 줄이 (고정 값) 열로 바뀌었습니다. 함께 저장된 비었을 때 값이 이제 모든 행에 들어갑니다. 줄마다 원본 열에서 올바른 열을 고르세요.
- 매핑 파일이 거부됩니다. 올바른 JSON이 아니거나,
columns목록이 없거나, 열이 250개를 넘습니다. 매핑 저장으로 다시 저장하세요. - 머리글이 Column 1, Column 2…로 나옵니다. 파일에 머리글 행이 없거나 첫 행이 열 이름(머리글)임이 꺼져 있습니다. ‘출력 열’ 칸에 원하는 이름을 입력하세요.
열 매핑 한도와 개인정보 보호
매핑은 25 MB, 10만 행, 250열, 200만 셀까지의 파일에서 동작합니다. 편집하는 대로 결과를 바로 보여 주기 위해 모든 데이터를 메모리에 둡니다. 더 큰 파일은 처리하지 않으므로 먼저 CSV 파일 나누기로 나누고, 저장해 둔 매핑을 나뉜 파일마다 적용하세요.
CSV와 매핑은 이 탭 안에만 있으며 서버로 아무것도 보내지 않습니다.
예시: 주문 내보내기 파일을 가져오기 양식에 맞추기
주문 내보내기 파일을 가져오기용 양식에 맞춘 결과입니다. city는 빼고, status는 위로 옮기면서 비었을 때 값을 pending으로 정하고, 나머지 열은 이름을 바꾸고, 고정 값 Channel 열을 추가했습니다. 비어 있는 가격은 기본값이 없으므로 빈칸으로 남습니다.
order_id,customer,city,unit_price,status 001041,Ana Ruiz,Madrid,34.90,paid 001042,Ben Ito,Osaka,,
Order ID,Status,Customer name,Price,Channel 001041,paid,Ana Ruiz,34.90,webshop 001042,pending,Ben Ito,,webshop
자주 묻는 질문
매달 내보내는 파일에 같은 열 매핑을 다시 쓸 수 있나요?
네. 매핑 저장을 한 번 해 두고, 새 파일마다 매핑 불러오기를 하세요. 열은 위치가 아니라 원본 이름으로 연결되며, 빠진 열은 목록으로 알려 주므로 바로 고칠 수 있습니다.
매핑하면 열의 값이 바뀌나요?
아니요. 값은 그대로 복사됩니다. 바뀌는 셀은 비었을 때 값을 정한 열의 빈 셀과, 직접 추가한 고정 값 열뿐입니다.
성과 이름을 한 열로 합칠 수 있나요?
이 도구에서는 안 됩니다. 출력 열 하나는 원본 열 하나나 고정 값 하나에서만 나옵니다. CSV 편집기에서 값을 합친 뒤 그 결과를 매핑하세요.