イシューボード

イシューボードは、GitLabでの作業を管理および追跡するための視覚的な方法を提供します。イシューボード:

• ラベル、マイルストーン、または担当者に基づいて、カスタマイズ可能なリストでイシューをカードとして表示します。
• ワークフローのさまざまな段階を通してイシューを追跡します。
• KanbanやScrumなどのアジャイル開発手法をサポートします。
• さまざまなチームやプロジェクトのために複数のボードを編成します。
• プロセス全体のワークロードと進捗状況を視覚化します。

イシューは、割り当てられたラベル 、マイルストーン 、イテレーション 、担当者 、またはステータスによって整理された縦方向のリストでイシューカードとして表示されます。

イシューにメタデータを追加し、既存のイシューに対応するリストを作成します。準備ができたら、イシューカードをあるリストから別のリストにドラッグできます。

イシューボードは、KanbanやScrumなどの一般的なフレームワークを強化できます。

チームメンバーが独自のワークフローを編成できるようにするには、複数のイシューボードを使用します。これにより、同じプロジェクト内で複数のイシューボードを作成できます。

イシューボードのさまざまな機能は、さまざまなGitLabプランで利用できます:

イシューボードのGitLab Enterpriseの機能の詳細をご覧ください。

イシューボード機能の動画プレゼンテーションをご覧ください。

複数のイシューボード

複数のイシューボードを使用すると、次の複数のイシューボードを使用できます:

• 全プランのプロジェクト
• PremiumおよびUltimateプランのグループ

複数のイシューボードは、リポジトリが複数の製品のコードをホストしている複数のチームがいる大規模なプロジェクトや、ソフトウェア開発ライフサイクル全体でさまざまなワークフローを強化するボードを作成する場合に最適です。

メニューの上部にある検索ボックスを使用して、リストされたボードをフィルタリングできます。

10個以上のボードが利用可能な場合、メニューには最近セクションも表示され、最後にアクセスした4つのボードへのショートカットが表示されます。

複数のボードがあるプロジェクトまたはグループでイシューボードに再度アクセスすると、GitLabは最後にアクセスしたボードを自動的に読み込みます。

イシューボードを作成する

前提条件:

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

新しいイシューボードを作成するには:

1. イシューボードページの上部左隅にあるドロップダウンリストで、現在のボード名を選択します。
2. 新しいボードを作成を選択します。
3. 新しいボードの名前を入力し、そのスコープ（マイルストーン、イテレーション、ラベル、担当者、またはウェイト）を選択します。
4. ボードを作成を選択します

イシューボードを削除する

前提条件:

• ボードが保存されているプロジェクトまたはグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールが必要です。

開いているイシューボードを削除するには:

1. イシューボードページの右上隅で、ボードを設定（ ）を選択します。
2. ボードを削除を選択します。
3. 削除を選択して確定します。

削除したボードが最後のボードだった場合は、新しいDevelopmentボードが作成されます。

イシューボードのユースケース

GitLabイシューボードを、独自の推奨ワークフローに合わせて調整できます。ワークフローベースのドキュメントについては、作業の計画と追跡チュートリアルを参照してください。

単一のイシューボードのユースケース

GitLab Flowを使用すると、イシューで提案について話し合い、ラベル付けし、イシューボードで整理および優先順位を付けることができます。

たとえば、次の簡略化された開発ワークフローについて考えてみましょう:

1. アプリケーションのコードベースをホストするリポジトリがあり、チームは積極的にコードをコントリビュートしています。
2. バックエンドチームが新しい実装に取り組み、フィードバックと承認を収集して、フロントエンドチームに渡します。
3. フロントエンドが完了すると、新しい機能のステージング環境にデプロイされてTestされます。
4. 成功すると、本番環境にデプロイされます。

バックエンド、フロントエンド、ステージング、および本番環境のラベルがあり、それぞれにリストを含むイシューボードがある場合は、次のことができます:

• 開発ライフサイクルの最初から本番環境へのデプロイまで、実装全体のフローを視覚化します。
• イシューを縦に移動して、リスト内のイシューの優先順位を付けます。
• リスト間でイシューを移動して、設定したラベルに従って整理します。
• 既存のイシューを1つ以上選択して、ボード内のリストに複数のイシューを追加します。

Scrumチーム

Scrumチームでは、各Scrumチームが独自のボードを持つように、複数のイシューボードを使用します。Scrumボードでは、プロセスの各部分を通してイシューを移動できます。例: To Do、実行中、および完了。

クイック割り当て

チームメンバーにイシューをすばやく割り当てるには:

1. チームメンバーごとに担当者リストを作成します。
2. チームメンバーのリストにイシューをドラッグします。

イシューボードの用語

イシューボードは、イシューの一意のビューを表します。複数のリストを持つことができ、各リストはカードで表されるイシューで構成されています。

リストは、特定の属性に一致するイシューを表示するイシューボードの列です。デフォルトの「オープン」リストと「クローズ」リストに加えて、追加の各リストには、選択したラベル、担当者、またはマイルストーンに一致するイシューが表示されます。各リストの上部には、それに属するイシューの数が表示されます。リストのタイプには次のものがあります:

• オープン（デフォルト）: 他のリストのいずれにも属していない、オープン状態のすべてのイシュー。常に左端のリストとして表示されます。
• クローズ（デフォルト）: クローズ状態のすべてのイシュー。常に右端のリストとして表示されます。
• ラベルリスト: ラベルのすべてのオープン状態のイシュー。
• 担当者リスト: ユーザーに割り当てられたすべてのオープン状態のイシュー。
• マイルストーンリスト: マイルストーンのすべてのオープン状態のイシュー。
• イテレーションリスト: イテレーションのすべてのオープン状態のイシュー。
• Status list: すべてのイシューにステータスがあります。

カードはリスト上のボックスであり、イシューを表します。カードをあるリストから別のリストにドラッグして、ラベル、担当者、またはマイルストーンを変更できます。カードに表示できる情報には、以下が含まれます。

• イシューのタイトル
• 関連付けられたラベル
• イシュー番号
• 担当者
• ウェイト
• マイルストーン
• イテレーション（PremiumおよびUltimateプラン）
• 期限
• タイムトラッキングの見積もり
• ヘルスステータス

スイムレーンは、たとえば親エピックごとなど、イシューボード上のイシューの水平方向のグループ化です。

リストのイシューをオーダー

前提条件:

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

イシューが作成されると、システムは、そのイシューのプロジェクトまたはトップレベルグループの最大値よりも大きい相対的な順序の値を割り当てます。これは、イシューが表示されるイシューリストの一番下にイシューがあることを意味します。

ボードにアクセスすると、イシューはリストに順序付けられて表示されます。イシューをドラッグしてその順序を変更できます。変更された順序は保存されるため、後で同じボードにアクセスするすべての人が、いくつかの例外を除いて、並べ替えられた順序を確認できます。

イシューをドラッグして順序を変更するたびに、それに応じて相対的な順序の値が変更されます。次に、そのイシューがボードに表示されるたびに、更新された相対的な順序の値に従って順序付けが行われます。GitLabインスタンス内のユーザーがイシューAをイシューBの上にドラッグすると、これら2つのイシューが同じインスタンス内のボードに後で読み込まれる場合、順序が維持されます。たとえば、これは別のプロジェクトボードまたは別のグループボードである可能性があります。

この順序はイシューリストにも影響します。イシューボードの順序を変更すると、イシューリストの順序が変更され、その逆も同様です。

フォーカスモード

フォーカスモードでは、ナビゲーションUIが非表示になり、ボード内のイシューに集中できます。フォーカスモードを有効または無効にするには、右上隅にあるフォーカスモードの切替（ ）を選択します。

グループイシューボード

グループナビゲーションレベルでアクセスできるグループイシューボードは、プロジェクトレベルのボードと同じ機能を提供します。グループとその子孫サブグループに属するすべてのプロジェクトからのイシューを表示できます。

GitLab Freeのユーザーは、単一のグループイシューボードを使用できます。

イシューボードのGitLab Enterpriseの機能

GitLabイシューボードはGitLab Freeプランで利用できますが、高度な機能の一部はより上位のプランのみに存在します。

構成可能なイシューボード

イシューボードは、マイルストーン、ラベル、担当者、ウェイト、および現在のイテレーションに関連付けることができ、ボードのイシューを自動的にフィルタリングします。これにより、チームのニーズに応じて独自のボードを作成できます。

ボードのスコープは、作成時またはボードを設定（ ）ボタンを選択して定義できます。マイルストーン、イテレーション、担当者、またはウェイトがイシューボードに割り当てられた後、検索ボックスでこれらを通してフィルタリングすることはできなくなります。それを行うには、イシューボードから目的のスコープ（たとえば、マイルストーン、担当者、またはウェイト）を削除する必要があります。

ボードの編集権限がない場合でも、ボードの設定（ ）を選択して設定を確認できます。

担当者リスト

選択したラベルのすべてのイシューを表示する通常のリストと同様に、ユーザーに割り当てられたすべてのイシューを表示する担当者リストを追加できます。ラベルリストと担当者リストの両方を持つボードを持つことができます。

前提条件:

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

担当者リストを追加するには:

1. 新しいリストを選択します。
2. 担当者を選択します。
3. ドロップダウンリストで、ユーザーを選択します。
4. ボードに追加を選択します。

担当者リストが追加されたので、担当者リストとの間でイシューを移動して、そのユーザーにイシューを割り当てるか、割り当てを解除できます。担当者リストを削除するには、ラベルリストと同様に、ゴミ箱アイコンを選択します。

マイルストーンリスト

割り当てられたマイルストーンでイシューをフィルタリングするマイルストーンリストを作成して、イシューボードでより自由度を高め、表示レベルを高めることができます。

前提条件:

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

マイルストーンリストを追加するには:

1. 新しいリストを選択します。
2. マイルストーンを選択します。
3. ドロップダウンリストで、マイルストーンを選択します。
4. ボードに追加を選択します。

イシューのマイルストーンを変更するには、イシューカードをマイルストーンリストとの間でドラッグします。

イテレーションリスト

イテレーションでイシューのリストを作成できます。

前提条件:

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

イテレーションリストを追加するには:

1. 新しいリストを選択します。
2. イテレーションを選択します。
3. ドロップダウンリストで、イテレーションを選択します。
4. ボードに追加を選択します。

イシューのイテレーションを変更するには、イシューカードをイテレーションリストとの間でドラッグします。

ステータスリスト

特定のステータスを持つイシューのリストを作成します。ステータスリストは、進行中や完了など、ワークフローステージごとにイシューを整理するのに役立ちます。

詳細については、ステータスセクションを参照してください。

ステータスリストは、他のリストタイプとは異なる動作をします:

• Status lists: ステータスがオープンステータスまたはクローズステータスにマップされているかどうかに応じて、オープンイシューとクローズイシューの両方を含めることができます。
• Other lists（担当者やマイルストーンなど）: 常にオープンなイシューのみを表示します。

前提条件:

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

ステータスリストを追加するには:

1. 新しいリストを選択します。
2. ステータスを選択します。
3. ドロップダウンリストからステータスを選択します。
4. ボードに追加を選択します。

ステータスリストがボードに追加され、そのステータスのイシューが表示されます。

イシューのステータスを変更するには、イシューカードをステータスリストとの間でドラッグします。

スイムレーンでイシューをグループ化する

スイムレーンを使用すると、エピックでグループ化されたイシューを視覚化できます。イシューボードは他のすべての機能を保持しますが、イシューの視覚的な構成が異なります。この機能は、projectレベルとgroupレベルの両方で使用できます。

前提条件:

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

イシューボードでイシューをエピック別にグループ化するには:

1. 表示オプション（ ）を選択します。
2. エピックのスイムレーンを選択します。

この表示のままイシューを編集したり、ドラッグして位置やエピックの割り当てを変更したりできます:

• イシューを並べ替えるには、リスト内の新しい位置までドラッグします。
• イシューを別のエピックに割り当てるには、そのエピックの水平レーンにドラッグします。
• エピックからイシューを削除するには、エピックが割り当てられていないイシューレーンにドラッグします。
• イシューを別のエピックと別のリストに同時に移動するには、イシューを斜めにドラッグします。

イシューのウェイトの合計

各リストの上部には、そのリストに属するイシューのウェイトの合計が表示されます。これは、特に担当者リストと組み合わせて、キャパシティの割り当てにボードを使用する場合に便利です。

実行の制限

イシューボードの各イシューリストに、実行の制限（WIP）を設定できます。制限が設定されると、現在の状態と設定された制限がボードリストのヘッダーに表示されます。

リスト内の線は、制限内の項目と制限を超える項目を区切ります。デフォルトのリスト（オープンおよびクローズ）には、実行の制限を設定できません。

制限の種類

GitLabは、次の2種類の実行の制限をサポートしています。

• アイテム: ウェイトに関係なく、リスト内のイシューの数を制限します。ボードのヘッダーには、リスト内のイシューの数とアイテムの制限が表示されます。

  たとえば、イシューが4つあり、アイテムの制限が3つある場合、ヘッダーには4/3と表示されます。

  

• ウェイト: リスト内のイシューの合計ウェイトを制限します。ボードのヘッダーには、リスト内のイシューの合計ウェイトとウェイト制限が表示されます。

  たとえば、イシューのウェイトの合計が8になり、ウェイト制限が5つある場合、ヘッダーには8/5と表示されます。

  

例:

• リストに4つのイシューがあり、アイテム制限が5つある場合、ヘッダーには4/5と表示されます。制限を超えると、現在のイシュー数が赤で表示されます。
• アイテム制限が5つのイシューが5つあるリストがあるとします。別のイシューをそのリストに移動すると、リストのヘッダーには6/5と表示され、6は赤で表示されます。実行中の制限の線は、6番目のイシューの前に表示されます。
• ウェイト制限を使用する場合、ウェイトがそれぞれ1、2、5（合計ウェイトは8）のイシューが3つあり、ウェイト制限が5の場合、ヘッダーには8/5（8は赤色）と表示されます。実行中の制限の線は、結合されたウェイトが制限内にあるイシューの後に表示され、制限を超えるイシューから分離されます。

実行中の制限を設定する

前提条件:

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

リストの実行の制限を設定するには、イシューボードで次の手順を実行します。

1. 編集するリストの上部にあるリスト設定の編集（ ）を選択します。リスト設定サイドバーが右側に開きます。
2. 実行中の制限の横にある編集を選択します。
3. ドロップダウンリストから制限の種類を選択します。
   • アイテム: イシューの数で制限する場合。
   • ウェイト: イシューの合計ウェイトで制限する場合。
4. アイテムの最大数または最大ウェイトを入力します。
5. Enterを押して保存します。

実行の制限を削除するには、制限の解除を選択します。

ブロックされたイシュー

イシューが別のイシューによってブロックされている場合、ブロックされている状態を示すアイコンがタイトルの横に表示されます。

ブロックされたアイコン（ ）の上にカーソルを合わせると、詳細な情報のポップオーバーが表示されます。

イシューボードで実行できるアクション

• イシューを編集。
• 新しいリストを作成。
• 既存のリストを削除。
• リストからイシューを削除。
• イシューボード全体に表示されるイシューをフィルタリングします。
• イシューとリストを移動。
• リストをドラッグして並べ替えます。
• （リスト間でイシューをドラッグして）イシューラベルを変更します。
• （イシューをクローズリストにドラッグして）イシューをクローズします。

イシューを編集

ボード表示のままイシューを編集できます。右側のサイドバーを開くには、イシューカード（タイトルではなく）を選択します。

前提条件:

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

右側のサイドバーで、次のイシュー属性を編集できます:

• 担当者
• 機密性
• 期限
• エピック
• ヘルスステータス
• イテレーション
• ラベル
• マイルストーン
• 通知の設定
• タイトル
• ウェイト
• タイムトラッキング

イシューボードからイシューカードを選択すると、イシューが詳細パネルで開きます。そこでは、説明、コメント、関連アイテムなど、すべてのフィールドを編集できます。

新しいリストを作成

2つの既存のリストの間、またはイシューボードの右側に新しいリストを作成できます。

2つのリストの間に新しいリストを作成するには:

1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。

2. 計画 > イシューボードを選択します。

3. 2つのリストの間で、カーソルを合わせるか、キーボードのフォーカスを移動します。

4. 新しいリストを選択します。新しいリストパネルが開きます。

   

5. 新しいリストのデフォルトにするラベル、ユーザー、マイルストーン、イテレーション、またはステータスを選択します。

6. ボードに追加を選択します。

新しいリストは、新しいリストパネルと同じ位置にボードに挿入されます。

リストを移動して並べ替えるには、それらをドラッグして移動します。

または、ボードの右端にある新しいリストを選択することもできます。新しいリストは、リストの右端のクローズの前に挿入されます。

リストを削除

リストの削除は、削除されるのはリストビューだけなので、イシューやラベルには影響しません。必要に応じて、いつでも後で再作成できます。

前提条件:

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

イシューボードからリストを削除するには:

1. 削除するリストの上部にあるリスト設定の編集（ ）を選択します。リスト設定サイドバーが右側に開きます。
2. リストを削除を選択します。
3. 確認ダイアログで、もう一度リストを削除を選択します。

リストにイシューを追加

前提条件:

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

ボードが1つまたは複数の属性にスコープされている場合は、追加するイシューに移動し、ボードのスコープと同じ属性を適用します。

たとえば、グループイシューボードで、Doingラベルにスコープされたリストにイシューを追加するには:

1. グループまたはいずれかのサブグループまたはプロジェクトのイシューに移動します。
2. Doingラベルを追加します。

これで、イシューがイシューボードのDoingリストに表示されるはずです。

リストからイシューを削除

イシューがリストに属さなくなった場合は、削除できます。

前提条件:

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

手順は、リストのスコープによって異なります:

1. 右側のサイドバーを開くには、イシューカードを選択します。
2. イシューをリストに保持しているものを削除します。ラベルリストの場合は、ラベルを削除します。担当者リストの場合は、ユーザーの割り当てを解除します。

イシューをフィルタリングする

イシューボードの上部にあるフィルターを使用して、必要な結果のみを表示できます。これは、イシュートラッカーで使用されているフィルタリングに似ています。

前提条件:

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

以下でフィルタリングできます:

• 担当者
• 作成者
• エピック
• イテレーション
• ラベル
• マイルストーン
• 自分のリアクション
• リリース
• タイプ（イシュー/インシデント）
• ウェイト
• ステータス

グループボードでイシューをフィルタリング

グループボードでイシューをフィルタリングする場合は、次の動作に注意してください:

• マイルストーン: グループとその子孫グループに属するマイルストーンでフィルタリングできます。
• ラベル: グループに属するラベルでのみフィルタリングできますが、その子孫グループはフィルタリングできません。

右側のサイドバーを使用してイシューを個別に編集する場合は、イシューのプロジェクトからマイルストーンとラベルをさらに選択できます。

イシューとリストを移動

イシューとリストは、ドラッグして移動できます。

前提条件:

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

イシューを移動するには、イシューカードを選択し、現在のリスト内の別の位置、または別のリストにドラッグします。リスト間のイシューのドラッグによる起こりうる影響について学びます。

リストを移動するには、上部のバーを選択し、水平方向にドラッグします。オープンリストとクローズリストは移動できませんが、イシューボードの編集中に非表示にすることはできます。

リストの先頭にイシューを移動

メニューショートカットを使用して、イシューをリストの一番上に移動できます。

別のイシューがフィルターで非表示になっている場合でも、イシューはリストの一番上に移動されます。

前提条件:

• プロジェクトのプランナーロール以上を持っている必要があります。

リストの先頭にイシューを移動するには:

1. イシューボードで、移動するイシューのカードの上にカーソルを合わせます。
2. カードオプション（ ）を選択し、次にリストの先頭に移動を選択します。

イシューをリストの最後に移動

メニューショートカットを使用して、イシューをリストの一番下に移動できます。

別のイシューがフィルターで非表示になっている場合でも、イシューはリストの一番下に移動されます。

前提条件:

• プロジェクトのプランナーロール以上を持っている必要があります。

リストの最後にイシューを移動するには:

1. イシューボードで、移動するイシューのカードの上にカーソルを合わせます。
2. カードオプション（ ）を選択し、次にリストの最後に移動を選択します。

リスト間でイシューをドラッグ

イシューを別のリストに移動するには、イシューカードを選択してそのリストにドラッグします。

リスト間でイシューをドラッグすると、その結果はソースリストとターゲットリストによって異なります。

ヒント

覚えておくべきことがいくつかあります。

• リスト間でイシューを移動すると、移動元のリストからラベルが削除され、移動先のリストからラベルが追加されます。
• イシューに複数のラベルがある場合、複数のリストに存在できます。
• イシューにラベルが付けられている場合、リストにはイシューが自動的に入力されます。
• カード内のイシュータイトルを選択すると、そのイシューに移動します。
• カード内のラベルを選択すると、イシューボード全体がすばやくフィルタリングされ、そのラベルを持つすべてのリストからのイシューのみが表示されます。
• イシューがステータスリストからオープンリストに移動されると、デフォルトのオープンステータスが適用されます。同様に、クローズリストに移動されると、デフォルトのクローズステータスが適用されます。
• パフォーマンスと表示レベルの理由から、各リストにはデフォルトで最初の20件のイシューが表示されます。20件を超えるイシューがある場合は、下にスクロールを開始すると、次の20件が表示されます。

イシューボードのトラブルシューティング

作成者または担当者でフィルタリングするときのグループイシューボードのThere was a problem fetching users

グループイシューボードで作成者または担当者でフィルタリングするときに、There was a problem fetching usersエラーのバナーが表示される場合は、現在のグループのメンバーとして追加されていることを確認してください。メンバー以外のユーザーには、イシューボードで作成者または担当者でフィルタリングするときにグループメンバーを一覧表示する権限がありません。

このエラーを修正するには、すべてのユーザーをゲスト、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーロールを持つトップレベルグループに追加する必要があります。

Railsコンソールを使用して、読み込みに失敗してタイムアウトになるイシューボードを修正する

UIでイシューボードが読み込まれず、タイムアウトする場合は、Railsコンソールを使用してイシュー再分散サービスを呼び出して修正します:

1. Railsコンソールセッションを開始します。

2. 次のコマンドを実行します:

   p = Project.find_by_full_path('<username-or-group>/<project-name>')
   
   Issues::RelativePositionRebalancingService.new(p.root_namespace.all_projects).execute

3. Railsコンソールを終了するには、quitと入力します。