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