イシューボード

イシューボードは、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. backend（バックエンド）チームが新しい実装に取り組み、フィードバックと承認を収集して、frontend（フロントエンド）チームに渡します。
3. フロントエンドが完了すると、新しい機能のstaging（ステージング）環境にデプロイされてTestされます。
4. 成功すると、production（本番環境）にデプロイされます。

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

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

Scrumチーム

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

クイック割り当て

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

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

イシューボードの用語

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

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

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

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

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

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

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

前提要件:

• プロジェクトのプランナーロール以上が必要です。

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

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

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

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

フォーカスモード

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

グループイシューボード

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

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（4/3）と表示されます。

  

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

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

  

例:

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

実行中の制限を設定する

前提要件:

• プロジェクトのプランナーロール以上が必要です。

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

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

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

ブロックされたイシュー

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

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

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

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

イシューを編集

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

前提要件:

• プロジェクトのプランナーロール以上が必要です。

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

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

管理者がイシュードロワーを有効にしている場合、イシューボードからイシューカードを選択すると、ドロワーにイシューが開きます。そこでは、説明、コメント、関連アイテムなど、すべてのフィールドを編集できます。

新しいリストを作成

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

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

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

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

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と入力します。