組織内の問題フィールドの管理

メモ

問題フィールドは現在パブリックプレビューにあり、変更される可能性があります。フィードバックを共有するには、コミュニティのディスカッションを参照してください。

問題フィールドを使用すると、組織全体の問題に構造化メタデータを追加できます。ラベルや自由形式の回避策に依存する代わりに、優先順位、作業、影響、チームが必要とするカスタムカテゴリなどのフィールドを作成できます。フィールドは組織レベルで定義され、組織内のすべてのリポジトリに適用されます。

問題フィールドの種類について

組織ごとに最大 25 個の問題フィールドを作成できます。次のフィールドの種類を使用できます。

単一選択: 定義済みの一覧から 1 つのオプションを選択します。オプションには、名前、説明、色を指定できます。
テキスト: 自由形式のテキストをキャプチャします。 URL は自動的に検出され、クリック可能なリンクとして表示されます。
数値: 小数点を含む数値入力を受け入れます。
日付: 日付を選択するための日付ピッカーを指定します。

既定のフィールド

組織で問題フィールドが有効になっている場合、次の 4 つの既定のフィールドが自動的に作成されます。

優先度 (単一選択): 緊急、高、中、低
作業量 (単一選択): 高、中、低
開始日 (日付)
ターゲット日付 (日付)

これらの既定のフィールドは、次のように問題の種類にピン留めされています。

フィールド	型なし	Bug	Task	特徴
優先度
努力
開始日
ターゲットの日付

これらの既定のフィールドは完全にカスタマイズ可能です。名前、説明、オプションを編集したり、ワークフローに合わない場合は削除したりできます。

ヒント

チームのワークフローに合わせて、オプションの名前変更、色の変更、並べ替え、新しい値の追加を行うことができます。たとえば、作業量オプションを T シャツサイズ (XS、S、M、L、XL) に変更できます。

問題フィールドの作成

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。
組織をクリックして選択します。
Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
[新しいフィールド] をクリックします。
[フィールド名] に、新しいフィールドの名前を入力します。
必要に応じて、[説明] に説明を入力して、他のユーザーがフィールドの目的を理解できるようにします。
[フィールドの種類] で、作成するフィールドの種類を選択します。
[単一選択] を選択した場合は、フィールドのオプションを追加します。
- [ オプションの追加] をクリックし、オプション名を入力します。
- 必要に応じて、オプションの色を設定するには、オプションの横にある [ ] をクリックし、[ 編集] オプションをクリックして色を選択し、[保存] をクリック します。
- この手順を繰り返して、さらにオプションを追加します。
[フィールドの表示設定] で、次のいずれかを選択します。
- 権限: フィールドとその値を表示できるユーザーを選択します。オプションは 組織のみ (既定) または パブリックです。この設定は、パブリックリポジトリの問題にのみ適用されます。
- 種類にピン留めする: をクリックして、問題ビューアーと作成者にこのフィールドを表示する問題の種類を選択します。 1 つ以上の問題の種類、または "種類のない問題" を選択します。固定されておらず、値がないフィールドは、問題ビューアーと作成者に表示されなくなります。
Create をクリックしてください。

問題フィールドの編集

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。
組織をクリックして選択します。
Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
編集するフィールドの右側にある [ ] をクリックします。
[ 編集] をクリックし、変更を加えます。
保存フィールドをクリックします。

問題フィールドの削除

問題フィールドを削除すると、そのフィールドの問題に設定されたすべての値が完全に削除されます。

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。
組織をクリックして選択します。
Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
削除するフィールドの右側にある [ ] をクリックします。
[ 削除 ] をクリックし、削除を確認します。

ヒント

問題フィールドを使用しない場合は、組織の設定からすべての既定のフィールドを削除できます。これにより、それらはあなたの組織内のすべてのIssueから削除されます。フィールドはいつでも再作成できます。

問題フィールドの並べ替え

ピン留めされたフィールドの順序は、問題の種類ごとに管理されます。フィールドの順序によって、問題サイドバーと問題作成モーダルでのフィールドの表示方法が決まります。

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。
組織をクリックして選択します。
Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの[計画]セクションで、[ 問題の種類]をクリックします。
フィールドの順序を変更する問題の種類をクリックします。
[ピン留めされた問題フィールド] で、フィールドをドラッグして順序を変更します。
[保存] をクリックします。

問題の種類にフィールドをピン留めする

問題フィールドを特定の問題の種類に関連付けると、その種類の問題を作成または表示するときに最も関連性の高いフィールドのみが表示されます。たとえば、"重大度" をバグにピン留めし、"影響" を機能にピン留めできます。

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。
組織をクリックして選択します。
Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
ピン留めするフィールドをクリックします。
[種類にピン留めする] で、[ ] をクリックし、このフィールドに表示する問題の種類を選択します。
保存フィールドをクリックします。

ピン留めされたフィールドは、選択した問題の種類に基づいて問題のサイドバーに自動的に表示されます。フィールドを型のない問題にピン留めするには、[種類のない問題] オプションを選択します。

メモ

問題のサイドバーに表示するには、フィールドを少なくとも 1 つの問題の種類または "種類のない問題" にピン留めする必要があります。どの型にもピン留めされていないフィールドには、[ フィールドの追加 ] ボタンまたはプロジェクトでのみアクセスできます。

問題にフィールドが表示されない場合は、関連する問題の種類または "種類のない問題" にピン留めされていることを確認します。固定されておらず、値が設定されていないフィールドは、問題のサイドバーから非表示になります。

フィールドの表示設定

パブリックリポジトリを持つ組織の場合、各問題フィールドをすべてのユーザーに表示するか、組織のメンバーとコラボレーターにのみ表示するかを制御できます。

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。
組織をクリックして選択します。
Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウンメニューを選び、 [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
フィールドの右側にある [ ] をクリックします。
編集をクリックします。
[フィールドの表示設定] で、次のいずれかを選択します。
- 組織のみ: このフィールドは、少なくとも読み取りアクセス権を持つ組織のメンバーとリポジトリコラボレーターにのみ表示されます。
- パブリック: このフィールドは、問題を表示するすべてのユーザーに表示されます。
[保存] をクリックします。

既定では、すべての新規および既存のフィールドは "組織のみ" に設定されます。可視性の設定は、Web UI、API、発行タイムラインイベント、検索候補全体に適用されます。

課題フィールドとプロジェクト

問題フィールドは、パブリックプロジェクトや内部プロジェクトを含め、組織全体のすべてのプロジェクトで使用できます。プロジェクトの問題フィールドの追加、削除、編集の詳細については、プロジェクトの問題フィールドについてを参照してください。

パブリックプロジェクトと内部プロジェクトの可視性

パブリックプロジェクトと内部プロジェクトでは、 パブリック 可視性を持つフィールドのみを使用できます。 [組織のみ] に設定されたフィールドは表示されません。パブリックプロジェクトにフィールドを追加すると、[フィールドの追加] ダイアログボックスに表示されるのはパブリック可視性フィールドだけです。

パブリックプロジェクトで使用中にフィールドの可視性が "パブリック" から "組織のみ" に変更された場合、フィールドはプロジェクトから自動的に削除されます。復元するには、フィールドの可視性を "Public" に戻します。

プロジェクトフィールドから発行フィールドへの移行

優先度や作業などのメタデータにプロジェクトレベルのカスタムフィールドを既に使用している場合は、問題フィールドを採用して、問題レベルでそれらの値を一元化できます。

問題フィールドは真実の源です。この値は問題に基づいて存在し、問題が属するすべてのプロジェクトで一貫しています。
プロジェクトフィールドは単一のプロジェクトに限定されます。同じ問題は、異なるプロジェクトで異なるプロジェクトフィールド値を持つことができます。
どちらも共存できます。プロジェクトフィールドをすぐに削除する必要はありませんが、同じ概念 (たとえば、2 つの "Priority" フィールド) を追跡すると、両方が混乱を招く可能性があります。
移行するには、同等の問題フィールドを作成し、チームの準備ができたらプロジェクトビューからプロジェクトレベルのフィールドを削除します。

プロジェクトのフィールド制限

プロジェクトでは、合計で最大 50 個のフィールドがサポートされており、発行フィールドとシステムフィールドはこの制限にカウントされます。プロジェクトが既にフィールド制限に達している場合は、問題フィールドを追加する前に既存のフィールドを削除する必要があります。

制限

資源	制限
組織ごとの問題フィールド	二十五
単一選択フィールドごとのオプション	100
問題の種類ごとの固定フィールド	10
プロジェクトの合計フィールド (問題フィールドとシステムフィールドを含む)	50

この機能を使用できるユーザーについて

この記事で