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