問題フィールドの管理

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

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

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

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

既定のフィールド

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

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

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

Field	型なし	バグ	Task	Feature
Priority
Effort
入社日
ターゲットの日付

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

問題フィールドの作成

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

問題フィールドの編集

1. 組織名またはユーザー プロファイルで、[ 設定] をクリックします。
2. サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
3. 編集するフィールドの右側にある [ ] をクリックします。
4. [ 編集] をクリックし、変更を加えます。
5. 保存フィールドをクリックします。

問題フィールドの削除

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

1. 組織名またはユーザー プロファイルの下にある [ Settings] をクリックします。
2. サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
3. 削除するフィールドの右側にある [ ] をクリックします。
4. [ 削除 ] をクリックし、削除を確認します。

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

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

1. 組織名またはユーザー プロファイルの下にある [ 設定] をクリックします。
2. サイドバーの[計画]セクションで、[ 問題の種類]をクリックします。
3. フィールドの順序を変更する問題の種類をクリックします。
4. [ピン留めされた問題フィールド] で、フィールドをドラッグして順序を変更します。
5. 保存 をクリックします。

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

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

1. 組織名またはユーザー プロファイルの下にある [ 設定] をクリックします。
2. サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
3. ピン留めするフィールドをクリックします。
4. [種類にピン留めする] で、[ ] をクリックし、このフィールドに表示する問題の種類を選択します。
5. 保存フィールドをクリックします。

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

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

フィールドの表示設定

パブリック リポジトリを使用する組織またはユーザー プロファイルの場合、各問題フィールドをすべてのユーザーに表示するか、メンバー、リポジトリ所有者、コラボレーターにのみ表示するかを制御できます。

1. 組織名またはユーザー プロファイルの下で、[ Settings] をクリックします。
2. サイドバーの「計画」セクションで、「 問題フィールド」をクリックします。
3. フィールドの右側にある [ ] をクリックします。
4. 編集 をクリックします。
5. [フィールドの表示設定] で、次のいずれかを選択します。
   • 制限: このフィールドは、組織所有のリポジトリで少なくとも読み取りアクセス権を持つ組織のメンバーとリポジトリコラボレーター、または個人所有のリポジトリで少なくとも読み取りアクセス権を持つリポジトリ所有者とコラボレーターにのみ表示されます。
   • パブリック: このフィールドは、問題を表示するすべてのユーザーに表示されます。
6. 保存 をクリックします。

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

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

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

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

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

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

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

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

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

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

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

Limits

Resource	Limit
課題フィールド	25
単一選択フィールドごとのオプション	100
問題の種類ごとの固定フィールド	10
プロジェクトの合計フィールド (問題フィールドとシステム フィールドを含む)	50