CSV 파일에서 이슈 가져오기
다음 열을 포함하는 CSV 파일을 업로드하여 프로젝트로 이슈를 가져올 수 있습니다:
이름 | 필요? | 설명 |
---|---|---|
제목
| 예 | 이슈 제목 |
설명
| 예 | 이슈 설명 |
마감일
| 아니요 |
YYYY-MM-DD 형식의 이슈 마감일. GitLab 15.2에서 도입됨
|
마일스톤
| 아니요 | 이슈 마일스톤 제목. GitLab 16.7에서 도입됨 |
다른 열의 데이터는 가져오지 않습니다.
설명
필드를 사용하여 이슈에 다른 데이터를 추가하기 위해 빠른 조치를 삽입할 수 있습니다.
예를 들어, 라벨, 담당자 및 마일스톤을 추가할 수 있습니다.
또는 이슈를 이동할 수도 있습니다. 이동된 이슈는 더 많은 데이터를 보존합니다.
CSV 파일을 업로드한 사용자는 가져온 이슈의 작성자로 설정됩니다.
이슈를 가져오려면 프로젝트에서 적어도 Developer 역할이 있어야 합니다.
가져오기 준비
- 몇 가지 이슈만 포함하는 테스트 파일을 가져오는 것을 고려하세요. 큰 가져오기를 원상 복구하는 방법은 GitLab API를 사용하지 않으면 없습니다.
- CSV 파일이 파일 형식 요구 사항을 충족하는지 확인하세요.
- CSV에 마일스톤 헤더가 포함되어 있으면, 파일의 모든 고유한 마일스톤 제목이 프로젝트나 해당 상위 그룹에 이미 존재하는지 확인하세요.
파일 가져오기
이슈를 가져오려면:
- 프로젝트의 이슈 페이지로 이동합니다.
- 프로젝트에 이슈가 있는 경우: 오른쪽 상단의 Bulk edit 옆에 있는 Actions () > Import CSV를 선택합니다.
- 프로젝트에 이슈가 없는 경우: 페이지 중앙에서 Import CSV를 선택합니다.
- 가져오려는 파일을 선택한 후 이슈 가져오기를 선택합니다.
파일은 백그라운드에서 처리되며, 오류가 감지되면 또는 가져오기가 완료된 후 알림 이메일이 발송됩니다.
CSV 파일 형식
이슈를 가져오려면 GitLab은 CSV 파일이 특정 형식을 갖도록 합니다:
요소 | 형식 |
---|---|
헤더 행 | CSV 파일은 title 및 description 헤더를 포함해야 합니다. 헤더의 대소문자는 중요하지 않습니다.
|
열 |
title , description , due_date , 및 milestone 외의 열에서 데이터는 가져오지 않습니다.
|
구분자 | 열 구분자는 헤더 행에서 감지됩니다. 지원되는 구분자는 쉼표(, ), 세미콜론(; ), 탭(\t )입니다. 행 구분자는 CRLF 또는 LF 가 될 수 있습니다.
|
이중 인용부호 문자 | 이중 인용부호(" ) 문자는 필드를 인용하여 필드 내에서 구분자를 사용할 수 있게 합니다 (아래 샘플 CSV 데이터의 세 번째 줄 참조). 인용된 필드에 이중 인용부호(" )를 삽입하려면 연속으로 두 개의 이중 인용부호 문자("" )를 사용하세요.
|
데이터 행 | 헤더 행 이후의 행은 동일한 열 순서를 사용해야 합니다. 이슈 제목이 필요하지만, 설명은 선택 사항입니다. |
특수 문자(예: ,
또는 \n
)나 필드 내에서 여러 줄을 사용할 때(예: 빠른 조치 사용 시)는 이중 인용부호("
)로 문자를 감싸야 합니다.
또한 빠른 조치 사용 시:
- 각 작업은 개별 줄에 있어야 합니다.
-
/label
및/milestone
과 같은 빠른 조치의 경우 라벨 또는 마일스톤이 이미 프로젝트에 존재해야 합니다. - 이슈를 할당하는 사용자는 프로젝트의 구성원이어야 합니다.
샘플 CSV 데이터:
title,description,due_date,milestone
내 이슈 제목,내 이슈 설명,2022-06-28
다른 제목,"쉼표가 있는 설명",
"하나 더 제목","하나 더 설명",
빠른 조치가 포함된 이슈,"프론트엔드를 변경할 수 있을까요?
/assign @sjones
/label ~frontend ~documentation",
마일스톤 있는 이슈,"내 마일스톤이 생성됨",,v1.0
파일 크기
제한은 GitLab 인스턴스의 구성값인 Max Attachment Size
에 의해 설정됩니다:
- Self-Managed: GitLab 인스턴스의
Max Attachment Size
구성 값에 의해 설정됩니다. - GitLab SaaS: GitLab.com에서 10MB로 설정됩니다.