作業アイテム

プラン: Free、Premium、Ultimate
提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

作業アイテムには、次のタイプが含まれます: Issue、Incident、TestCase、Requirement、Task、Ticket、Objective、KeyResult、およびEpic。

エピックのクエリは、PremiumおよびUltimateでのみ利用可能です。

クエリフィールド

フィールド	名前（およびエイリアス）	演算子	タイプ
Assignees	`assignee`、`assignees`	`=`、`in`、`!=`	すべて
Author	`author`	`=`、`in`、`!=`	すべて
ケイデンス	`cadence`	`=`、`in`	エピックを除くすべて
Closed at	`closed`、`closedAt`	`=`、`>`、`<`、`>=`、`<=`	すべて
機密	`confidential`	`=`、`!=`	すべて
作成日時	`created`、`createdAt`、`opened`、`openedAt`	`=`、`>`、`<`、`>=`、`<=`	すべて
カスタムフィールド	`customField("Field name")`	`=`	すべて
期限	`due`、`dueDate`	`=`、`>`、`<`、`>=`、`<=`	すべて
エピック	`epic`	`=`、`!=`	エピックを除くすべて
グループ	`group`	`=`	すべて
ヘルスステータス	`health`、`healthStatus`	`=`、`!=`	すべて
ID	`id`	`=`、`in`	すべて
サブグループを含む	`includeSubgroups`	`=`、`!=`	すべて
イテレーション	`iteration`	`=`、`in`、`!=`	エピックを除くすべて
ラベル	`label`、`labels`	`=`、`in`、`!=`	すべて
マイルストーン	`milestone`	`=`、`in`、`!=`	すべて
My reaction emoji	`myReaction`、`myReactionEmoji`	`=`、`!=`	すべて
親	`parent`	`=`、`!=`	エピックを除くすべて
プロジェクト	`project`	`=`	エピックを除くすべて
State	`state`	`=`	すべて
ステータス	`status`	`=`	エピックを除くすべて
サブスクライブ	`subscribed`	`=`、`!=`	すべて
Updated at	`updated`、`updatedAt`	`=`、`>`、`<`、`>=`、`<=`	すべて
ウェイト	`weight`	`=`、`!=`	エピックを除くすべて

担当者

説明: 作業アイテムを、1人または複数の担当作成者でクエリします。

指定可能な値の型:

String
User （例: @username）
List （StringまたはUserの値を含む）
Nullable （null、 none、またはanyのいずれか）

作成者

説明: 作業アイテムをその作成者でクエリします。

指定可能な値の型:

String
User （例: @username）
List （StringまたはUserの値を含む）

ケイデンス

説明: エピックを除く作業アイテムを、作業アイテムのイテレーションが属するケイデンスでクエリします。

指定可能な値の型:

Number （正の整数のみ）
List （Number値を含む）
Nullable （noneまたはanyのいずれか）

ノート:

作業アイテムは1つのイテレーションしか持てないため、cadenceフィールドにListタイプで=オペレーターを使用することはできません。

Closed at

説明: 作業アイテムを、それらがクローズされた日付でクエリします。

指定可能な値の型:

AbsoluteDate （YYYY-MM-DD形式で）
RelativeDate （<sign><digit><unit>形式。+、-、または省略された記号、整数である桁、およびunitがd (日)、 w (週)、 m (月)、またはy (年) のいずれかである）

ノート:

=演算子の場合、時刻範囲はユーザーのタイムゾーンで00:00から23:59までと見なされます。
>=および<=演算子は、クエリされる日付を含みますが、>および<は含みません。

Confidential

説明: 作業アイテムを、プロジェクトメンバーへの表示レベルでクエリします。

指定可能な値の型:

Boolean （trueまたはfalseのいずれか）

ノート:

GLQLを使用してクエリされた機密の作業アイテムは、それらを閲覧する権限を持つユーザーにのみ表示されます。

Created at

説明: 作業アイテムを、それらが作成された日付でクエリします。

指定可能な値の型:

AbsoluteDate （YYYY-MM-DD形式で）
RelativeDate （<sign><digit><unit>形式。+、-、または省略された記号、整数である桁、およびunitがd (日)、 w (週)、 m (月)、またはy (年) のいずれかである）

ノート:

=演算子の場合、時刻範囲はユーザーのタイムゾーンで00:00から23:59までと見なされます。
>=および<=演算子は、クエリされる日付を含みますが、>および<は含みません。

カスタムフィールド

プラン: Premium、Ultimate

説明: カスタムフィールドで作業アイテムをクエリします。

指定可能な値の型:

String (単一選択カスタムフィールドの場合)
List (String、複数選択カスタムフィールドの場合)

ノート:

カスタムフィールド名と値は、大文字と小文字を区別しません。

期限日

説明: 作業アイテムを、それらが期日となる日付でクエリします。

指定可能な値の型:

AbsoluteDate （YYYY-MM-DD形式で）
RelativeDate （<sign><digit><unit>形式。+、-、または省略された記号、整数である桁、およびunitがd (日)、 w (週)、 m (月)、またはy (年) のいずれかである）

ノート:

=演算子の場合、時刻範囲はユーザーのタイムゾーンで00:00から23:59までと見なされます。
>=および<=演算子は、クエリされる日付を含みますが、>および<は含みません。

エピック

プラン: Premium、Ultimate

説明: 作業アイテムを、その親エピックIDまたは参照でクエリします。

指定可能な値の型:

Number (エピックID)
String (エピックの参照 (&123など) を含む)
Epic （例: &123, gitlab-org&123）

グループ

説明: 指定されたグループ内のすべてのプロジェクトで作業アイテムをクエリします。

指定可能な値の型: String

ノート:

一度にクエリできるグループは1つだけです。
groupはprojectフィールドと一緒に使用できません。
グループオブジェクト (エピックなど) 内の埋め込みビューで使用する場合、groupは現在のグループであると見なされます。
groupフィールドを使用すると、そのグループ内のすべてのオブジェクト、そのすべてのサブグループ、および子プロジェクトをクエリします。
デフォルトでは、作業アイテムはすべてのサブグループのすべての子孫プロジェクトで検索されます。グループの直下の子孫プロジェクトのみをクエリするには、includeSubgroupsフィールドをfalseに設定します。

ヘルスステータス

プラン: Ultimate

説明: 作業アイテムをそのヘルスステータスでクエリします。

指定可能な値の型:

StringEnum ("needs attention"、"at risk"、または"on track"のいずれか)
Nullable （null、 none、またはanyのいずれか）

ID

説明: 作業アイテムをそれらのIDでクエリします。

指定可能な値の型:

Number （正の整数のみ）
List （Number値を含む）

サブグループを含める

説明: グループの階層全体で作業アイテムをクエリします。

指定可能な値の型:

Boolean （trueまたはfalseのいずれか）

ノート:

このフィールドはgroupフィールドと一緒にのみ使用できます。
このフィールドの値はデフォルトでfalseです。

イテレーション

プラン: Premium、Ultimate

説明: エピックを除く作業アイテムを、関連するイテレーションでクエリします。

指定可能な値の型:

Number （正の整数のみ）
Iteration （例: *iteration:123456）
List （NumberまたはIterationの値を含む）
Enum (currentのみがサポートされます)
Nullable （noneまたはanyのいずれか）

ノート:

作業アイテムは1つのイテレーションしか持てないため、iterationフィールドにListタイプで=オペレーターを使用することはできません。

ラベル

説明: 作業アイテムを、それらに関連付けられたラベルでクエリします。

指定可能な値の型:

String
Label （例: ~bug, ~"team::planning"）
List （StringまたはLabelの値を含む）
Nullable （noneまたはanyのいずれか）

ノート:

スコープ付きラベル、またはスペースを含むラベルは引用符で囲む必要があります。

マイルストーン

説明: 作業アイテムを、それらに関連付けられたマイルストーンでクエリします。

指定可能な値の型:

String
Milestone （例: %Backlog, %"Awaiting Further Demand"）
List （StringまたはMilestoneの値を含む）
Nullable （noneまたはanyのいずれか）

ノート:

スペースを含むマイルストーンは引用符（"）で囲む必要があります。
作業アイテムは1つのマイルストーンしか持てないため、milestoneフィールドにListタイプで=オペレーターを使用することはできません。
Epicタイプは、noneやanyのようなワイルドカードマイルストーンフィルターをサポートしていません。

My reaction emoji

説明: 現在のユーザーの絵文字リアクションで作業アイテムをクエリします。

指定可能な値の型: String

親

説明: エピックを除く作業アイテムを、その親作業アイテムまたはエピックでクエリします。

指定可能な値の型:

Number (親ID)
String (参照 (#123など) を含む)
WorkItem （例: #123, gitlab-org/gitlab#123）
Epic （例: &123, gitlab-org&123）

プロジェクト

説明: 特定のプロジェクトで、エピックを除く作業アイテムをクエリします。

指定可能な値の型: String

ノート:

一度にクエリできるプロジェクトは1つだけです。
projectフィールドはgroupフィールドと一緒に使用できません。
埋め込みビュー内で使用する場合、省略するとprojectは現在のプロジェクトであると見なされます。

ステータス

説明: 作業アイテムを状態によってクエリします。

指定可能な値の型:

Enum (opened、closed、またはallのいずれか)

ノート:

stateフィールドは!=演算子をサポートしていません。

ステータス

プラン: Premium、Ultimate

**説明:**作業アイテムをそのステータスでクエリします。

指定可能な値の型: String

サブスクライブ済み

説明: 現在のユーザーが通知をオンまたはオフに設定しているかどうかで作業アイテムをクエリします。

指定可能な値の型: Boolean

Updated at

説明: 作業アイテムを、それらが最終更新された日時でクエリします。

指定可能な値の型:

AbsoluteDate （YYYY-MM-DD形式で）
RelativeDate （<sign><digit><unit>形式。+、-、または省略された記号、整数である桁、およびunitがd (日)、 w (週)、 m (月)、またはy (年) のいずれかである）

ノート:

=演算子の場合、時刻範囲はユーザーのタイムゾーンで00:00から23:59までと見なされます。
>=および<=演算子は、クエリされる日付を含みますが、>および<は含みません。

ウェイト

プラン: Premium、Ultimate

説明: エピックを除く作業アイテムを、そのウェイトでクエリします。

指定可能な値の型:

Number (正の整数または0のみ)
Nullable （null、 none、またはanyのいずれか）

ノート:

比較オペレーター<および>は使用できません。

表示フィールド

フィールドiterationがGitLab 17.6で導入されました。
フィールドlastCommentがGitLab 17.11で導入されました。
エピックのサポートがGitLab 18.1で導入されました。
フィールドstatusがGitLab 18.2で導入されました。
エピックのフィールドhealthとtypeがGitLab 18.3で導入されました。
フィールドsubscribedがGitLab 18.3で導入されました。

フィールド	名前またはエイリアス	タイプ	説明
Assignees	`assignee`、`assignees`	すべて	オブジェクトに割り当てられたユーザーを表示
Author	`author`	すべて	オブジェクトの作成者を表示
Closed at	`closed`、`closedAt`	すべて	オブジェクトがクローズされてからの時間を表示
機密	`confidential`	すべて	オブジェクトが機密であるかどうかを示す`Yes`または`No`を表示
作成日時	`created`、`createdAt`	すべて	オブジェクトが作成されてからの時間を表示
説明	`description`	すべて	オブジェクトの説明を表示
期限	`due`、`dueDate`	すべて	オブジェクトの期日までの時間を表示
エピック	`epic`	エピックを除くすべて	エピックへのリンクを表示。PremiumおよびUltimateで利用可能です
ヘルスステータス	`health`、`healthStatus`	すべて	ヘルスステータスを示すバッジを表示。Ultimateで利用可能です
ID	`id`	すべて	オブジェクトのIDを表示
イテレーション	`iteration`	エピックを除くすべて	イテレーションを表示。PremiumおよびUltimateで利用可能です
ラベル	`label`、`labels`	すべて	ラベルを表示。特定のラベルをフィルタリングするためのパラメータを受け入れられます。例: `labels("workflow::*", "backend")`
最後のコメント	`lastComment`	すべて	オブジェクトに対して行われた最終コメントを表示
マイルストーン	`milestone`	すべて	オブジェクトに関連付けられたマイルストーンを表示
開始日	`start`、`startDate`	エピックのみ	エピックの開始日を表示
State	`state`	すべて	ステータスを示すバッジを表示。値は`Open`または`Closed`です。
ステータス	`status`	エピックを除くすべて	ステータスを示すバッジを表示。例: 「To Do」または「完了」。PremiumおよびUltimateで利用可能です
サブスクライブ	`subscribed`	すべて	現在のユーザーがサブスクライブされているかどうかを示す`Yes`または`No`を表示
Title	`title`	すべて	オブジェクトのタイトルを表示
タイプ	`type`	すべて	作業アイテムのタイプを表示します。例: `Issue`、`Task`、または`Objective`
Updated at	`updated`、`updatedAt`	すべて	オブジェクトが最終更新されてからの時間を表示
ウェイト	`weight`	エピックを除くすべて	ウェイトを表示。PremiumおよびUltimateで利用可能です

ソートフィールド

フィールド	名前（およびエイリアス）	タイプ	説明
Closed at	`closed`、`closedAt`	すべて	クローズされた日付でソート
Created	`created`、`createdAt`	すべて	作成された日付でソート
期限	`due`、`dueDate`	すべて	期日でソート
ヘルスステータス	`health`、`healthStatus`	すべて	ヘルスステータスでソート
マイルストーン	`milestone`	エピックを除くすべて	マイルストーンの期日でソート
人気度	`popularity`	すべて	高評価のリアクションの絵文字の数でソート
開始日	`start`、`startDate`	エピックのみ	開始日でソート
Title	`title`	すべて	タイトルでソート
Updated at	`updated`、`updatedAt`	すべて	最終更新日でソート
ウェイト	`weight`	エピックを除くすべて	ウェイトでソート

例:

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グループ内の、本日より1週間以内のすべてのイシューを期限日 (最も早いものが最初) でソートしてリスト表示します:
```
```glql
display: table
fields: title, dueDate, assignee
sort: dueDate asc
query: type = Issue and group = "gitlab-org" and due >= today() and due <= 1w
```
```