[Jira] CSV Import 방법 업로드 전에 꼭 확인할 것

 

ChatGPT 생성형 이미지


엑셀 데이터를 Jira로 옮기려는데 이슈가 생성되지 않는 상황

엑셀로 관리하던 업무를 Jira로 옮기기 위해 CSV Import를 실행했습니다.

업로드도 끝났고 Import completed 메시지도 보였습니다.

그런데 프로젝트 화면으로 이동해 보니 이슈가 하나도 생성되지 않았습니다.

처음에는 Jira 오류라고 생각하기 쉽습니다.

하지만 실제로는 CSV 파일 안의 필수 컬럼이 빠져 있거나, Jira 필드와 연결되는 과정(Field Mapping)에서 문제가 발생한 경우가 많습니다.

실무에서는 CSV Import가 실패하면 처음부터 다시 업로드하기보다 아래 4개 항목부터 확인합니다.

  • Summary 컬럼이 있는가
  • Issue Type 컬럼이 있는가
  • CSV 파일이 UTF-8 형식인가
  • 담당자(Assignee) 값이 Jira 계정과 일치하는가

왜 이런 문제가 발생하는가

CSV Import는 단순히 파일을 업로드하는 기능이 아닙니다.

CSV 파일의 각 열(Column)을 Jira 필드와 연결해야 합니다.

예를 들어 엑셀에서 사용하는 "업무명" 컬럼을 Jira의 Summary 필드에 연결해야 합니다.

이 연결이 잘못되면 Import는 완료되더라도 실제 이슈는 생성되지 않을 수 있습니다.

특히 처음 사용하는 경우 아래 두 상황이 자주 발생합니다.

실패 화면 실제 원인
Import completed인데 이슈 없음 Summary 또는 Issue Type 누락
담당자가 전부 비어 있음 Assignee 매핑 실패


가장 먼저 확인해야 하는 CSV 파일 구조

필수 컬럼 설명
Summary 이슈 제목
Issue Type Bug, Task, Story 등
Priority 우선순위
Assignee 담당자
Due Date 마감일

처음 부터 모든 파일을 올리지 말고 5개 정도 테스트 데이터를 먼저 준비합니다.


Summary Issue Type Assignee
로그인 오류 Bug hong@example.com
메인 배너 수정 Task kim@example.com

실제 Jira CSV Import 순서
  1. Jira 우측 상단의 설정 아이콘을 클릭합니다.
  2. [Settings] → [System] 메뉴로 이동합니다.
  3. [External System Import]를 선택합니다.
  4. [CSV]를 클릭합니다.
  5. CSV 파일을 업로드합니다.
  6. [Next] 버튼을 눌러 Field Mapping 단계로 이동합니다.

정상적으로 진행되면 CSV 컬럼 목록과 Jira 필드 목록이 함께 표시됩니다.

여기서부터가 가장 중요한 단계입니다.


가장 많이 막히는 Field Mapping 단계

CSV 컬럼 Jira 필드
업무명 Summary
담당자 Assignee
마감일 Due Date
우선순위 Priority

처음에는 모든 컬럼을 연결하려고 하지 않는 것이 좋습니다.
Summary와 Issue Type 두 개만 먼저 연결해도 테스트는 가능합니다.
실무에서도 전체 데이터를 올리기 전에 몇 건만 먼저 검증하는게 좋습니다.

실제로 자주 발생하는 실패 사례

CSV에는 "홍길동"이라고 적혀 있는데 Jira에서는 담당자가 비어 있습니다.
대부분 Jira가 사용자 이름이 아니라 이메일 주소 또는 계정 ID를 기대하기 때문에 발생합니다.
실패 화면에서는 Assignee가 Empty로 표시됩니다. 정상 화면에서는 담당자 이름이 표시됩니다.

한글이 깨지는 경우

CSV 저장 형식이 UTF-8이 아닐 때 발생합니다. 실패 화면에서는 제목이 ??? 형태로 표시됩니다.
정상 화면에서는 한글 제목이 그대로 보입니다.

날짜가 들어가지 않는 경우

Due Date 형식이 Jira가 기대하는 형식과 다를 때 발생합니다.
가장 안전한 형식은 다음과 같습니다. 2026-06-08

Import 후 반드시 확인해야 하는 화면

Import가 완료되면 바로 프로젝트의 Issues 화면으로 이동합니다. 아래 항목을 확인합니다.

  • Summary 정상 표시
  • Assignee 정상 표시
  • Priority 정상 표시
  • Due Date 정상 표시
  • Issue Type 정상 표시

정상적으로 등록되었다면 CSV에 있던 데이터가 Jira 이슈로 생성됩니다.

다음에도 같은 실수를 줄이는 방법

실무에서 가장 안전한 방법은 테스트 Import를 먼저 진행하는 것입니다.

처음부터 100개 이슈를 업로드하면 오류가 발생했을 때 수정 범위가 커집니다.

보통 아래 순서로 진행합니다.

  1. 테스트 데이터 5건 생성
  2. CSV Import 실행
  3. 결과 검증
  4. 문제 없음 확인
  5. 전체 데이터 업로드

처음에는 시간이 더 걸리는 것처럼 보입니다.

하지만 담당자 누락, 날짜 오류, 한글 깨짐을 미리 발견할 수 있어서 결과적으로 훨씬 빠릅니다.

한 줄로 정리하면 핵심은 "전체 업로드 전에 몇 건만 먼저 Import해서 결과를 검증하는 것" 입니다.


이 블로그의 인기 게시물

[Notion] 노션에서 페이지 간 링크 연결하는 방법 총정리

이미지
  노션은 단순한 메모 기능 만을 지원하는 앱이 아니라 아주 유용하게 사용할 수 있는 툴입니다. 그중에서도 페이지 링크 연결 기능은 자료를 빠르게 참조하고 다른 페이지와 연동하여 작업 효율을 극대화 할 중요한 기능입니다. 하지만 처음 노션을 접하신 분들은 "링크 추가는 어떻게 하는 거지?"라고 생각하실 수 있습니다. 우리는 이 글을 통해서 노션에서 페이지 간 링크를 연결하는 방법을 단계별로 알아보도록 하겠습니다. 페이지 링크란? 링크는 내부 링크와 외부 링크로 구분할 수 있습니다. 내부 링크: 같은 워크스페이스 안에 있는 다른 노션 페이지로 연결 외부 링크: 웹사이트나 다른 플랫폼 주소(URL)로 연결 그렇다면 링크가 왜 중요할까요? 링크를 사용할 경우 빠르게 자료로 접근할 수 있습니다. 프로젝트를 관리하는 상황에서 관련 문서 간 연결을 자유롭게 할 수 있습니다. 목차형 페이지를 만들 경우 필수적으로 활용합니다. 링크 만들어보기 @를 눌러서 멘션을 입력하여 Link to page에서 연결하고자 하는 페이지를 추가할 수 있습니다. 그럼 아래 이미지처럼 링크가 추가되고 링크를 누르면 누른 링크로 바로 연결이 됩니다. 그럼 다른 방법도 알아보도록 하겠습니다. 연결하고자 하는 페이지 우측 상단 점 세개를 눌러주세요 그럼 다양한 메뉴가 나옵니다. 여기서 가장 위에 있는 Copy Link를 눌러서 링크를 복사한 후에 추가할 페이지에 넣어주세요 다른 방법도 알아보겠습니다. 링크를 추가하고자 하는 텍스트를 드래그한 후에 우클릭해서 링크를 추가하는 방법입니다. Copy link to block을 클릭하면 문장 속에 깔끔하게 링크를 삽입할 수 있습니다. 이렇게만 활용하면 링크 추가하는 방법 아주 쉽게 활용할 수 있습니다. 자 간단하게 알아봤습니다. 다른 방법도 있지만 일단은 간단하게 여기까지만 정리해 보겠습니다. 노션에서 페이지 링크 연결 기능은 간단하지만, 어떻게 활용하느냐에 따라 작업 효율을 크게 올릴 수 있는 기능입니다. @멘션 방식과 복사 - 붙여넣기는...
자세한 내용 보기

[Notion] 노션 문서 PDF로 저장하는 방법

이미지
  우리가 노션을 활용할 때 프로젝트 관리나 메모 용도로도 활용하기도 합니다. 하지만 문서 제작 시 활용하기도 하죠. 이럴 때 노션에서 작성한 문서를 외부로 제출하거나 보관해야 한다면 PDF 형식으로 변환해서 저장해야 하는 경우가 있습니다. 예를 들어 보고서 같은 경우가 있을 수 있습니다. PDF는 가장 범용적으로 많이 활용되는 형태니깐요 이 글에서 노션에서 문서를 PDF로 저장하는 방법을 처음부터 끝까지 쉽게 알아보도록 하겠습니다. 노션에서 PDF로 저장하는 방법 노션에서 PDF로 저장하는 방법은 매우 쉽습니다. PDF로 변환하고자 하는 페이지나 파일을 연 상태에서 우측 상단 점 세 개를 눌러주세요 그리고 다양한 메뉴가 나오면 하단까지 내려주세요 그럼 '내보내기'가 보입니다. 이걸 클릭해 주세요 PDF 말고도 HTML, Markdown & CSV도 있는데 우리는 일단 PDF 변환 방법만 알아볼 예정이니 PDF를 선택해 주세요. 여기서 내보내기를 클릭하면 PDF로 저장되는 걸 확인할 수 있습니다. 모바일 앱에서 저장하기 모바일 앱에서 동일하게 적용해 보도록 하겠습니다. 아이폰 기준으로 작성했습니다. 또한, 모바일 환경에서는 PDF로 직접 저장하는 기능이 제한적일 수 있습니다. 자 그럼 순서대로 알아보도록 하겠습니다. 가장 먼저 PDF로 변환할 페이지를 열고 우측 상단 점 세 개를 터치해 주세요 자 그럼 PC 버전과 동일하게 '내보내기'를 터치해 주세요. 그럼 다음 화면으로 이동합니다. 그럼 이렇게 화면이 변환됩니다. 여기서 '내보내기'를 터치해 주세요. 그럼 다음 화면으로 넘어갑니다. 자 그러면 이렇게 미리 보기 화면으로 넘어가고 좌측 하단에 보이는 공유하기 버튼을 눌러서 공유 대상에게 보낼 수 있습니다. 자 그럼 정리해보겠습니다. 노션에서 문서를 PDF로 저장하는 방법은 아주 간단하죠? PC에서는 내보내기(Export) 기능을 활용하면 되고 모바일에서도 동일하게 할 수 있습니다. 이렇게 하면 노션에만 있던 문...
자세한 내용 보기

[Notion] 노션 기본 템플릿 5가지 소개와 활용 팁

이미지
  노션 초보자를 위해 쉽게 활용할 수 있는 기본 템플릿 5가지를 추천합니다. 할 일 관리, 회의 노트, 독서 기록 등 누구나 쉽게 따라 할 수 있는 방법을 소개합니다. 노션, 템플릿 부터 시작해보세요 노션(Notion)을 처음 접하셨을까요? 너무 복잡하거나 어려울 것 같다고 느낄 수 있습니다. 그렇다면 기본 템플릿부터 활용해 보는 게 좋습니다. 노션에는 이미 기존에 만들어진 기본 템플릿이 있어서 클릭 몇 번만으로 멋진 페이지를 만들 수 있습니다. 이 글을 통해서 가장 유용하고 많이 쓰이는 노션 템플릿 5가지와 함께, 어떻게 활용하면 좋은지 알아보겠습니다. 하단에 보이는 Tamplates를 클릭해 주면 템플릿이 모여 있는 페이지로 이동합니다. 그러면 여기서 먼저 To-Do List를 입력하고 추가해 보도록 하겠습니다. 자 검색했더니 이렇게 다양한 To-do list 항목이 나옵니다. 저는 이 중에서 오른쪽 위에 있는 템플릿을 선택했습니다. Free는 무료로 이용할 수 있는 템플릿이고 가격이 적혀있는 템플릿은 결제를 통해 추가할 수 있는 템플릿입니다. 자 그러면 이렇게 Weekly Plan으로 To-do list가 추가된 걸 확인할 수 있습니다. 쉽게 추가가 되고 바로 페이지에 추가되니깐 쉽게 활용할 수 있습니다. 같은 방법으로 다른 템플릿도 추가해 보도록 하겠습니다. 주간 일정 관리 독서 목록 회의 기록 목표 설정 자 가장 위에 부터 '할 일 목록', '주간 일정 관리', '독서 목록', '회의 기록', '목표 설정' 총 다섯 가지의 템플릿을 추가해봤습니다. 추가된 템플릿을 아이콘 등을 추가하거나 섹션을 다시 나누는 등의 기능을 활용해서 자유롭게 사용할 수 있습니다. 또한 추가된 템플릿은 다른 페이지와 연결할 수 있기 때문에 연동해서 쓸 수도 있습니다. 일단 간단하게 활용할 수 있는 노션 템플릿 5종만 먼저 소개했습니다. 처음 노션을 시작할 때 복잡하게 느껴질 수 있지만 기본 템플릿을 활용...
자세한 내용 보기