작업 항목은 GitLab에서 업무를 계획하고 추적하는 핵심 요소입니다. 제품 개발을 계획하고 추적하려면 종종 더 큰 그림과의 연결을 유지하면서 업무를 더 작고 관리 가능한 부분으로 나누어야 합니다. 작업 항목은 이러한 근본적인 필요를 중심으로 설계되어 전략적 이니셔티브에서 개별 작업에 이르기까지 모든 수준의 업무 단위를 표현하는 통합 방법을 제공합니다.

작업 항목의 계층적 특성은 다양한 수준의 업무 간의 명확한 관계를 가능하게 하여 팀이 일상적인 작업이 더 큰 목표에 어떻게 기여하고 전략적 목표가 실행 가능한 구성 요소로 어떻게 분류되는지 이해할 수 있도록 합니다.

이 구조는 Scrum, Kanban 및 포트폴리오 관리 접근 방식과 같은 다양한 계획 프레임워크를 지원하면서 모든 수준에서 진행 상황의 가시성을 팀에게 제공합니다.

작업 항목 유형#

GitLab은 다음과 같은 작업 항목 유형을 지원합니다:

• 이슈: 작업, 기능 및 버그를 추적합니다.
• 에픽: 여러 마일스톤 및 이슈에 걸친 대규모 이니셔티브를 관리합니다.
• 작업: 소규모 업무 단위를 추적합니다.
• 목표 및 핵심 결과: 전략적 목표 및 측정 가능한 결과를 추적합니다.
• 테스트 케이스: 테스트 계획을 GitLab 워크플로에 직접 통합합니다.

작업 항목 유형을 구성하여 새 유형을 만들고 그룹 및 프로젝트 전반에서 가용성을 제어할 수도 있습니다.

모든 작업 항목 보기#

Work items 목록은 프로젝트 또는 그룹의 모든 작업 항목 유형(이슈, 에픽 및 작업 등)을 보고 관리하는 중앙 위치입니다. 이 보기를 사용하여 프로젝트 또는 그룹의 전체 업무 범위를 파악하고 효과적으로 우선순위를 정합니다.

이전 버전의 GitLab에서 이슈와 에픽은 Plan > Issues 및 Plan > Epics 아래의 별도 목록 페이지에 있었습니다. GitLab 18.10 이상에서는 이러한 페이지가 Plan > Work items로 대체되어 단일 보기에서 모든 작업 항목 유형을 통합합니다. 사이드바에 Issues 또는 Epics를 고정했다면 Work items가 그 자리에 고정됩니다. /epics/:iid 또는 /issues/:iid를 포함하는 URL은 자동으로 /work_items/:iid로 리디렉션됩니다.

프로젝트 또는 그룹의 작업 항목을 보려면:

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택합니다.

작업 항목 필터링#

Work items 목록은 기본적으로 모든 작업 항목 유형을 표시합니다. 특정 유형(예: 이슈만 또는 에픽만)을 보려면 Type 필터를 사용합니다.

작업 항목 목록을 필터링하려면:

1. 페이지 상단의 필터 표시줄에서 필터, 연산자 및 값을 선택합니다. 예를 들어 에픽만 보려면 필터 Type, 연산자 is, 값 Epic을 선택합니다.
2. 선택 사항. 검색을 세분화하기 위해 필터를 더 추가합니다.
3. Enter를 누르거나 검색 아이콘(🔍)을 선택합니다.

사용 가능한 필터#

작업 항목에 사용 가능한 필터:

• 담당자
  • 연산자: is, is not one of, is one of
• 작성자
  • 연산자: is, is not one of, is one of
• 기밀
  • 값: Yes, No
• 연락처
  • 연산자: is
• 상태
  • 연산자: is
• 건강 상태
  • 연산자: is, is not
• 반복
  • 연산자: is, is not
• 레이블
  • 연산자: is, is not one of, is one of
• 마일스톤
  • 연산자: is, is not
• 내 반응
  • 연산자: is, is not
• 조직
  • 연산자: is
• 상위
  • 연산자: is, is not
  • 값: 임의 Issue, Epic, Objective
• 릴리스
  • 연산자: is, is not
• 검색 범위
  • 연산자: Titles, Descriptions
• 상태
  • 값: Any, Open, Closed
• 유형
  • 값: Issue, Incident, Task, Epic, Objective, Key Result, Test case
• 가중치
  • 연산자: is, is not

최근에 사용한 필터에 액세스하려면 필터 표시줄 왼쪽에서 Recent searches([history]) 드롭다운 목록을 선택합니다.

작업 항목 정렬#

다음 기준으로 작업 항목 목록을 정렬합니다:

• 생성 날짜
• 업데이트 날짜
• 시작 날짜
• 기한
• 제목
• 상태
• 가중치

정렬 기준을 변경하려면:

• 필터 표시줄 오른쪽에서 Created date 드롭다운 목록을 선택합니다.

오름차순과 내림차순 사이를 전환하려면:

• 필터 표시줄 오른쪽에서 Sort direction([sort-lowest] 또는 [sort-highest])을 선택합니다.

정렬 로직에 대한 자세한 내용은 이슈 목록 정렬 및 순서를 참조하십시오.

목록 표시 기본 설정 구성#

특정 메타데이터 필드를 표시하거나 숨기고 보기 기본 설정을 구성하여 목록 페이지에서 작업 항목이 표시되는 방식을 사용자 정의합니다.

GitLab은 다양한 수준에서 표시 기본 설정을 저장합니다:

• 필드: 네임스페이스별로 저장됩니다. 워크플로 요구 사항에 따라 다른 그룹 및 프로젝트에 대해 다른 필드 가시성 설정을 가질 수 있습니다. 예를 들어 하나의 그룹이나 프로젝트에서는 담당자와 레이블을 표시하고 다른 곳에서는 숨길 수 있습니다.
• 사용자 기본 설정: 모든 프로젝트 및 그룹에 걸쳐 전역적으로 저장됩니다. 이를 통해 작업 항목 보기 방식에 대한 일관된 동작이 보장됩니다.

표시 기본 설정을 구성하려면:

1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Plan > Work items를 선택합니다.
3. 필터 표시줄 오른쪽에서 Display options([preferences])를 선택합니다.
4. Fields 아래에서 표시할 메타데이터를 켜거나 끕니다:
   • 상태 (이슈의 경우)
   • 담당자
   • 레이블
   • 가중치 (이슈의 경우)
   • 마일스톤
   • 반복 (이슈의 경우)
   • 날짜: 기한 및 날짜 범위
   • 건강: 건강 상태 표시기
   • 차단됨/차단: 차단 관계 표시기
   • 댓글: 댓글 수
   • 인기도: 인기도 지표
5. Your preferences 아래에서 Open items in side panel을 켜거나 끄면 에픽을 선택할 때 열리는 방식을 선택할 수 있습니다:
   • 켜기(기본값): 항목이 화면 오른쪽의 드로어에서 열립니다.
   • 끄기: 항목이 전체 페이지 보기에서 열립니다.

기본 설정이 저장되어 모든 세션과 장치에서 기억됩니다.

작업 항목 Markdown 참조#

[work_item:123]으로 GitLab Flavored Markdown 필드에서 작업 항목을 참조할 수 있습니다. 자세한 내용은 GitLab 전용 참조를 참조하십시오.

머지 리퀘스트의 작업 항목#

머지 리퀘스트 설명에서 작업 항목을 참조하면, 머지 리퀘스트 사이드바의 Work items 위젯에 자동으로 표시됩니다. 위젯은 작업 항목을 두 가지 범주로 분류합니다:

• 닫힘: Closes #123과 같은 닫힘 패턴으로 연결된 작업 항목. 이러한 작업 항목은 MR이 머지될 때 자동으로 닫힙니다.
• 언급됨: 닫힘 패턴 없이 설명에서 참조된 작업 항목(Related to #456 등). 이러한 작업 항목은 MR이 머지될 때 닫히지 않습니다.

위젯에 작업 항목이 두 개 이상 포함된 경우 기본적으로 접혀 있습니다. 위젯 헤더를 선택하여 펼칩니다. 작업 항목을 선택하면 드로어에서 열립니다.

관련 주제#

• 연결된 이슈
• 연결된 에픽
• 이슈 보드
• 레이블
• 반복
• 마일스톤
• 사용자 정의 필드
• 구성 가능한 작업 항목 유형