問題フィールドの追加と管理

メモ

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

問題フィールドは、担当者、ラベル、種類などのシステムフィールドと共に、問題の右側のサイドバーに表示されます。問題を作成または編集するときに値を設定できます。問題の作成時に問題の種類を選択すると、その種類にピン留めされたすべてのフィールドがサイドバーに自動的に表示されます。

フィールド値の設定

更新する問題に移動します。
右側のサイドバーで、目的のフィールドがまだ表示されていない場合は、[フィールドの追加] をクリックします。
ドロップダウンから、追加するフィールドを選択します。
値を設定します。 * 単一選択フィールドの場合は、ドロップダウンからオプションを選択します。 * テキスト フィールドの場合は、値を入力します。 URL は自動的に検出され、リンクとして表示されます。 * 数値フィールドには、数値を入力します。 * 日付フィールドの場合は、日付ピッカーを使用して日付を選択するか、日付を直接入力します。
変更は自動的に保存されます。

問題に移動します。
右側のサイドバーで、フィールド値をクリックします。
値をクリアします。 * 単一選択フィールドの場合は、現在選択されているオプションをクリックして選択を解除します。 * テキスト フィールドと数値フィールドの場合は、入力内のすべてのテキストを削除します。 * 日付フィールドの場合は、日付ピッカーのクリアボタンをクリックします。
クリアすると、フィールドはサイドバーから削除されます。 [ フィールドの追加 ] ボタンを使用して再追加できます。

組織の管理者が特定の問題の種類にフィールドをピン留めしている場合、その種類の問題を作成または表示すると、それらのフィールドがサイドバーと問題作成モーダルに自動的に表示されます。ピン留めされたフィールドを手動で追加する必要はありません。

フィールド値が変更されると、更新が問題のタイムラインに記録されます。タイムラインエントリには、次の情報が表示されます。

"組織のみ" の可視性に設定されたフィールドのタイムラインイベントは、組織のメンバーまたはコラボレーターではないユーザーには表示されません。

組織管理者は、各フィールドの可視性を "組織のみ" または "パブリック" に設定できます。これは、表示される内容に影響します。

フィールドが [組織のみ] に設定されている場合は、少なくとも読み取りアクセス権を持つ組織のメンバーとリポジトリコラボレーターにのみ表示されます。メンバーまたはコラボレーターでない場合、このフィールドは問題のサイドバー、タイムライン、検索候補には表示されません。
フィールドが [パブリック] に設定されている場合は、問題を表示しているユーザーに表示されます。

可視性の構成の詳細については、組織内の問題フィールドの管理を参照してください。

問題フィールドは、プロジェクトビューの列として追加できます。ここで、値、グループ化、フィルター、並べ替え、およびビルドグラフを編集できます。詳細については、「プロジェクトの問題フィールドについて」を参照してください。

問題ダッシュボードとリポジトリの問題ページの両方で、フィールド値に基づいて問題をフィルター処理して検索できます。検索バーに「 field. 」と入力し、フィールド名と値を入力します。例えば次が挙げられます。

        `field.priority:high` 優先度が "高" に設定されている問題を見つけるには

        `field."target date":>=2026-03-01` 2026年3月1日以降の目標日に関する問題を見つけるために

        `field.priority:high,medium` 優先度が "high" または "medium" に設定されている問題を見つけるには

詳細については、「Issue及びPull Requestのフィルタリングと検索」を参照してください。

問題フィールドには、完全な REST API と GraphQL API がサポートされています。フィールド管理を自動化したり、プログラムで値を設定したり、外部ツールと統合したりできます。

        **フィールドの管理**: 組織レベルのフィールドを作成、更新、削除します。 組織の [問題フィールド REST API](/rest/orgs/issue-fields) を参照してください。

        **フィールドの使用**: 個々の問題のフィールド値を取得、設定、クリアします。 
        [イシューフィールド値 REST API](/rest/issues/issue-field-values) を参照してください。