할 일 목록은 입력을 기다리는 항목의 시간순 목록입니다. 항목은 할 일 아이템이라고 합니다.

할 일 목록을 사용하여 GitLab에서 수행하는 작업과 관련된 액션을 추적할 수 있습니다. 누군가 연락을 취하거나 주의가 필요한 경우 할 일 아이템이 할 일 목록에 나타납니다.

할 일 목록 접근#

할 일 목록에 접근하려면:

오른쪽 상단에서 할 일 아이템 ([task-done])을 선택합니다.

할 일 목록 필터링#

할 일 목록을 필터링하려면:

1. 목록 위에 커서를 텍스트 상자에 놓습니다.
2. 미리 정의된 필터 중 하나를 선택합니다.
3. Enter를 누릅니다.

할 일 목록 정렬#

할 일 목록을 정렬하려면:

1. 할 일 탭의 오른쪽 상단에서 옵션 중 하나를 선택합니다:

   • 추천은 생성 날짜와 이전에 스누즈된 날짜의 조합으로 정렬되며, 이전에 스누즈된 항목이 상단에 나타납니다.
   • 업데이트됨은 항목이 가장 최근에 업데이트된 날짜로 정렬됩니다.
   • 레이블 우선순위는 설정한 우선순위로 정렬됩니다.

2. 선택 사항. 정렬 방향을 선택합니다.

할 일 아이템을 만드는 액션#

많은 할 일 아이템이 자동으로 생성됩니다. 할 일 아이템을 할 일 목록에 추가하는 몇 가지 액션:

• 이슈 또는 머지 리퀘스트가 나에게 할당됩니다.
• 머지 리퀘스트 리뷰가 요청됩니다.
• 이슈, 머지 리퀘스트 또는 에픽의 설명이나 댓글에서 언급됩니다.
• 커밋이나 디자인의 댓글에서 언급됩니다.
• 머지 리퀘스트의 CI/CD 파이프라인이 실패합니다.
• 충돌로 인해 열린 머지 리퀘스트를 머지할 수 없으며, 다음 중 하나에 해당합니다:
  • 내가 작성자입니다.
  • 내가 파이프라인 성공 후 머지 리퀘스트를 자동으로 머지하도록 설정한 사용자입니다.
• 머지 리퀘스트가 머지 트레인에서 제거되었으며, 내가 추가한 사용자입니다.
• 내가 Owner인 그룹 또는 프로젝트에 대해 멤버 접근 요청이 제기됩니다.

GitLab 17.8 이상에서는 동일한 이슈 또는 머지 리퀘스트에서도 누군가 나를 언급할 때마다 새 할 일 알림을 받습니다.

할당 또는 리뷰 요청과 같은 할 일 아이템을 만드는 다른 액션의 경우, 동일한 이슈 또는 머지 리퀘스트에서 액션이 여러 번 발생하더라도 액션 유형당 하나의 알림만 받습니다.

할 일 아이템은 GitLab 알림 이메일 설정의 영향을 받지 않습니다. 유일한 예외: 알림 설정이 커스텀으로 설정되고 승인 대상인 머지 리퀘스트가 생성됨이 선택된 경우, 머지 리퀘스트를 승인할 자격이 있을 때 할 일 아이템을 받습니다.

할 일 아이템 만들기#

할 일 목록에 아이템을 수동으로 추가할 수 있습니다.

1. 다음으로 이동합니다:

   • 이슈
   • 머지 리퀘스트
   • 에픽
   • 디자인
   • 인시던트
   • 목표 또는 핵심 결과
   • 작업

2. 오른쪽 상단에서 할 일 아이템 추가 ([todo-add])를 선택합니다.

누군가를 언급하여 할 일 아이템 만들기#

코드 블록을 제외한 어디서든 누군가를 언급하여 할 일 아이템을 만들 수 있습니다. 하나의 메시지에서 사용자를 여러 번 언급해도 할 일 아이템은 하나만 생성됩니다.

예를 들어, 다음 댓글에서 frank를 제외한 모든 사람에게 할 일 아이템이 생성됩니다:

@alice What do you think? cc: @bob

- @carol can you please have a look?

> @dan what do you think?

Hey @erin, this is what they said:

```
Hi, please message @frank :incoming_envelope:
```

할 일 아이템을 완료로 표시하는 액션#

할 일 아이템 객체(이슈, 머지 리퀘스트, 에픽 등)에 대한 다양한 액션이 해당 할 일 아이템을 완료로 표시합니다.

다음을 수행하면 할 일 아이템이 완료로 표시됩니다:

• 설명이나 댓글에 이모지 반응 추가.
• 레이블 추가 또는 제거.
• 담당자 변경.
• 마일스톤 변경.
• 할 일 아이템의 객체 닫기.
• 댓글 작성.
• 설명 편집.
• 디자인 토론 스레드 해결.
• 프로젝트 또는 그룹 멤버십 요청 수락 또는 거부.

다음을 수행하면 할 일 아이템이 완료로 표시되지 않습니다:

• 연결된 아이템 추가(예: 연결된 이슈).
• 자식 아이템 추가(예: 자식 에픽 또는 작업).
• 시간 추적 추가.
• 자신에게 할당.
• 이슈의 상태 상태 변경.

다른 사람이 이슈 또는 에픽을 닫거나 조치를 취하면, 할 일 아이템은 대기 상태로 유지됩니다.

머지 리퀘스트가 머지 또는 닫히면, 담당자, 리뷰 요청자, 승인 요구자 또는 승인자로 추가된 모든 사용자의 할 일 아이템이 완료로 표시됩니다.

할 일 아이템을 완료로 표시#

할 일 아이템을 수동으로 완료로 표시할 수 있습니다.

두 가지 방법이 있습니다:

• 할 일 목록에서 할 일 아이템 오른쪽에 있는 완료로 표시 (✓)를 선택합니다.
• 리소스(예: 이슈 또는 머지 리퀘스트)의 오른쪽 상단에서 완료로 표시 ([todo-done])를 선택합니다.

완료된 할 일 아이템 다시 추가#

실수로 할 일 아이템을 완료로 표시한 경우 완료됨 탭에서 다시 추가할 수 있습니다:

1. 오른쪽 상단에서 할 일 아이템 ([task-done])을 선택합니다.
2. 상단에서 완료됨을 선택합니다.
3. 다시 추가할 할 일 아이템을 찾습니다.
4. 이 할 일 아이템 옆에서 실행 취소 [redo]를 선택합니다.

할 일 아이템이 이제 할 일 목록의 할 일 탭에 표시됩니다.

할 일 아이템 스누즈#

할 일 아이템을 스누즈하여 기본 할 일 목록에서 일시적으로 숨길 수 있습니다. 이를 통해 더 긴급한 작업에 집중하고 나중에 스누즈된 항목으로 돌아올 수 있습니다.

할 일 아이템을 스누즈하려면:

1. 할 일 목록에서 스누즈할 할 일 아이템 옆에 있는 스누즈 ([clock])를 선택합니다.
2. 특정 시간 및 날짜까지 할 일 아이템을 스누즈하려면 특정 시간 및 날짜까지 옵션을 선택합니다. 그렇지 않으면 미리 설정된 스누즈 기간 중 하나를 선택합니다:
   • 한 시간 동안
   • 오늘 이후까지(4시간 후)
   • 내일까지(내일 오전 8시 현지 시간)

스누즈된 할 일 아이템은 기본 할 일 목록에서 제거되고 별도의 스누즈됨 탭에 나타납니다.

스누즈 기간이 끝나면 할 일 아이템이 자동으로 기본 할 일 목록으로 돌아옵니다. 원래 생성된 시간을 표시하는 표시기와 함께 나타납니다.

스누즈된 할 일 아이템 보기#

스누즈된 할 일 아이템을 보거나 관리하려면:

1. 할 일 목록으로 이동합니다.
2. 목록 상단에서 스누즈됨 탭을 선택합니다.

스누즈됨 탭에서 다음을 수행할 수 있습니다:

• 스누즈된 할 일이 기본 목록으로 돌아올 예정 시간을 볼 수 있습니다.
• 스누즈를 제거하여 항목을 즉시 기본 할 일 목록으로 돌려보낼 수 있습니다.
• 스누즈된 할 일을 완료로 표시할 수 있습니다.

할 일 아이템 일괄 편집#

할 일 아이템을 일괄 편집할 수 있습니다:

• 할 일 탭에서: 할 일 아이템을 완료로 표시하거나 스누즈합니다.
• 스누즈됨 탭에서: 할 일 아이템을 완료로 표시하거나 제거합니다.
• 완료됨 탭에서: 할 일 아이템을 복원합니다.

할 일 아이템을 일괄 편집하려면:

1. 할 일 목록에서:
   • 개별 항목을 선택하려면 편집하려는 각 항목 왼쪽에 있는 체크박스를 선택합니다.
   • 페이지의 모든 항목을 선택하려면 왼쪽 상단에서 모두 선택 체크박스를 선택합니다.
2. 오른쪽 상단에서 원하는 액션을 선택합니다.

접근 권한이 변경되면 사용자의 할 일 목록에 미치는 영향#

보안상의 이유로 GitLab은 사용자가 관련 리소스에 더 이상 접근할 수 없게 되면 할 일 아이템을 삭제합니다. 예를 들어, 사용자가 이슈, 머지 리퀘스트, 에픽, 프로젝트 또는 그룹에 더 이상 접근할 수 없는 경우 GitLab은 관련 할 일 아이템을 삭제합니다.

이 프로세스는 접근 권한이 변경된 후 한 시간 이내에 발생합니다. 사용자의 접근 권한이 실수로 취소된 경우 데이터 손실을 방지하기 위해 삭제가 지연됩니다.

관련 주제#

• 이슈
• 머지 리퀘스트
• 에픽
• 디자인
• 인시던트
• 목표 또는 핵심 결과
• 작업