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

メモ

Issue fields are currently in パブリックプレビュー and subject to change. To share feedback, see the community discussion.

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

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

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

        **単一選択**: 定義済みの一覧から 1 つのオプションを選択します。 オプションには、名前、説明、色を指定できます。

        **テキスト**: 自由形式のテキストをキャプチャします。 URL は自動的に検出され、クリック可能なリンクとして表示されます。

        **数値**: 小数点を含む数値入力を受け入れます。

        **日付: 日付**を選択するための日付ピッカーを指定します。

既定のフィールド

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

        **優先度** (単一選択): 緊急、高、中、低

        **作業量** (単一選択): 高、中、低

```
        **開始日** (日付)
```

        **ターゲット日付** (日付)

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

問題フィールドの作成

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。1. 組織の隣の [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。

       **[新しいフィールド]** をクリックします。

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

       **Create** をクリックしてください。

問題フィールドの編集

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。1. 組織の隣の [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
編集するフィールドの右側にあるをクリックします。
[ 編集] をクリックし、変更を加えます。

       **保存フィールド**をクリックします。

問題フィールドの削除

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

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。1. 組織の隣の [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
削除するフィールドの右側にあるをクリックします。
[ 削除 ] をクリックし、削除を確認します。

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

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

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。1. 組織の隣の [設定] をクリックします。
サイドバーの[計画]セクションで、[ 問題の種類]をクリックします。
フィールドの順序を変更する問題の種類をクリックします。
[ピン留めされた問題フィールド] で、フィールドをドラッグして順序を変更します。

       **[保存]** をクリックします。

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

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

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。1. 組織の隣の [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
ピン留めするフィールドをクリックします。
[種類にピン留めする] で、[ をクリックし、このフィールドに表示する問題の種類を選択します。

       **保存フィールド**をクリックします。

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

メモ

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

フィールドの表示設定

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

GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。1. 組織の隣の [設定] をクリックします。
サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
フィールドの右側にあるをクリックします。

       **編集** をクリックします。

[フィールドの表示設定] で、次のいずれかを選択します。 * 組織のみ: このフィールドは、少なくとも読み取りアクセス権を持つ組織のメンバーとリポジトリコラボレーターにのみ表示されます。 * パブリック: このフィールドは、問題を表示するすべてのユーザーに表示されます。

       **[保存]** をクリックします。

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

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

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

この記事で