エピックを管理する

このページでは、エピックに関して、またはエピックに関連して実行できるすべての操作について説明します。

エピックの子アイテムの管理については、子アイテムを参照してください。

エピックを作成する

前提条件:

• エピックのグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

所属するグループにエピックを作成するには:

1. 新しいエピックフォームに移動します。

   • グループに移動し、左サイドバーから作業アイテムを選択します。次に、新しいアイテムを選択します。
   • グループ内のエピックから、右上隅の追加のアクション ( ) を選択します。次に、新規関連アイテムを選択します。
   • 任意の場所で、上部のメニューの新規（ ）を選択します。次に、新しい作業アイテムを選択します。
   • 空のロードマップで、新しい作業アイテムを選択します。

2. タイプドロップダウンリストから、まだ選択されていない場合はエピックを選択します。

3. フィールドに入力します。

   • タイトルを入力します。
   • 説明を入力します。
   • エピックを非公開にするには、非公開に設定の横にあるチェックボックスをオンにします。
   • ラベルを選択します。
   • 開始日と期限を選択するか、開始日と期限を継承します。
   • 色を選択します。

4. エピックを作成を選択します。

新しく作成されたエピックが開きます。

開始日と期限の継承

継承済みを選択した場合:

• 開始日の場合: GitLabは、エピックに割り当てられたすべての子エピックとイシューをスキャンし、子エピックまたは子アイテムに割り当てられたマイルストーンで最初に見つかった最も早い開始日に一致するように開始日を設定します。
• 期限の場合: GitLabは、エピックに割り当てられたすべての子エピックとイシューをスキャンし、子エピックまたは子アイテムに割り当てられたマイルストーンで見つかった最も遅い期限に一致するように期限を設定します。

これらの日付は動的であり、次のいずれかが発生した場合は再計算されます。

• 子エピックの日付が変更される。
• マイルストーンがイシューに再割り当てされる。
• マイルストーンの日付が変更される。
• イシューがエピックに追加またはエピックから削除される。

エピックの日付は子から日付を継承できるため、開始日と期限は下から上に伝播します。最下位の子エピックの開始日が変更された場合、それが親エピックの最も早い開始日の候補になります。次に、親エピックの開始日はこの変更を反映し、最上位のエピックに上方伝播します。

エピックを編集する

エピックを作成した後、次の詳細を編集できます。

• タイトル
• 説明
• 開始日
• 期限
• ラベル
• マイルストーン
• 色

前提条件:

• エピックのグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

エピックのタイトルまたは説明を編集するには:

1. 編集を選択します。
2. 変更を加えます。
3. 変更を保存を選択します。

エピックの開始日、期限、マイルストーン、またはラベルを編集するには、次のようにします。

1. 右側のサイドバーの各セクションの横にある編集を選択します。
2. エピックの日付、マイルストーン、またはラベルを選択します。

エピックの説明にあるリスト項目を並べ替える

説明にリストがあるエピックを表示するときに、リスト項目を並べ替えることもできます。

前提条件:

• プロジェクトのプランナー、レポーター、デベロッパー、メンテナー、またはオーナーロール、あるいはエピックの作成者であるか、エピックに割り当てられている必要があります。
• エピックの説明には、順序付き、順序なし、またはタスクリストが必要です。

エピックを表示するときにリスト項目を並べ替えるには:

1. リスト項目の行にカーソルを合わせ、グリップアイコン（ ）を表示します。
2. グリップアイコンを選択して保持します。
3. 行をリストの新しい位置にドラッグします。
4. グリップアイコンをリリースします。

エピックを一括で編集する

前提条件:

• 親エピックのグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

複数のエピックを同時に更新するには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
2. Plan > 作業アイテムを選択し、タイプ = エピックでフィルターします。
3. 一括編集を選択します。右側に、編集可能なフィールドを含むサイドバーが表示されます。
4. 編集する各エピックの横にあるチェックボックスをオンにします。
5. サイドバーから、利用可能なフィールドを編集します。
6. 選択済みアイテムを更新するを選択します。

グループ内でエピックを一括編集する場合、次の属性を編集できます:

• 状態（オープンまたは完了）
• Assignees
• ラベル
• ヘルスステータス
• 通知サブスクリプション
• 機密性
• マイルストーン
• 親

続きを読むで説明が省略されるのを防ぐ

エピックの説明が長い場合、GitLabはその一部のみを表示します。説明全体を表示するには、続きを読むを選択する必要があります。この切り詰める機能により、長文をスクロールせずに、ページ上の他の要素を簡単に見つけることができます。

説明を切り詰めるかどうかを変更するには:

1. エピックの右上隅にあるその他のアクション（ ）を選択します。
2. 好みに応じて説明を折りたたむを切り替えます。

この設定は記憶され、すべてのイシュー、タスク、エピック、目標、および主な成果に影響します。

右側のサイドバーを非表示にする

スペースがある場合、エピックの属性は説明の右側のサイドバーに表示されます。

サイドバーを非表示にして、説明のスペースを増やすには:

1. エピックの右上隅にあるその他のアクション（ ）を選択します。
2. サイドバーを非表示にするを選択します。

この設定は記憶され、すべてのイシュー、タスク、エピック、目標、および主な成果に影響します。

サイドバーを再度表示するには:

• 上記の手順を繰り返し、サイドバーを表示するを選択します。

担当者

1つまたは複数のユーザーにエピックを割り当てることができます。

担当者は必要に応じて何度でも変更できます。担当者はエピックの責任者であるという考え方です。

ユーザーがグループのメンバーでない場合、別のグループメンバーがエピックを割り当てる場合のみ、エピックをそのユーザーに割り当てることができます。

エピックの担当者を変更する

前提条件:

• グループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持っている必要があります。

エピックの担当者を変更するには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
2. Plan > 作業アイテムを選択し、タイプ = エピックでフィルターします。
3. エピックを選択して表示します。
4. 右サイドバーの担当者セクションで、編集を選択します。
5. ドロップダウンリストから、担当者として追加するユーザーを選択します。
6. ドロップダウンリストの外側の領域を選択します。

担当者は、ページを更新しなくても変更されます。

エピックの色

エピックの色を設定して、タスクを視覚的に分類および優先順位付けできます。色を使用して以下を行います:

• エピックをチームまたは会社のイニシアチブに関連付ける。
• エピック階層のレベルを示す。
• 関連するエピックをグループにまとめる。

エピックの色は、ロードマップとエピックボードに表示されます。

ロードマップでは、タイムラインバーはエピックの色と一致します。

エピックボードでは、色はエピックのカードアクセントに表示されます:

エピックの色を変更する

前提条件:

• エピックのグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

エピックの色を変更するには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
2. Plan > 作業アイテムを選択し、タイプ = エピックでフィルターします。
3. エピックを選択します。
4. 右サイドバーの色セクションで、編集を選択します。
5. 既存の色を選択するか、RGBまたは16進数値を入力します。
6. ダイアログの外側の領域を選択します。

エピックの色が更新されます。

エピックを削除する

前提条件:

• エピックのグループに対してプランナーロールまたはオーナーロールを持っている必要があります。

エピックを削除するには:

1. 右上隅の追加のアクション ( ) を選択し、Delete epicを選択します。
2. 削除を選択します。確認ダイアログで、エピックを削除を選択します。

エピックを削除すると、システム内の関連付けられているエピックから既存のすべてのイシューが解放されます。

エピックを閉じる

前提条件:

• エピックのグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

エピックを閉じるには:

• 右上隅の追加のアクション ( ) を選択し、Close epicを選択します。

/closeクイックアクションを使用することもできます。

閉じたエピックを再開する

閉じたエピックを再開することができます。

前提条件:

• エピックのグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

これを行うには、次のいずれかを実行します。

• 右上隅の追加のアクション ( ) を選択し、Reopen epicします。
• /reopenクイックアクションを使用します。

イシューをプロモートしてエピックを作成することもできます。

イシューからエピックに移動する

イシューがエピックに属している場合、次の方法で親エピックに移動できます:

• イシューの上部にあるパンくずリスト。
• 右サイドバーの親セクション。

エピックリストを表示する

前提条件:

• 次のいずれかのメンバーである必要があります:
  • グループ
  • グループ内のプロジェクト
  • グループのサブグループのいずれかのプロジェクト

グループ内のエピックを表示するには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
2. Plan > 作業アイテムを選択し、タイプ = エピックでフィルターします。

エピックリストでエピックに表示される属性を設定するには、表示設定を構成します。

エピックを表示できるユーザー

エピックを表示できるかどうかは、グループの表示レベルとエピックの公開設定によって異なります:

• 公開グループと機密ではないエピック: 誰でもエピックを表示できます。
• プライベートグループと機密ではないエピック: グループに対してゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールを持つか、グループまたはそのサブグループのいずれかのプロジェクトのメンバーである必要があります。
• 非公開のエピック（グループの表示レベルに関係なく）: グループのプランナーロール以上を持っている必要があります。

ドロワーでエピックを開く

作業アイテムページまたはエピックボードからエピックを選択すると、詳細パネルが開きます。これにより、エピックリストまたはボードのコンテキストを失うことなく、詳細を表示および編集できます。

ドロワーを使用する場合:

• リストからエピックを選択して、ドロワーで開きます。
• ドロワーが画面の右側に表示されます。
• ドロワーでエピックを直接編集できます。
• ドロワーを閉じるには、閉じるアイコン（ ）を選択するか、Escapeキーを押します。

全ページ表示でエピックを開く

全ページ表示でエピックを開くには:

• 新しいタブでエピックを開きます。作業アイテムのリストから、次のいずれかの方法で操作します:
  • エピックを右クリックして、新しいブラウザタブで開きます。
  • CommandまたはControlを押しながらエピックを選択します。
• エピックを選択し、ドロワーから次のいずれかの方法で操作します:
  • 左上隅で、イシューの参照（例：my_project#123）を選択します。
  • 右上隅で、全ページ表示 ( ) を選択します。

作業アイテムを常にフルページビューで開くには、アイテムをドロワーで開くかどうかの設定を参照してください。

エピックのリストをフィルターする

エピックのリストを次の項目でフィルターできます:

• タイトルまたは説明（検索範囲を選択）
• 作成者名/ユーザー名
• 機密性
• グループ
• 健全性
• ラベル
• マイルストーン
• リアクション絵文字
• 親
• サブスクライブ
• エピックに対してカスタムフィールドが有効

フィルタリングするには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
2. Plan > 作業アイテムを選択し、タイプ = エピックでフィルターします。
3. 必要に応じて、追加のフィルター、演算子、および値を選択します。タイトルまたは説明で検索するには、フィルターバーに入力します。
4. Enterを押すか、虫眼鏡アイコン ( ) を選択します。

OR演算子でフィルタリングする

次の項目でエピックのリストをフィルタリングするときに、OR演算子（次のいずれか: ||）を使用できます。

• 担当者
• Author
• ラベル

is one ofは、包含的ORを表します。たとえば、Label is one of DeliverableとLabel is one of UXでフィルタリングすると、GitLabはDeliverable、UX、またはその両方のラベルが付いたエピックを表示します。

エピックのリストをソートする

エピックリストは、次の順にソートすることができます:

• 作成日
• 更新日
• 終了日
• マイルストーン期日
• 期限
• 人気度
• タイトル
• 開始日
• 健全性
• ブロック中

各オプションには、順序を昇順と降順の間で切り替えることができるボタンがあります。並べ替えオプションと順序は保存され、ロードマップを含むエピックを閲覧するあらゆる場所で適用されます。

アクティビティの並べ替え順序を変更する

デフォルトの順序を逆にして、一番上に最新のアイテムが配置されたアクティビティフィードを操作できます。設定はローカルストレージに保存され、表示するすべてのエピックとイシューに自動的に適用されます。

アクティビティのソート順を変更するには、古い順ドロップダウンリストを選択し、一番古いアイテムから表示するのか、一番新しいアイテムから表示するのかを選択します。

エピックを非公開にする

個人情報を含むアイテムで作業している場合は、エピックを非公開にすることができます。

前提条件:

• エピックのグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールが必要です。

エピックを非公開にするには:

• When creating an epic: 非公開に設定の横にあるチェックボックスを選択します。
• In an existing epic: 右上隅で、その他のアクション ( ) を選択します。次に、非公開に設定を選択します。

/confidentialクイックアクションを使用することもできます。

エピックに割り当てられたイシューを管理する

このセクションでは、エピックに関連してイシューに対して実行できるすべての操作について説明します。

ヘルスステータス

エピックのヘルスステータスを使用して、プロジェクトの進捗状況をすばやく把握します。ヘルスステータスは、潜在的なイシューを事前に伝達および管理するのに役立ちます。

エピックのヘルスステータスは、エピックビュー、子アイテムセクション、リンクされたアイテムセクションで確認できます。

ヘルスステータスは次のように設定できます。

• 健全（緑）
• 要注意（黄）
• リスクあり（赤）

計画された作業のタイムリーなデリバリーを妨げるリスクに対処するために、エピックヘルスステータスのレビューを次の項目に組み込みます:

• 毎日のスタンドアップミーティング
• プロジェクトの状態に関するレポート
• 週次ミーティング

エピックのヘルスステータスを変更する

前提条件:

• グループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持っている必要があります。

エピックのヘルスステータスを変更するには:

1. 上部のバーで、検索または移動先を選択して、グループを見つけます。
2. Plan > 作業アイテムを選択し、タイプ = エピックでフィルターします。
3. エピックを選択します。
4. 右側のサイドバーのヘルスステータスセクションで、編集を選択します。
5. ドロップダウンリストから状態を選択します。

エピックのヘルスステータスが更新されます。

/health_statusおよび/clear_health_statusのクイックアクションを使用して、ヘルスステータスを設定およびクリアすることもできます。

参加者

参加者は、エピックとやり取りしたユーザーです。参加者の表示については、参加者を参照してください。

関連トピック

• リンクされたアイテム
• 子アイテム
• ウェイト