ドキュメントに関する現在のご利用体験についてお聞かせください。アンケートにご協力ください。

作業アイテム

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

作業アイテムは、GitLabにおける作業の計画と追跡のための核となる要素です。並べ替え順を昇順と降順の間で変更するには: 作業アイテムは、この基本的なニーズに基づいて設計されており、戦略的な取り組みから個々のタスクまで、あらゆるレベルの作業単位を表す方法を統一します。

作業アイテムの階層的な性質により、異なるレベルの作業間の関係が明確になり、日々のタスクがより大きな目標にどのように貢献するか、また戦略的な目標が実行可能なコンポーネントにどのように分解されるかをチームが理解するのに役立ちます。

この構造は、Scrum、Kanban、ポートフォリオ管理などの様々な計画フレームワークをサポートし、同時にあらゆるレベルでチームが進捗状況を可視化できるようにします。

作業アイテムタイプ

GitLabは次の作業アイテムタイプをサポートしています:

イシュー: タスク、機能、バグを追跡します。
エピック: 複数のマイルストーンとイシューにわたる大規模なイニシアチブを管理します。
タスク: 小さな作業単位を追跡します。
目標と主な成果: 戦略的な目標とその測定可能な結果を追跡します。
テストケース: テスト計画をGitLabワークフローに直接統合します。

また、作業アイテムタイプを設定して、新しい種類を作成したり、グループやプロジェクト全体での利用可否を管理したりできます。

すべての作業アイテムを表示する

作業アイテムリストは、プロジェクトまたはグループのすべての作業アイテムタイプ（イシュー、エピック、タスクなど）を表示および管理するための一元的な場所となります。このビューを使用して、プロジェクトまたはグループでの作業の完全なスコープを理解し、効果的に優先順位を付けます。

GitLabの以前のバージョンでは、計画 > イシューおよび計画 > エピックにイシューとエピックのリストページが別々にありました。GitLab 18.10以降では、これらのページは、すべての作業アイテムタイプを単一のビューに統合する計画 > 作業アイテムに置き換えられました。サイドバーにイシューまたはエピックをピン留めしていた場合、それらの場所に作業アイテムがピン留めされます。/epics/:iidまたは/issues/:iidを含むURLは、自動的に/work_items/:iidにリダイレクトされます。

プロジェクトまたはグループの作業アイテムを表示するには:

上部のバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
左側のサイドバーで、計画 > 作業アイテムを選択します。

作業アイテムをフィルタリングする

作業アイテムリストは、デフォルトですべての作業アイテムタイプを表示します。特定のタイプ（例: イシューのみまたはエピックのみ）を表示するには、タイプフィルターを使用します。

作業アイテムリストをフィルタリングするには:

ページの上部にあるフィルターバーから、フィルター、演算子、およびその値を選択します。たとえば、エピックのみを表示するには、フィルターにタイプ、演算子にis、および値にエピックを選択します。
オプション。検索を絞り込むには、さらにフィルターを追加します。
Enterを押すか、検索アイコン（）を選択します。

利用可能なフィルター

これらのフィルターは作業アイテムで利用できます:

担当者
- 演算子: is、is not one of、is one of
作成者
- 演算子: is、is not one of、is one of
機密
- 値: Yes、No
連絡先
- 演算子: is
ステータス
- 演算子: is
ヘルスステータス
- 演算子: is、is not
イテレーション
- 演算子: is、is not
ラベル
- 演算子: is、is not one of、is one of
マイルストーン
- 演算子: is、is not
自分のリアクション
- 演算子: is、is not
組織
- 演算子: is
親
- 演算子: is、is not
- 値: 任意のIssue、Epic、Objective
リリース
- 演算子: is、is not
検索対象
- 演算子: Titles、Descriptions
ステート
- 値: Any、Open、Closed
タイプ
- 値: Issue、Incident、Task、Epic、Objective、Key Result、Test case
ウェイト
- 演算子: is、is not

最近使用したフィルターにアクセスするには、フィルターバーの左側にある最近の検索（）ドロップダウンリストを選択します。

作業アイテムを並べ替える

作業アイテムのリストを次で並べ替えます:

作成日
更新日
開始日
期限
タイトル
ステータス
ウェイト

並べ替えの基準を変更するには:

フィルターバーの右側にあるディスプレイ（）を選択して、表示設定ドロワーを開きます。
ドロワーの上部にある並べ替えドロップダウンリストを選択します。

ソート順を昇順と降順の間で変更するには、:

フィルターバーの右側にあるディスプレイ（）を選択して、表示設定ドロワーを開きます。
ドロワーの上部にある並べ替えドロップダウンリストの横にあるソート順（または）を選択します。

並べ替えロジックの詳細については、イシューリストの並べ替えと順序付けを参照してください。

リスト表示の環境設定を構成する

リストページでの作業アイテムの表示方法をカスタマイズするには、特定のメタデータフィールドを表示または非表示にして、ビューの環境設定を構成します。

GitLabは、異なるレベルで表示設定を保存します:

フィールド: ネームスペースごとに保存されます。ワークフローのニーズに基づいて、異なるグループやプロジェクトに対して異なるフィールドの表示レベルを設定できます。たとえば、あるグループやプロジェクトでは担当者とラベルを表示し、別のグループやプロジェクトではそれらを非表示にすることができます。
環境設定: すべてのプロジェクトとグループでグローバルに保存されます。これにより、作業アイテムの表示方法の設定が常に一貫したものになります。

表示の環境設定を構成するには:

上部のバーで、検索または移動先を選択して、グループを見つけます。
左側のサイドバーで、計画 > 作業アイテムを選択します。
フィルターバーの右側にあるディスプレイ（）を選択して、表示設定ドロワーを開きます。
フィールドで、表示するメタデータをオンまたはオフにします:
- ステータス（イシュー用）
- 担当者
- ラベル
- ウェイト（イシュー用）
- マイルストーン
- イテレーション（イシュー用）
- 日付: 期限と日付の範囲
- ヘルス: ヘルスステータスインジケーター
- ブロック済み/ブロック中: ブロック関係インジケーター
- コメント: コメント数
- 人気度: 人気度メトリクス
有効にしたフィールドは表示の下に表示されます。無効にしたフィールドは非表示の下に表示されます。
オプション。特定のフィールドを検索するには、フィールドを検索入力を使用します。
設定で、サイドパネルにアイテムを開くをオンまたはオフにして、作業アイテムを選択したときに開く方法を選択します:
- オン（デフォルト）: アイテムは画面右側のドロワーで開きます。
- オフ: アイテムは全ページ表示で開きます。

設定は保存され、すべてのセッションとデバイスで記憶されます。

作業アイテムのMarkdown参照

GitLab Flavored Markdownフィールドでは、[work_item:123]を使用して作業アイテムを参照できます。詳細については、GitLab固有の参照をご覧ください。

マージリクエスト内の作業アイテム

マージリクエストの説明で作業アイテムを参照すると、マージリクエストサイドバーの作業アイテムウィジェットに自動的に表示されます。ウィジェットは作業アイテムを2つのカテゴリにグループ化します:

クロージング: 作業アイテムは、クローズパターン（例: Closes #123）とリンクされています。これらの作業アイテムは、MRがマージされると自動的にクローズされます。
メンション済み: 説明で参照されているが、クローズパターンとリンクされていない作業アイテム（例: Related to #456）。これらの作業アイテムは、MRがマージされるときにクローズされません。

ウィジェットに3つ以上の作業アイテムが含まれている場合、デフォルトで折りたたまれます。ウィジェットヘッダーを選択して、展開します。任意の作業アイテムを選択して、ドロワーで開きます。