GLQLフィールド

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

GitLab 17.4でglql_integrationフラグとともに導入されました。デフォルトでは無効になっています。
GitLab.comのGitLab 17.4で、グループとプロジェクトのサブセットに対して有効になりました。
GitLab 17.10でベータステータスに昇格しました。
GitLab 17.10で、実験的機能からベータ版に変更されました。
GitLab 17.10のGitLab.com、GitLab Self-Managed、およびGitLab Dedicatedで有効になりました。
GitLab 18.3で一般提供になりました。機能フラグglql_integrationは削除されました。

GitLab Query Language（GLQL）を使用すると、フィールドは次の目的で使用されます:

GLQLクエリから返された結果をフィルタリングします。
埋め込みビューに表示される詳細を制御します。
埋め込みビューに表示される結果をソートします。

フィールドは、3つの埋め込みビューパラメータで使用します:

query - 取得するアイテムを決定する条件を設定します
fields - ビューに表示する列と詳細を指定します
sort - 特定の条件でアイテムを並べ替えます

次のセクションでは、各コンポーネントで使用可能なフィールドについて説明します。

クエリ内のフィールド

埋め込みビューでは、queryパラメータを使用して、<field> <operator> <value>形式の1つ以上の式を含めることができます。複数の式はandで結合されます（例: group = "gitlab-org" and author = currentUser()）。

前提要件:

エピックのクエリは、PremiumおよびUltimateティアで使用できます。

次の表に、使用可能なすべてのクエリフィールドとその仕様の概要を示します:

フィールド	名前（およびエイリアス）	演算子	サポート対象
ユーザーによる承認	`approver`、`approvedBy`、`approvers`	`=`、`!=`	マージリクエスト
担当者	`assignee`、`assignees`	`=`、`in`、`!=`	イシュー、エピック、マージリクエスト
作成者	`author`	`=`、`in`、`!=`	イシュー、エピック、マージリクエスト
ケイデンス	`cadence`	`=`、`in`	イシュー
クローズ日	`closed`、`closedAt`	`=`、`>`、`<`、`>=`、`<=`	イシュー、エピック
機密	`confidential`	`=`、`!=`	イシュー、エピック
作成日	`created`、`createdAt`、`opened`、`openedAt`	`=`、`>`、`<`、`>=`、`<=`	イシュー、エピック、マージリクエスト
カスタムフィールド	`customField("Field name")`	`=`	イシュー、エピック
ドラフト	`draft`	`=`、`!=`	マージリクエスト
期限	`due`、`dueDate`	`=`、`>`、`<`、`>=`、`<=`	イシュー、エピック
環境	`environment`	`=`	マージリクエスト
エピック	`epic`	`=`、`!=`	イシュー
グループ	`group`	`=`	イシュー、エピック、マージリクエスト
ヘルスステータス	`health`、`healthStatus`	`=`、`!=`	イシュー、エピック
ID	`id`	`=`、`in`	イシュー、エピック、マージリクエスト
サブグループを含める	`includeSubgroups`	`=`、`!=`	イシュー、エピック、マージリクエスト
イテレーション	`iteration`	`=`、`in`、`!=`	イシュー
ラベル	`label`、`labels`	`=`、`in`、`!=`	イシュー、エピック、マージリクエスト
マージ日	`merged`、`mergedAt`	`=`、`>`、`<`、`>=`、`<=`	マージリクエスト
ユーザーによるマージ	`merger`、`mergedBy`	`=`	マージリクエスト
マイルストーン	`milestone`	`=`、`in`、`!=`	イシュー、エピック、マージリクエスト
リアクションの絵文字	`myReaction`、`myReactionEmoji`	`=`、`!=`	イシュー、エピック、マージリクエスト
プロジェクト	`project`	`=`	イシュー、マージリクエスト
レビュアー	`reviewer`、`reviewers`、`reviewedBy`	`=`、`!=`	マージリクエスト
ソースブランチ	`sourceBranch`	`=`、`in`、`!=`	マージリクエスト
ステート	`state`	`=`	イシュー、エピック、マージリクエスト
ステータス	`status`	`=`	イシュー
サブスクリプション	`subscribed`	`=`、`!=`	イシュー、エピック、マージリクエスト
ターゲットブランチ	`targetBranch`	`=`、`in`、`!=`	マージリクエスト
型	`type`	`=`、`in`	イシュー、エピック、マージリクエスト
更新日	`updated`、`updatedAt`	`=`、`>`、`<`、`>=`、`<=`	イシュー、エピック、マージリクエスト
ウェイト	`weight`	`=`、`!=`	イシュー

ユーザーによる承認

説明: マージリクエストを承認した1人以上のユーザーでマージリクエストをクエリします。

Allowed value types（許可される値の型）:

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

Examples（例）:

現在のユーザーと@johndoeによって承認されたすべてのマージリクエストをリストします
```
type = MergeRequest and approver = (currentUser(), @johndoe)
```
まだ承認されていないすべてのマージリクエストをリストします
```
type = MergeRequest and approver = none
```

担当者

説明: 割り当てられている1人以上のユーザーによって、イシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

List値とin演算子は、MergeRequest型ではサポートされていません。

Examples（例）:

担当者が@johndoeのすべてのイシューをリストします:
```
assignee = @johndoe
```
担当者が@johndoeと@janedoeの両方であるすべてのイシューをリストします:
```
assignee = (@johndoe, @janedoe)
```
担当者が@johndoeまたは@janedoeのいずれかであるすべてのイシューをリストします:
```
assignee in (@johndoe, @janedoe)
```
担当者が@johndoeまたは@janedoeのいずれでもないすべてのイシューをリストします:
```
assignee != (@johndoe, @janedoe)
```
担当者が@johndoeであるすべてのマージリクエストをリストします:
```
type = MergeRequest and assignee = @johndoe
```

作成者

説明: 作成者別にイシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

in演算子は、MergeRequest型ではサポートされていません。

Examples（例）:

作成者が@johndoeのすべてのイシューをリストします:
```
author = @johndoe
```
作成者が@johndoeまたは@janedoeのいずれかであるすべてのエピックをリストします:
```
type = Epic and author in (@johndoe, @janedoe)
```
作成者が@johndoeであるすべてのマージリクエストをリストします:
```
type = MergeRequest and author = @johndoe
```

ケイデンス

説明: イシューのイテレーションが一部であるケイデンスでイシューをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

イシューが持つことができるイテレーションは1つのみであるため、=演算子はList型のcadenceフィールドでは使用できません。

Examples（例）:

ケイデンスID 123456の一部であるイテレーションを持つすべてのイシューをリストします:
```
cadence = 123456
```
任意のケイデンス123または456の一部であるイテレーションを持つすべてのイシューをリストします:
```
cadence in (123, 456)
```

クローズ日

説明: クローズ日によってイシューまたはエピックをクエリします。

Allowed value types（許可される値の型）:

AbsoluteDate（YYYY-MM-DD形式）
RelativeDate（<sign><digit><unit>形式。符号は+、-、または省略、数字は整数、unitはd（日）、w（週）、m（月）またはy（年）のいずれか）

Additional details（補足情報）:

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

Examples（例）:

昨日以降にクローズされたすべてのイシューをリストします:
```
closed > -1d
```
今日クローズされたすべてのイシューをリストします:
```
closed = today()
```
2023年2月にクローズされたすべてのイシューをリストします:
```
closed > 2023-02-01 and closed < 2023-02-28
```

機密

説明: プロジェクトメンバーへの表示によってイシューまたはエピックをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

GLQLを使用してクエリされた機密イシューは、表示権限を持つユーザーにのみ表示されます。

Examples（例）:

すべての機密イシューをリストします:
```
confidential = true
```
機密でないすべてのイシューをリストします:
```
confidential = false
```

作成日

説明: 作成日によってイシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

AbsoluteDate（YYYY-MM-DD形式）
RelativeDate（<sign><digit><unit>形式。符号は+、-、または省略、数字は整数、unitはd（日）、w（週）、m（月）またはy（年）のいずれか）

Additional details（補足情報）:

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

Examples（例）:

先週作成されたすべてのイシューをリストします:
```
created > -1w
```
今日作成されたすべてのイシューをリストします:
```
created = today()
```
2025年1月に作成され、まだオープンなすべてのイシューをリストします:
```
created > 2025-01-01 and created < 2025-01-31 and state = opened
```

カスタムフィールド

プラン: Premium、Ultimate

説明: カスタムフィールドでイシューまたはエピックをクエリします。

Allowed value types（許可される値の型）:

String（シングルセレクトのカスタムフィールドの場合）
List（マルチセレクトのカスタムフィールドの場合はString）

Additional details（補足情報）:

カスタムフィールドの名前と値では、大文字と小文字は区別されません。

Examples（例）

シングルセレクトの「Subscription」カスタムフィールドが「Free」に設定されているすべてのイシューをリストします:
```
customField("Subscription") = "Free"
```
シングルセレクトの「Subscription」および「Team」カスタムフィールドが、それぞれ「Free」および「Engineering」に設定されているすべてのイシューをリストします:
```
customField("Subscription") = "Free" and customField("Team") = "Engineering"
```
マルチセレクトの「Category」カスタムフィールドが「Markdown」および「Text Editors」に設定されているすべてのイシューをリストします:
```
customField("Category") = ("Markdown", "Text Editors")
```
または:
```
customField("Category") = "Markdown" and customField("Category") = "Text Editors"
```

ドラフト

説明: マージリクエストをドラフトステータスでクエリします。

Allowed value types（許可される値の型）:

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

Examples（例）:

すべてのドラフトマージリクエストをリストします:
```
type = MergeRequest and draft = true
```
ドラフト状態にないすべてのマージリクエストをリストします:
```
type = MergeRequest and draft = false
```

期限

説明: 期日によってイシューまたはエピックをクエリします。

Allowed value types（許可される値の型）:

AbsoluteDate（YYYY-MM-DD形式）
RelativeDate（<sign><digit><unit>形式。符号は+、-、または省略、数字は整数、unitはd（日）、w（週）、m（月）またはy（年）のいずれか）

Additional details（補足情報）:

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

Examples（例）:

1週間後が期日のすべてのイシューをリストします:
```
due < 1w
```
2025年1月1日時点で延滞していたすべてのイシューをリストします:
```
due < 2025-01-01
```
今日が期日のすべてのイシューをリストします（昨日または明日が期日ではない）:
```
due = today()
```
過去1か月で延滞していたすべてのイシューをリストします:
```
due > -1m and due < today()
```

環境

説明: デプロイされている環境によってマージリクエストをクエリします。

Allowed value types（許可される値の型）: String

Examples（例）:

環境productionにデプロイされたすべてのマージリクエストをリストします:
```
environment = "production"
```

エピック

プラン: Premium、Ultimate

説明: 親エピックIDまたは参照でイシューをクエリします。

Allowed value types（許可される値の型）:

Number（エピックID）
String（&123のようなエピック参照を含む）
Epic（例: &123、gitlab-org&123）

Examples（例）:

プロジェクトgitlab-org/gitlabでエピック&123を親として持つすべてのイシューをリストします:
```
project = "gitlab-org/gitlab" and epic = &123
```
プロジェクトgitlab-org/gitlabでエピックgitlab-com&123を親として持つすべてのイシューをリストします:
```
project = "gitlab-org/gitlab" and epic = gitlab-com&123
```

グループ

説明: 指定されたグループ内のすべてのプロジェクトでイシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）: String

Additional details（補足情報）:

一度にクエリできるグループは1つのみです。
groupは、projectフィールドと一緒に使用することはできません。
グループオブジェクト（エピックなど）の埋め込みビュー内で使用する場合に省略すると、groupは現在のグループであると見なされます。
groupフィールドを使用すると、そのグループ、すべてのサブグループ、および子プロジェクト内のすべてのオブジェクトがクエリされます。
デフォルトでは、イシューまたはマージリクエストは、すべてのサブグループのすべての子孫プロジェクトで検索されます。グループの直接の子プロジェクトのみをクエリするには、includeSubgroupsフィールドをfalseに設定します。

Examples（例）:

gitlab-orgグループとそのサブグループのイシューをリストします:
```
group = "gitlab-org"
```
gitlab-orgグループとそのサブグループのすべてのタスクをリストします:
```
group = "gitlab-org" and type = Task
```

ヘルスステータス

プラン: Ultimate

説明: ヘルスステータスでイシューまたはエピックをクエリします。

Allowed value types（許可される値の型）:

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

Examples（例）:

ヘルスステータスが設定されていないすべてのイシューをリストします:
```
health = any
```
ヘルスステータスが「対応が必要」であるすべてのイシューをリストします:
```
health = "needs attention"
```

ID

説明: ID別にイシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

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

Examples（例）:

ID 123のイシューをリストします:
```
id = 123
```
ID 1、2、または3のイシューをリストします:
```
id in (1, 2, 3)
```
ID 1、2、または3のすべてのマージリクエストをリストします:
```
type = MergeRequest and id in (1, 2, 3)
```

サブグループを含める

説明: グループの階層全体で、イシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

このフィールドは、groupフィールドでのみ使用できます。
このフィールドの値は、デフォルトでfalseに設定されています。

Examples（例）:

gitlab-orgグループの直接の子である任意のプロジェクト内のイシューを一覧表示します:
```
group = "gitlab-org" and includeSubgroups = false
```
gitlab-orgグループの階層全体内の任意のプロジェクト内のイシューを一覧表示します:
```
group = "gitlab-org" and includeSubgroups = true
```

イテレーション

プラン: Premium、Ultimate

説明: 関連付けられたイテレーションでイシューをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

イシューが持つことができるイテレーションは1つのみであるため、=演算子はList型のiterationフィールドでは使用できません。
in演算子は、MergeRequest型ではサポートされていません。

Examples（例）:

ID 123456のイシューを一覧表示します（クエリで数値を使用）:
```
iteration = 123456
```
イテレーション123または456の一部であるすべてのイシューを一覧表示します（数値を使用）:
```
iteration in (123, 456)
```
ID 123456のイテレーションを持つすべてのイシューを一覧表示します（イテレーション構文を使用）:
```
iteration = *iteration:123456
```
イテレーション123または456の一部であるすべてのイシューを一覧表示します（イテレーション構文を使用）:
```
iteration in (*iteration:123, *iteration:456)
```
現在のイテレーション内のすべてのイシューを一覧表示します
```
iteration = current
```

ラベル

説明: 関連付けられたラベルでイシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

スコープ付きラベル、またはスペースを含むラベルは引用符で囲む必要があります。
in演算子は、MergeRequest型ではサポートされていません。

Examples（例）:

ラベル~bugが付いたすべてのイシューを一覧表示します:
```
label = ~bug
```
ラベル~"workflow::in progress"が付いていないすべてのイシューを一覧表示します:
```
label != ~"workflow::in progress"
```
ラベル~bugおよび~"team::planning"が付いたすべてのイシューを一覧表示します:
```
label = (~bug, ~"team::planning")
```
ラベル~bugまたは~featureが付いたすべてのイシューを一覧表示します:
```
label in (~bug, ~feature)
```
ラベルに~bugまたは~featureのいずれも含まれていないすべてのイシューを一覧表示します:
```
label != (~bug, ~feature)
```
スコープ付きラベルが適用されないすべてのイシューをスコープworkflow::で一覧表示します:
```
label != ~"workflow::*"
```
ラベル~bugおよび~"team::planning"を持つすべてのマージリクエストを一覧表示します
```
type = MergeRequest and label = (~bug, ~"team::planning")
```

マージ日時

説明: マージリクエストがマージされた日付でマージリクエストをクエリします。

Allowed value types（許可される値の型）:

AbsoluteDate（YYYY-MM-DD形式）
RelativeDate（<sign><digit><unit>形式。符号は+、-、または省略、数字は整数、unitはd（日）、w（週）、m（月）またはy（年）のいずれか）

Additional details（補足情報）:

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

Examples（例）:

過去6か月にマージされたすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and merged > -6m
```
2025年1月にマージされたすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and merged > 2025-01-01 and merged < 2025-01-31
```

マージしたユーザー

説明: マージリクエストをマージしたユーザーでマージリクエストをクエリします。

Allowed value types（許可される値の型）:

String
User（例: @username）

Examples（例）:

現在のユーザーがマージしたすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and merger = currentUser()
```

マイルストーン

説明: 関連付けられたマイルストーンで、イシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

スペースを含むマイルストーンは、引用符（"）で囲む必要があります。
イシューが持つことができるマイルストーンは1つのみであるため、=演算子をmilestoneフィールドのList型で使用することはできません。
in演算子は、MergeRequestおよびEpic型ではサポートされていません。
Epicタイプは、noneやanyのようなワイルドカードのマイルストーンフィルターをサポートしていません。

Examples（例）:

マイルストーン%Backlogのすべてのイシューを一覧表示します:
```
milestone = %Backlog
```
マイルストーン%17.7または%17.8のすべてのイシューを一覧表示します:
```
milestone in (%17.7, %17.8)
```
今後のマイルストーンにあるすべてのイシューを一覧表示します:
```
milestone = upcoming
```
現在のマイルストーンにあるすべてのイシューを一覧表示します:
```
milestone = started
```
マイルストーンが%17.7または%17.8のいずれでもないすべてのイシューを一覧表示します:
```
milestone != (%17.7, %17.8)
```

リアクション絵文字

説明: 現在のユーザーの絵文字リアクションによって、イシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）: String

Examples（例）:

現在のユーザーが賛成の絵文字で反応したすべてのイシューを一覧表示します:
```
myReaction = "thumbsup"
```
現在のユーザーが反対の絵文字で反応しなかったすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and myReaction != "thumbsdown"
```

プロジェクト

説明: 特定のプロジェクト内のイシューまたはマージリクエストをクエリします。

Allowed value types（許可される値の型）: String

Additional details（補足情報）:

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

Examples（例）:

gitlab-org/gitlabプロジェクト内のすべてのイシューと作業アイテムを一覧表示します:
```
project = "gitlab-org/gitlab"
```

レビュアー

説明: 1人以上のユーザーによってレビューされたマージリクエストをクエリします。

Allowed value types（許可される値の型）:

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

Examples（例）:

現在のユーザーによってレビューされたすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and reviewer = currentUser()
```

ソースブランチ

**説明:**それらのソースブランチでマージリクエストをクエリします。

Allowed value types（許可される値の型）: String、List

Additional details（補足情報）:

Listの値は、inおよび!=演算子でのみサポートされています。

Examples（例）:

特定のブランチからのすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and sourceBranch = "feature/new-feature"
```
複数のブランチからのすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and sourceBranch in ("main", "develop")
```
特定のブランチからではないすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and sourceBranch != "main"
```

ステート

説明: ステータスでイシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

Enum
- イシューおよび作業アイテムタイプの場合、opened、closed、またはallのいずれか
- MergeRequestタイプの場合、opened、closed、merged、またはallのいずれか

Additional details（補足情報）:

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

Examples（例）:

クローズされたすべてのイシューを一覧表示します:
```
state = closed
```
オープンされたすべてのイシューを一覧表示します:
```
state = opened
```
それらのステータスに関係なく、すべてのイシューを一覧表示します（デフォルトも同様）:
```
state = all
```
マージされたすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and state = merged
```

ステータス

プラン: Premium、Ultimate

**説明:**それらのステータスでイシューをクエリします。

Allowed value types（許可される値の型）: String

Examples（例）:

To Doのステータスを持つすべてのイシューを一覧表示します:
```
status = "To do"
```

サブスクライブ

説明: 現在のユーザーがオンまたはオフに通知を設定しているかどうかによって、イシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）: Boolean

Examples（例）:

現在のユーザーが通知をオンに設定しているすべてのオープンなイシューを一覧表示します:
```
state = opened and subscribed = true
```
現在のユーザーが通知をオフに設定しているすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and subscribed = false
```

ターゲットブランチ

**説明:**それらのターゲットブランチによってマージリクエストをクエリします。

Allowed value types（許可される値の型）: String、List

Additional details（補足情報）:

Listの値は、inおよび!=演算子でのみサポートされています。

Examples（例）:

特定のブランチをターゲットとするすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and targetBranch = "feature/new-feature"
```
複数のブランチをターゲットとするすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and targetBranch in ("main", "develop")
```
特定のブランチをターゲットとしていないすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and targetBranch != "main"
```

型

説明: クエリするオブジェクトのタイプ: イシュー、エピック、またはマージリクエスト。

Allowed value types（許可される値の型）:

Enum、次のいずれかになります:
- Issue
- Incident
- Epic
- TestCase
- Requirement
- Task
- Ticket
- Objective
- KeyResult
- MergeRequest
List（1つ以上のenum値を含む）

Additional details（補足情報）:

埋め込みビュー内で使用する場合に省略すると、デフォルトのtypeはIssueになります。
type = Epicクエリは、グループフィールドでのみ一緒に使用できます。
in演算子を使用して、同じクエリ内の他のタイプとEpicタイプおよびMergeRequestタイプを結合することはできません。

Examples（例）:

インシデントを一覧表示します:
```
type = incident
```
イシューとタスクをリスト表示する:
```
type in (Issue, Task)
```
現在のユーザーに割り当てられたすべてのマージリクエストを一覧表示します:
```
type = MergeRequest and assignee = currentUser()
```
グループgitlab-org内の現在のユーザーが作成者であるすべてのエピックを一覧表示します
```
group = "gitlab-org" and type = Epic and author = currentUser()
```

更新日時

説明: 最後に更新された日時でイシュー、エピック、またはマージリクエストをクエリします。

Allowed value types（許可される値の型）:

AbsoluteDate（YYYY-MM-DD形式）
RelativeDate（<sign><digit><unit>形式。符号は+、-、または省略、数字は整数、unitはd（日）、w（週）、m（月）またはy（年）のいずれか）

Additional details（補足情報）:

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

Examples（例）:

過去1か月に編集されていないすべてのイシューを一覧表示します:
```
updated < -1m
```
今日編集されたすべてのイシューを一覧表示します:
```
updated = today()
```
過去1週間に編集されていないすべてのオープンMRを一覧表示します:
```
type = MergeRequest and state = opened and updated < -1w
```

ウェイト

プラン: Premium、Ultimate

説明: それらのウェイトでイシューをクエリします。

Allowed value types（許可される値の型）:

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

Additional details（補足情報）:

比較演算子<および>は使用できません。

Examples（例）:

ウェイトが5のすべてのイシューを一覧表示します:
```
weight = 5
```
ウェイトが5ではないすべてのイシューを一覧表示します:
```
weight != 5
```

埋め込みビューのフィールド

フィールドiterationがGitLab 17.6で導入されました。
マージリクエストのサポートが、GitLab 17.8で導入されました。
フィールドlastCommentがGitLab 17.11で導入されました。
エピックのサポートは、GitLab 18.1で導入されました。
フィールドstatus、sourceBranch、targetBranch、sourceProject、およびtargetProjectがGitLab 18.2で導入されました。
GitLab 18.3で、エピックのフィールドhealth、およびtypeが導入されました。
フィールドsubscribedがGitLab 18.3で導入されました。

埋め込みビューでは、fieldsビューパラメータはフィールドのコンマ区切りリスト、またはレンダリングされた埋め込みビューに含めるフィールドを示すために使用できるフィールド関数です（例: fields: title, state, health, epic, milestone, weight, updated）。

フィールド	名前またはエイリアス	サポートされているオブジェクト	説明
ユーザーによる承認	`approver`、`approvers`、`approvedBy`	マージリクエスト	マージリクエストを承認したユーザーを表示します
担当者	`assignee`、`assignees`	イシュー、マージリクエスト	オブジェクトに割り当てられたユーザーを表示します
作成者	`author`	イシュー、エピック、マージリクエスト	オブジェクトの作成者を表示します
クローズ日	`closed`、`closedAt`	イシュー、エピック、マージリクエスト	オブジェクトがクローズされてからの時間を表示します
機密	`confidential`	イシュー、エピック	オブジェクトが機密かどうかを示す`Yes`または`No`を表示します
作成日	`created`、`createdAt`	イシュー、エピック、マージリクエスト	オブジェクトが作成されてからの経過時間を表示します
説明	`description`	イシュー、エピック、マージリクエスト	オブジェクトの説明を表示します
ドラフト	`draft`	マージリクエスト	`Yes`または`No`を表示して、マージリクエストがドラフト状態にあるかどうかを示します
期限	`due`、`dueDate`	イシュー、エピック	オブジェクトの期日までの時間を表示します
エピック	`epic`	イシュー	イシューのエピックへのリンクを表示します。PremiumプランおよびUltimateプランで利用できます。
ヘルスステータス	`health`、`healthStatus`	イシュー、エピック	オブジェクトのヘルスステータスを示すバッジを表示します。Ultimateプランで利用可能です
ID	`id`	イシュー、エピック、マージリクエスト	オブジェクトのIDを表示します
イテレーション	`iteration`	イシュー	オブジェクトに関連付けられたイテレーションを表示します。PremiumプランおよびUltimateプランで利用できます。
ラベル	`label`、`labels`	イシュー、エピック、マージリクエスト	オブジェクトに関連付けられたラベルを表示します。特定のラベルをフィルタリングするためのパラメータを受け入れることができます。例: `labels("workflow::*", "backend")`
最後のコメント	`lastComment`	イシュー、エピック、マージリクエスト	オブジェクトに対して行われた最後のコメントを表示します
マージ日	`merged`、`mergedAt`	マージリクエスト	マージリクエストがマージされてからの経過時間を表示します
マイルストーン	`milestone`	イシュー、エピック、マージリクエスト	オブジェクトに関連付けられているマイルストーンを表示します
レビュアー	`reviewer`、`reviewers`	マージリクエスト	マージリクエストのレビューに割り当てられたユーザーを表示します
ソースブランチ	`sourceBranch`	マージリクエスト	マージリクエストのソースブランチを表示します
ソースプロジェクト	`sourceProject`	マージリクエスト	マージリクエストのソースブランチプロジェクトを表示します
開始日	`start`、`startDate`	エピック	エピックの開始日を表示します
ステート	`state`	イシュー、エピック、マージリクエスト	オブジェクトの状態を示すバッジを表示します。イシューとエピックの場合、値は`Open`または`Closed`です。マージリクエストの場合、値は`Open`、`Closed`、または`Merged`です
ステータス	`status`	イシュー	イシューのステータスを示すバッジを表示します。たとえば、「To Do」や「完了」などがあります。PremiumプランおよびUltimateプランで利用できます。
サブスクリプション	`subscribed`	イシュー、エピック、マージリクエスト	現在のユーザーがオブジェクトをサブスクライブしているかどうかを示す`Yes`または`No`を表示します
ターゲットブランチ	`targetBranch`	マージリクエスト	マージリクエストのターゲットブランチを表示します。
ターゲットプロジェクト	`targetProject`	マージリクエスト	マージリクエストのターゲットプロジェクトを表示します
タイトル	`title`	イシュー、エピック、マージリクエスト	オブジェクトのタイトルを表示します
型	`type`	イシュー、エピック	作業アイテムのタイプ（`Issue`、`Task`、`Objective`など）を表示します
更新日	`updated`、`updatedAt`	イシュー、エピック、マージリクエスト	オブジェクトが最後に更新されてからの経過時間を表示します
ウェイト	`weight`	イシュー	オブジェクトのウェイトを表示します。PremiumプランおよびUltimateプランで利用できます。

埋め込みビューをソートするためのフィールド

埋め込みビューでは、sortビューパラメータは、指定されたフィールドと順序で結果をソートするソート順序（ascまたはdesc）が続くフィールド名です。

フィールド	名前（およびエイリアス）	サポート対象	説明
クローズ日	`closed`、`closedAt`	イシュー、エピック、マージリクエスト	クローズ日でソート
作成済み	`created`、`createdAt`	イシュー、エピック、マージリクエスト	作成日でソート
期限	`due`、`dueDate`	イシュー、エピック	期日でソート
ヘルスステータス	`health`、`healthStatus`	イシュー、エピック	ヘルスステータスでソート
マージ日	`merged`、`mergedAt`	マージリクエスト	マージ日でソート
マイルストーン	`milestone`	イシュー、マージリクエスト	マイルストーンの期日でソート
人気度	`popularity`	イシュー、エピック、マージリクエスト	絵文字リアクションの賛成数でソート
開始日	`start`、`startDate`	エピック	開始日でソート
タイトル	`title`	イシュー、エピック、マージリクエスト	タイトルでソート
更新日	`updated`、`updatedAt`	イシュー、エピック、マージリクエスト	最終更新日でソート
ウェイト	`weight`	イシュー	ウェイトでソート

Examples（例）:

gitlab-org/gitlabプロジェクト内のすべてのイシューをタイトルでソートして表示します。列state、title、およびupdatedを表示します。
```
```glql
display: table
fields: state, title, updated
sort: title asc
query: project = "gitlab-org/gitlab" and type = Issue
```
```
認証されたユーザーに割り当てられたgitlab-orgグループ内のすべてのマージリクエストをマージ日（最新順）でソートして表示します。列title、reviewer、およびmergedを表示します。
```
```glql
display: table
fields: title, reviewer, merged
sort: merged desc
query: group = "gitlab-org" and type = MergeRequest and state = merged and author = currentUser()
limit: 10
```
```
gitlab-orgグループ内のすべてのエピックを開始日（最も古い順）でソートして表示します。列title、state、およびstartDateを表示します。
```
```glql
display: table
fields: title, state, startDate
sort: startDate asc
query: group = "gitlab-org" and type = Epic
```
```
割り当てられたウェイトを持つgitlab-orgグループ内のすべてのイシューを、ウェイト（最も高い順）でソートして表示します。列title、weight、およびhealthを表示します。
```
```glql
display: table
fields: title, weight, health
sort: weight desc
query: group = "gitlab-org" and weight = any
```
```
gitlab-orgグループ内のすべてのイシューを今日から1週間以内に期限が来るように、期日（最も早い順）でソートして表示します。列title、duedate、およびassigneeを表示します。
```
```glql
display: table
fields: title, dueDate, assignee
sort: dueDate asc
query: group = "gitlab-org" and due >= today() and due <= 1w
```
```

トラブルシューティング

クエリタイムアウトエラー

次のエラーメッセージが表示される場合があります:

Embedded view timed out. Add more filters to reduce the number of results.

Query temporarily blocked due to repeated timeouts. Please try again later or try narrowing your search scope.

これらのエラーは、クエリの実行に時間がかかりすぎると発生します。結果セットが大きい場合や、検索範囲が広い場合、タイムアウトが発生する可能性があります。

この問題を解決するには、フィルターを追加して検索範囲を制限します:

created、updated、またはclosedのような日付フィールドを使用して、結果を特定の期間に制限する期間フィルターを追加します。次に例を示します:
```
```glql
display: table
fields: title, labels, created
query: group = "gitlab-org" and label = "group::knowledge" and created > "2025-01-01" and created < "2025-03-01"
```
```

アクティブな項目に焦点を当てるために、最近の更新でフィルタリングします:

```glql
display: table
fields: title, labels, updated
query: group = "gitlab-org" and label = "group::knowledge" and updated > -3m
```

可能な場合は、グループ全体の検索ではなく、プロジェクト固有のクエリを使用します:

```glql
display: table
fields: title, state, assignee
query: project = "gitlab-org/gitlab" and state = opened and updated > -1m
```