子アイテム
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
子アイテムは、親作業アイテムの下にネストされた作業アイテムです。これにより、作業を整理し追跡するための階層が作成されます。
子アイテムは次のとおりです:
- 親エピックの下にネストされた子エピック。
- エピックに割り当てられた機能やバグなどのイシュー。
- イシューの子アイテムになり得るタスク。
Parent epic
|─ Child epic
|─ Issue
|- Task
|─ Issue
|- Task
|─ Issue子アイテムを使用して、いくつかの計画および調整の課題を解決できます。
次の例は、子アイテムがチームの効果的な協業をどのように支援するかを示しています。
親作業アイテムに割り当てられているすべての子アイテムを表示
子アイテムセクションでは、エピックに割り当てられたエピック、イシュー、タスクを表示できます。
子孫アイテムによって継承されるエピック、イシュー、タスクも表示できます。
アクセスできるエピック、イシュー、タスクのみがリストに表示されます。
エピックに割り当てられたイシューがグループの子アイテムプロジェクトにある場合、それらを表示できます。これは、プロジェクトの表示レベル設定が、その親グループと同じか、より制限が緩い必要があるためです。
作業アイテムの進捗を追跡する
異なる基準を使用して作業アイテムの進捗を追跡することができます。
エピック内のイシューの数とウェイトを表示する
エピックの子アイテムセクションヘッダーには、子孫の作業アイテムの数とその合計ウェイトが表示されます。タスクのウェイトは、合計イシューのウェイトに含まれます。
オープンおよびクローズされた作業アイテムの数を確認するには、セクションヘッダーまたは各エピック名の下で合計数にカーソルを合わせると表示されます。
この数値は、表示権限がない可能性のあるものを含め、エピックに関連付けられているすべての子アイテム作業アイテムを反映しています。
エピックの進捗状況を表示する
エピックの子アイテムセクションヘッダーには、エピックの進捗率が表示されます。
子アイテムの完了したウェイトと合計ウェイトを確認するには、セクションヘッダーでパーセンテージにカーソルを合わせると表示されます。
タスクは、子アイテムイシューのパーセンテージの一部として進捗率に含まれます。
ウェイトと進捗状況は、表示する権限がないイシューを含め、エピックに関連付けられているすべてのイシューを表しています。
子アイテムを追加
次のことができます:
- 既存の作業アイテムを子アイテムとして追加します。これには、異なるグループ階層のプロジェクトにある作業アイテムも含まれます。
- 子アイテムとして自動的に追加される新しい作業アイテムを作成します。
エピックにイシューを追加する
既存のイシューをエピックに追加するか、エピックに自動的に追加される新しいイシューを作成します。
直接の子イシューと子エピックの最大数は5,000です。
エピックに既存のイシューを追加する
別のグループ階層のプロジェクトのイシューを含め、既存のイシューをエピックに追加できます。
新しく追加されたイシューは、子アイテムセクションのイシューリストの一番上に表示されます。
エピックにはイシューのリストが含まれており、イシューは最大で1つのエピックの子アイテムとして設定できます。すでにエピックにリンクされている新しいイシューを追加すると、そのイシューは現在の親から自動的にリンク解除されます。
前提条件:
- イシューのプロジェクトとエピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
エピックに既存のイシューを追加するには:
エピックのページで、子アイテムの下の追加を選択します。
Existing issueを選択します。
次のいずれかの方法を使用して、追加するイシューを指定します:
- イシューのリンクを貼り付けます。
- イシューのタイトルの一部を入力して、一致する目的の項目を選択し、目的のイシューを検索します。別のグループ階層からのイシューは、検索結果に表示されません。そのようなイシューを追加するには、完全なURLを入力します。
追加するイシューが複数ある場合は、スペースキーを押して、この手順を繰り返します。
追加を選択します。
エピックからイシューを作成する
エピックからイシューを作成すると、作業をより小さな部分に分割しながら、エピックのより広範なコンテキストに焦点を当て続けることができます。
エピックからの新しいイシューは、エピックのグループまたはその子孫サブグループの1つにあるプロジェクトでのみ作成できます。エピックのグループと共有されているプロジェクトに新しいイシューを作成するには、最初にプロジェクトで直接イシューを作成し、次に既存のイシューをエピックに追加します。
前提条件:
- イシューのプロジェクトとエピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
エピックからイシューを作成するには:
- エピックのページで、子アイテムの下の追加を選択します。
- 新しいイシューを作成を選択します。
- タイトルの下に、新しいイシューのタイトルを入力します。
- プロジェクトドロップダウンリストから、イシューを作成するプロジェクトを選択します。
- イシューを作成するを選択します。
新しいイシューがエピックに割り当てられます。
子アイテムを再編成する
子アイテムの順序を変更したり、階層内で再編成したりできます。
エピックに割り当てられたイシューを並べ替える
新しいイシューは、子アイテムセクションのリストの一番上に表示されます。イシューのリストは、ドラッグして並べ替えることができます。
前提条件:
- イシューのプロジェクトとエピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
エピックに割り当てられたイシューを並べ替えるには:
- 子アイテムセクションに移動します。
- イシューを目的の順序にドラッグします。
エピック間でイシューを移動する
- プラン: Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
新しいイシューは、子アイテムタブのリストの一番上に表示されます。イシューはエピック間で移動できます。
前提条件:
- イシューのプロジェクトとエピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
イシューを別のエピックに移動するには:
- 子アイテムセクションに移動します。
- 表示されている階層で、イシューを目的の親エピックにドラッグします。
親イシューが移動されたときに子アイテムを移動する
イシューを別のプロジェクトに移動すると、そのすべての子アイテムもターゲットプロジェクトに移動され、移動されたイシューの子アイテムのままになります。各アイテムは親アイテムと同じ方法で移動されます。つまり、元のプロジェクトでクローズされ、ターゲットプロジェクトにコピーされます。
エピックからイシューを削除する
エピックの詳細ページで、エピックからイシューを削除できます。エピックからイシューを削除すると、このイシューはこのエピックとの関連付けが解除されます。
前提条件:
- イシューのプロジェクトとエピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
エピックからイシューを削除するには:
- 削除するイシューの横にある削除( )を選択します。イシューを削除警告が表示されます。
- 削除を選択します。
多階層を扱う
- プラン: Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
エピックには、複数のネストされた子エピックを含めることができます。これらの多階層子エピックは、次の方法で操作できます:
- 既存のエピックに親エピックを追加して、エピックの階層を作成します。
- 親エピックのグループとは異なるグループに属する子エピックを追加します。
- エピックの子エピックと関連するマイルストーンをロードマップで表示します。
- エピックから子エピックを追加、移動、並べ替え、削除します。
エピックには、合計7レベルまでのネストされた複数の子エピックを含めることができます。
エピックに親エピックを追加する
エピックの階層を作成するには、既存のエピックに親エピックを追加します。これにより、複数のエピックにわたる関連作業を整理して追跡できます。
前提条件:
- 親エピックのグループまたは子エピックのグループのいずれかに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
親エピックを追加するには:
- 上部のバーで、検索または移動先を選択して、グループを見つけます。
- 計画 > 作業アイテムを選択します。
- エピックを選択します。
- 右側のサイドバーの親セクションで、編集を選択します。
- 検索ボックスに、親エピックのタイトルの一部を入力します。同じグループ階層内のエピックのみを検索できます。
- 検索結果から、親として追加するエピックを選択します。
親エピックが追加されます。
他のグループからの子エピック
親エピックのグループとは異なるグループに属する子エピックを追加します。
前提条件:
- 子エピックと親エピックの両方のグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
- 子エピックと親エピックの両方のグループで、マルチレベルの子エピックを利用できる必要があります。
別のグループから子エピックを追加するには、既存のエピックを追加するときに、エピックのURLを貼り付けます。
ロードマップで子エピックを表示する
エピックから、ロードマップでその子エピックと関連するマイルストーンを表示します。
前提条件:
- 親エピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
親から子エピックを表示するには:
- 子アイテムセクションヘッダーで、表示オプション ( ) > ロードマップで表示を選択します。
エピックに子エピックを追加する
前提条件:
- 親エピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
新しいエピック
新しいエピックを子エピックとして追加するには:
- エピックの子アイテムセクションで、追加 > Add a new epicを選択します。
- ドロップダウンリストからグループを選択します。エピックのグループはデフォルトで選択されています。
- 新しいエピックのタイトルを入力します。
- エピックを作成を選択します。
既存のエピック
既存のエピックを子エピックとして追加するには:
エピックの子アイテムセクションで、追加 > Existing epicを選択します。
次のいずれかの方法で、追加するエピックを指定します:
- エピックのリンクを貼り付けます。
- エピックのタイトルの抜粋を入力して目的のエピックを検索し、目的の一致を選択します。この検索は、同じグループ階層内のエピックにのみ利用できます。
追加するエピックが複数ある場合は、Spaceキーを押してこの手順を繰り返します。
追加を選択します。
エピック間で子エピックを移動する
新しい子エピックは、子アイテムセクションのリストの一番上に表示されます。子エピックはエピック間で移動できます。すでに親エピックにリンクされている新しいエピックを追加すると、現在の親へのリンクは解除されます。イシューと子エピックを混在させることはできません。
前提条件:
- 親エピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
子エピックを別のエピックに移動するには:
- 子アイテムセクションに移動します。
- エピックを目的の親エピックにドラッグします。
エピックに割り当てられた子エピックを並べ替える
新しい子エピックは、子アイテムセクションのリストの一番上に表示されます。子エピックのリストを並べ替えることができます。
前提条件:
- 親エピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
エピックに割り当てられた子エピックを並べ替えるには:
- 子アイテムセクションに移動します。
- エピックを目的の順序にドラッグします。
親エピックから子エピックを削除する
前提条件:
- 親エピックのグループに対して、ゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。
親エピックから子エピックを削除するには:
- 親エピックのエピックのリストで削除( )を選択します。エピックを削除警告が表示されます。
- 削除を選択します。
子アイテムの表示設定を構成する
子アイテムセクションに表示される情報を構成して、ワークフローにとって最も重要なことに集中できます。
子アイテムセクションに表示される情報を構成して、ワークフローにとって最も重要なことに集中できます。
1つのエピックまたはイシューに表示される情報を変更すると、グループとプロジェクトのすべての作業アイテムで情報が変更されます。
子アイテムセクションヘッダーの右上隅で、表示オプション ( ) を選択します。
デフォルトでは、すべてのオプションとフィールドが表示されます。
表示される情報を変更するには、次の切替をオンまたはオフにします:
- 表示オプション:
- クローズアイテムを表示
- 表示フィールド:
- ステータス
- 担当者
- ラベル
- ウェイト
- マイルストーン
- イテレーション
- 日付
- 健全性
- ブロック済み/ブロック中
- 表示オプション: