CSV에서 이슈 가져오기
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
다음 열이 있는 CSV(쉼표로 구분된 값) 파일을 업로드하여 프로젝트로 이슈를 가져올 수 있습니다: 다른 열의 데이터는 가져오지 않습니다. description 필드를 사용하여 빠른 작업을 포함하여 이슈에 다른 데이터를 추가할 수 있습니다.
다음 열이 있는 CSV(쉼표로 구분된 값) 파일을 업로드하여 프로젝트로 이슈를 가져올 수 있습니다:
| 이름 | 필수 | 설명 |
|---|---|---|
title |
✅ | 이슈 제목. |
description |
✅ | 이슈 설명. |
due_date |
❌ | YYYY-MM-DD 형식의 이슈 마감일. |
milestone |
❌ | 이슈 마일스톤의 제목. GitLab 16.7에서 도입. |
type |
❌ | 이슈 유형. GitLab 18.4에서 도입. |
다른 열의 데이터는 가져오지 않습니다.
description 필드를 사용하여 빠른 작업을 포함하여 이슈에 다른 데이터를 추가할 수 있습니다.
예를 들어 레이블, 담당자 및 마일스톤.
또는 이슈를 이동할 수 있습니다. 이슈를 이동하면 더 많은 데이터가 보존됩니다.
CSV 파일을 업로드하는 사용자가 가져온 이슈의 작성자로 설정됩니다.
이슈를 가져오려면 프로젝트에 대한 Planner, Reporter, Security Manager, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.
가져오기 준비#
- 이슈가 몇 개만 포함된 테스트 파일을 가져오는 것을 고려하세요. GitLab API를 사용하지 않고 대규모 가져오기를 취소할 수 없습니다.
- CSV 파일이 파일 형식 요구 사항을 충족하는지 확인하세요.
- CSV에 마일스톤 헤더가 포함된 경우 파일의 모든 고유한 마일스톤 제목이 이미 프로젝트 또는 상위 그룹에 존재하는지 확인하세요.
파일 가져오기#
이슈를 가져오려면:
- 프로젝트의 이슈 페이지로 이동합니다.
- 프로젝트에 이슈가 있는지에 따라 가져오기 기능을 엽니다:
- 프로젝트에 기존 이슈가 있는 경우: 오른쪽 상단 모서리에서 일괄 편집 옆에 있는 작업(⋮) > CSV 가져오기를 선택합니다.
- 프로젝트에 이슈가 없는 경우: 페이지 중간에서 CSV 가져오기를 선택합니다.
- 가져올 파일을 선택한 다음 이슈 가져오기를 선택합니다.
파일은 백그라운드에서 처리되며 오류가 감지되거나 가져오기가 완료된 후 알림 이메일이 전송됩니다.
CSV 파일 형식#
이슈를 가져오려면 GitLab은 CSV 파일이 특정 형식을 갖출 것을 요구합니다.
GitLab에서 볼 때 가져온 파일이 표시되는 방식에 영향을 줄 수 있는 CSV 구문 분석 요구 사항에 대한 정보는 CSV 구문 분석 고려 사항을 참조하세요.
| 요소 | 형식 |
|---|---|
| 헤더 행 | CSV 파일에는 title 및 description 헤더가 포함되어야 합니다. 헤더의 대소문자는 중요하지 않습니다. |
| 열 | title, description, due_date, milestone 및 type 외의 열의 데이터는 가져오지 않습니다. |
| 구분 기호 | 열 구분 기호는 헤더 행에서 감지됩니다. 지원되는 구분 기호 문자는 쉼표(,), 세미콜론(;) 및 탭(\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 인스턴스가 호스팅되는 방식에 따라 다릅니다:
- GitLab Self-Managed: GitLab 인스턴스의
최대 첨부 파일 크기구성 값에 의해 설정됩니다. - GitLab.com: 10 MB로 제한됩니다.