이슈를 CSV로 내보내기
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
GitLab에서 이슈를 일반 텍스트 CSV(쉼표로 구분된 값) 파일로 내보낼 수 있습니다. CSV 파일은 Microsoft Excel, OpenOffice Calc, Google Sheets 등 모든 플로터 또는 스프레드시트 기반 프로그램에서 사용할 수 있습니다.
히스토리
- GitLab 18.4에서
IID,Type,Start Date,Parent IID칼럼이 추가되었습니다.
GitLab에서 이슈를 일반 텍스트 CSV(쉼표로 구분된 값) 파일로 내보낼 수 있습니다. CSV 파일은 이메일에 첨부되어 기본 알림 이메일 주소로 전송됩니다.
CSV 파일은 Microsoft Excel, OpenOffice Calc, Google Sheets 등 모든 플로터 또는 스프레드시트 기반 프로그램에서 사용할 수 있습니다. 이슈의 CSV 목록은 다음 용도로 사용합니다.
- 오프라인 분석용으로, 또는 GitLab을 사용하지 않는 다른 팀과 공유하기 위해 이슈의 스냅숏을 생성합니다.
- CSV 데이터로 다이어그램, 그래프, 차트를 만듭니다.
- 감사나 공유를 위해 데이터를 다른 형식으로 변환합니다.
- 이슈를 GitLab 외부 시스템으로 가져옵니다.
- 시간에 걸쳐 만든 여러 스냅숏으로 장기 추세를 분석합니다.
- 장기 데이터로 이슈에 제시된 유의미한 피드백을 모으고 실제 지표를 근거로 제품을 개선합니다.
내보낼 이슈 선택#
이슈는 개별 프로젝트에서 내보낼 수 있으며 그룹에서는 내보낼 수 없습니다.
사전 요구 사항:
- Guest, Planner, Reporter, Developer, Maintainer 또는 Owner 권한이 있어야 합니다.
- 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
- 왼쪽 사이드바에서 Plan > Work items를 선택한 뒤 Type = Issue로 필터링합니다.
- 선택 사항. 이슈의 일부만 내보내려면 추가 필터, 연산자, 값을 선택합니다. 자세한 내용은 이슈 목록 필터링을 참고합니다.
- 오른쪽 위 모서리에서 Actions(⋮) > Export as CSV를 선택합니다.
- 대화 상자에서 이메일 주소가 올바른지 확인한 뒤 Export issues를 선택합니다.
첫 페이지에 표시되지 않은 이슈를 포함해 조건에 맞는 모든 이슈가 내보내집니다. 내보낸 CSV에는 이슈의 첨부 파일이 포함되지 않습니다.
형식#
CSV 파일의 형식은 다음과 같습니다.
- 제목순으로 정렬됩니다.
- 칼럼은 쉼표로 구분됩니다.
- 필드는 필요한 경우 큰따옴표(
")로 묶입니다. - 줄바꿈 문자가 행을 구분합니다.
GitLab에서 볼 때 내보낸 파일이 표시되는 방식에 영향을 줄 수 있는 CSV 파싱 요구 사항은 CSV 파싱 시 고려 사항을 참고합니다.
열#
CSV 파일에는 다음 칼럼이 포함됩니다.
| 열 | 설명 |
|---|---|
| ID | 이슈 id |
| IID | 이슈 iid |
| Title | 이슈 title |
| Description | 이슈 description |
| Type | 이슈 type |
| URL | GitLab의 이슈 링크 |
| State | Open 또는 Closed |
| Confidential | Yes 또는 No |
| Locked | Yes 또는 No |
| Milestone | 이슈 마일스톤의 제목 |
| Labels | 레이블, 쉼표로 구분 |
| Author | 이슈 작성자의 전체 이름 |
| Author Username | @ 기호가 생략된 작성자의 사용자명 |
| Assignee | 이슈 담당자의 전체 이름 |
| Assignee Username | @ 기호가 생략된 담당자의 사용자명 |
| Created At (UTC) | YYYY-MM-DD HH:MM:SS 형식 |
| Updated At (UTC) | YYYY-MM-DD HH:MM:SS 형식 |
| Closed At (UTC) | YYYY-MM-DD HH:MM:SS 형식 |
| Due Date | YYYY-MM-DD 형식 |
| Start Date | YYYY-MM-DD 형식 |
| Parent ID | 상위 항목의 ID |
| Parent IID | 상위 항목의 IID |
| Parent Title | 상위 항목의 제목 |
| Time Estimate | 초 단위의 시간 예상 |
| Time Spent | 초 단위의 소요 시간 |
| Weight | 이슈 가중치 |
문제 해결#
내보낸 이슈를 다룰 때 다음과 같은 문제가 발생할 수 있습니다.
내보내기 크기#
이슈는 이메일 첨부 파일로 전송되며, 여러 이메일 공급자에서 전달이 성공하도록 내보내기 한도가 15MB로 설정되어 있습니다. 한도에 도달하면 내보내기 전에 검색 범위를 좁힙니다. 예를 들어 열린 이슈와 닫힌 이슈를 따로 내보내는 방법을 고려합니다.