Work items
GitLab v19.4Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
작업 항목에는 다음 유형이 있습니다: Issue, Incident, TestCase, Requirement, Task, Ticket, Objective, KeyResult, Epic. 에픽 쿼리는 Premium 및 Ultimate 티어에서만 사용할 수 있습니다.
작업 항목에는 다음 유형이 있습니다:
Issue, Incident, TestCase, Requirement, Task, Ticket, Objective, KeyResult, Epic.
Note
에픽 쿼리는 Premium 및 Ultimate 티어에서만 사용할 수 있습니다.
허용 범위#
| 범위 | 설명 |
|---|---|
project |
특정 프로젝트의 작업 항목을 쿼리합니다. |
group |
하위 그룹을 포함하여 그룹 내 모든 프로젝트의 작업 항목을 쿼리합니다. |
자세한 내용은 범위를 참고합니다.
쿼리 필드#
결과를 필터링하려면 query 파라미터에 다음 필드를 사용합니다.
| 필드 | 이름(및 별칭) | 연산자 | 유형 |
|---|---|---|---|
| 담당자 | assignee, assignees |
=, in, != |
전체 |
| 작성자 | author |
=, in, != |
전체 |
| 케이던스 | cadence |
=, in |
Epic 제외 전체 |
| 종료 날짜 | closed, closedAt |
=, >, <, >=, <= |
전체 |
| 기밀 여부 | confidential |
=, != |
전체 |
| 생성 날짜 | created, createdAt, opened, openedAt |
=, >, <, >=, <= |
전체 |
| 커스텀 필드 | customField("Field name") |
= |
전체 |
| 기한 | due, dueDate |
=, >, <, >=, <= |
전체 |
| 에픽 | epic |
=, != |
Epic 제외 전체 |
| 헬스 상태 | health, healthStatus |
=, != |
전체 |
| ID | id |
=, in |
전체 |
| 하위 그룹 포함 | includeSubgroups |
=, != |
전체 |
| 이터레이션 | iteration |
=, in, != |
Epic 제외 전체 |
| 레이블 | label, labels |
=, in, != |
전체 |
| 마일스톤 | milestone |
=, in, != |
전체 |
| 내 이모지 반응 | myReaction, myReactionEmoji |
=, != |
전체 |
| 상위 항목 | parent |
=, != |
Epic 제외 전체 |
| 상태(State) | state |
= |
전체 |
| 진행 상태(Status) | status |
= |
Epic 제외 전체 |
| 구독 여부 | subscribed |
=, != |
전체 |
| 업데이트 날짜 | updated, updatedAt |
=, >, <, >=, <= |
전체 |
| 가중치 | weight |
=, != |
Epic 제외 전체 |
담당자 {#workitem-assignees}#
설명: 작업 항목에 할당된 사용자 한 명 이상을 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
StringUser(예:@username)List(String또는User값을 담음)Nullable(null,none,any중 하나)
작성자 {#workitem-author}#
설명: 작성자를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
StringUser(예:@username)List(String또는User값을 담음)
케이던스 {#workitem-cadence}#
히스토리
- GitLab 17.6에서 도입됨.
설명: 작업 항목의 이터레이션이 속한 케이던스를 기준으로 에픽을 제외한 작업 항목을 쿼리합니다.
허용되는 값 유형:
Number(양의 정수만)List(Number값을 담음)Nullable(none또는any)
참고:
- 작업 항목은 이터레이션을 하나만 가질 수 있으므로,
cadence필드에서는=연산자를List유형과 함께 사용할 수 없습니다.
종료 날짜 {#workitem-closed-at}#
히스토리
설명: 작업 항목이 종료된 날짜를 기준으로 쿼리합니다.
허용되는 값 유형:
AbsoluteDate(YYYY-MM-DD형식)RelativeDate(<sign><digit><unit>형식으로, sign은+,-또는 생략이고, digit은 정수이며,unit은d(일),w(주),m(개월),y(년) 중 하나)
참고:
=연산자에서는 사용자 시간대의 00:00부터 23:59까지를 시간 범위로 봅니다.
기밀 여부 {#workitem-confidential}#
히스토리
- 기밀 여부로 에픽을 쿼리하는 기능이 GitLab 18.1에서 도입됨.
설명: 프로젝트 멤버에게 공개되는 범위를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
Boolean(true또는false)
참고:
- GLQL로 쿼리한 기밀 작업 항목은 이를 볼 권한이 있는 사용자에게만 표시됩니다.
생성 날짜 {#workitem-created-at}#
히스토리
설명: 작업 항목이 생성된 날짜를 기준으로 쿼리합니다.
허용되는 값 유형:
AbsoluteDate(YYYY-MM-DD형식)RelativeDate(<sign><digit><unit>형식으로, sign은+,-또는 생략이고, digit은 정수이며,unit은d(일),w(주),m(개월),y(년) 중 하나)
참고:
=연산자에서는 사용자 시간대의 00:00부터 23:59까지를 시간 범위로 봅니다.
커스텀 필드 {#workitem-custom-field}#
히스토리
- GitLab 18.3에서 도입됨.
설명: 커스텀 필드를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
String(단일 선택 커스텀 필드)List(다중 선택 커스텀 필드의 경우String목록)
참고:
- 커스텀 필드의 이름과 값은 대소문자를 구분하지 않습니다.
기한 {#workitem-due-date}#
히스토리
설명: 작업 항목의 기한 날짜를 기준으로 쿼리합니다.
허용되는 값 유형:
AbsoluteDate(YYYY-MM-DD형식)RelativeDate(<sign><digit><unit>형식으로, sign은+,-또는 생략이고, digit은 정수이며,unit은d(일),w(주),m(개월),y(년) 중 하나)
참고:
=연산자에서는 사용자 시간대의 00:00부터 23:59까지를 시간 범위로 봅니다.
에픽 {#workitem-epic}#
히스토리
- GitLab 18.1에서 도입됨.
설명: 상위 에픽의 ID 또는 참조를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
Number(에픽 ID)String(&123같은 에픽 참조를 담음)Epic(예:&123,gitlab-org&123)
헬스 상태 {#workitem-health-status}#
설명: 헬스 상태를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
StringEnum("needs attention","at risk","on track"중 하나)Nullable(null,none,any중 하나)
ID {#workitem-identifier}#
설명: ID를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
Number(양의 정수만)List(Number값을 담음)
하위 그룹 포함 {#workitem-include-subgroups}#
설명: 그룹의 계층 전체에서 작업 항목을 쿼리합니다.
허용되는 값 유형:
Boolean(true또는false)
참고:
- 이 필드는
group범위에서만 사용할 수 있습니다. - 이 필드의 기본값은
false입니다.
이터레이션 {#workitem-iteration}#
설명: 연결된 이터레이션을 기준으로 에픽을 제외한 작업 항목을 쿼리합니다.
허용되는 값 유형:
Number(양의 정수만)Iteration(예:*iteration:123456)List(Number또는Iteration값을 담음)Enum(current만 지원)Nullable(none또는any)
참고:
- 작업 항목은 이터레이션을 하나만 가질 수 있으므로,
iteration필드에서는=연산자를List유형과 함께 사용할 수 없습니다.
레이블 {#workitem-labels}#
히스토리
설명: 연결된 레이블을 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
StringLabel(예:~bug,~"team::planning")List(String또는Label값을 담음)Nullable(none또는any)
참고:
- 범위 지정 레이블이나 공백이 들어간 레이블은 따옴표로 감싸야 합니다.
마일스톤 {#workitem-milestone}#
설명: 연결된 마일스톤을 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
StringMilestone(예:%Backlog,%"Awaiting Further Demand")List(String또는Milestone값을 담음)Nullable(none또는any)
참고:
- 공백이 들어간 마일스톤은 따옴표(
")로 감싸야 합니다. - 작업 항목은 마일스톤을 하나만 가질 수 있으므로,
milestone필드에서는=연산자를List유형과 함께 사용할 수 없습니다. Epic유형은none이나any같은 와일드카드 마일스톤 필터를 지원하지 않습니다.
내 이모지 반응 {#workitem-my-reaction-emoji}#
히스토리
- GitLab 18.3에서 도입됨.
설명: 현재 사용자가 작업 항목에 남긴 이모지 반응을 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형: String
상위 항목 {#workitem-parent}#
설명: 상위 작업 항목 또는 에픽을 기준으로 에픽을 제외한 작업 항목을 쿼리합니다.
허용되는 값 유형:
Number(상위 항목 ID)String(#123같은 참조를 담음)WorkItem(예:#123,gitlab-org/gitlab#123)Epic(예:&123,gitlab-org&123)
상태(State) {#workitem-state}#
설명: 상태를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형:
Enum,opened,closed,all중 하나
참고:
state필드는!=연산자를 지원하지 않습니다.
진행 상태(Status) {#workitem-status}#
히스토리
- GitLab 18.2에서 도입됨.
설명: 진행 상태를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형: String
구독 여부 {#workitem-subscribed}#
히스토리
- GitLab 18.3에서 도입됨.
설명: 현재 사용자가 알림을 설정했는지 여부를 기준으로 작업 항목을 쿼리합니다.
허용되는 값 유형: Boolean
업데이트 날짜 {#workitem-updated-at}#
히스토리
설명: 작업 항목이 마지막으로 업데이트된 시점을 기준으로 쿼리합니다.
허용되는 값 유형:
AbsoluteDate(YYYY-MM-DD형식)RelativeDate(<sign><digit><unit>형식으로, sign은+,-또는 생략이고, digit은 정수이며,unit은d(일),w(주),m(개월),y(년) 중 하나)
참고:
=연산자에서는 사용자 시간대의 00:00부터 23:59까지를 시간 범위로 봅니다.
가중치 {#workitem-weight}#
설명: 가중치를 기준으로 에픽을 제외한 작업 항목을 쿼리합니다.
허용되는 값 유형:
Number(양의 정수 또는 0만)Nullable(null,none,any중 하나)
참고:
- 비교 연산자
<와>는 사용할 수 없습니다.
표시 필드#
히스토리
| 필드 | 이름 또는 별칭 | 유형 | 설명 |
|---|---|---|---|
| Assignees | assignee, assignees |
전체 | 객체에 할당된 사용자를 표시합니다 |
| Author | author |
전체 | 객체의 작성자를 표시합니다 |
| Closed at | closed, closedAt |
전체 | 객체가 종료된 뒤 경과한 시간을 표시합니다 |
| Color | color |
Epic 전용 | 에픽에 연결된 색상 견본을 표시합니다 |
| Confidential | confidential |
전체 | 객체가 기밀인지 여부를 Yes 또는 No로 표시합니다 |
| Created at | created, createdAt |
전체 | 객체가 생성된 뒤 경과한 시간을 표시합니다 |
| Description | description |
전체 | 객체의 설명을 표시합니다 |
| Due date | due, dueDate |
전체 | 객체의 기한까지 남은 시간을 표시합니다 |
| Epic | epic |
Epic 제외 전체 | 에픽으로 가는 링크를 표시합니다. Premium 및 Ultimate 티어에서 사용할 수 있습니다 |
| Health status | health, healthStatus |
전체 | 헬스 상태를 나타내는 배지를 표시합니다. Ultimate 티어에서 사용할 수 있습니다 |
| ID | id |
전체 | 객체의 ID를 표시합니다 |
| Iteration | iteration |
Epic 제외 전체 | 이터레이션을 표시합니다. Premium 및 Ultimate 티어에서 사용할 수 있습니다 |
| Labels | label, labels |
전체 | 레이블을 표시합니다. 특정 레이블을 필터링하는 파라미터를 받을 수 있습니다. 예: labels("workflow::*", "backend") |
| Last comment | lastComment |
전체 | 객체에 마지막으로 달린 코멘트를 표시합니다 |
| Milestone | milestone |
전체 | 객체에 연결된 마일스톤을 표시합니다 |
| Parent | parent |
전체 | 상위 작업 항목 또는 에픽으로 가는 링크를 표시합니다 |
| Progress | progress |
Objective 및 Key Result 전용 | 작업 항목의 진행률(0~100)을 표시합니다 |
| Project | project |
Epic 제외 전체 | 작업 항목이 속한 프로젝트를 표시합니다 |
| Start date | start, startDate |
Epic 전용 | 에픽의 시작 날짜를 표시합니다 |
| State | state |
전체 | 상태를 나타내는 배지를 표시합니다. 값은 Open 또는 Closed입니다 |
| Status | status |
Epic 제외 전체 | 진행 상태를 나타내는 배지를 표시합니다. 예를 들어 "To do" 또는 "Complete"입니다. Premium 및 Ultimate 티어에서 사용할 수 있습니다 |
| Task completion status | taskCompletionStatus |
전체 | 태스크 완료 상태를 분수(완료/전체)로 표시합니다 |
| Time estimate | timeEstimate |
전체 | 작업 항목의 추정 시간을 표시합니다 |
| Title | title |
전체 | 객체의 제목을 표시합니다 |
| Total time spent | totalTimeSpent |
전체 | 작업 항목에 소요된 총 시간을 표시합니다 |
| Type | type |
전체 | 작업 항목 유형을 표시합니다. 예를 들어 Issue, Task, Objective입니다 |
| Updated at | updated, updatedAt |
전체 | 객체가 마지막으로 업데이트된 뒤 경과한 시간을 표시합니다 |
| Weight | weight |
Epic 제외 전체 | 가중치를 표시합니다. Premium 및 Ultimate 티어에서 사용할 수 있습니다 |
정렬 필드#
| 필드 | 이름(및 별칭) | 유형 | 설명 |
|---|---|---|---|
| Closed at | closed, closedAt |
전체 | 종료 날짜로 정렬합니다 |
| Created | created, createdAt |
전체 | 생성 날짜로 정렬합니다 |
| Due date | due, dueDate |
전체 | 기한 날짜로 정렬합니다 |
| Health status | health, healthStatus |
전체 | 헬스 상태로 정렬합니다 |
| Milestone | milestone |
Epic 제외 전체 | 마일스톤 기한 날짜로 정렬합니다 |
| Popularity | popularity |
전체 | 엄지척 이모지 반응 수로 정렬합니다 |
| Start date | start, startDate |
Epic 전용 | 시작 날짜로 정렬합니다 |
| Title | title |
전체 | 제목으로 정렬합니다 |
| Updated at | updated, updatedAt |
전체 | 마지막 업데이트 날짜로 정렬합니다 |
| Weight | weight |
Epic 제외 전체 | 가중치로 정렬합니다 |
예시#
-
gitlab-org/gitlab프로젝트의 모든 이슈를 제목 기준으로 정렬해 나열합니다:```glql display: table fields: state, title, updated sort: title asc query: project = "gitlab-org/gitlab" and type = Issue ``` -
gitlab-org그룹의 모든 에픽을 시작 날짜 기준(오래된 것부터)으로 정렬해 나열합니다:```glql display: table fields: title, state, startDate sort: startDate asc query: group = "gitlab-org" and type = Epic ``` -
가중치가 지정된
gitlab-org그룹의 모든 이슈를 가중치 기준(높은 것부터)으로 정렬해 나열합니다:```glql display: table fields: title, weight, health sort: weight desc query: type = Issue and group = "gitlab-org" and weight = any ``` -
오늘부터 일주일 안에 기한이 도래하는
gitlab-org그룹의 모든 이슈를 기한 날짜 기준(빠른 것부터)으로 정렬해 나열합니다:```glql display: table fields: title, dueDate, assignee sort: dueDate asc query: type = Issue and group = "gitlab-org" and due >= today() and due <= 1w ```