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

個々の問題の問題フィールド値を設定、編集、およびクリアして、チームの構造化されたメタデータをキャプチャできます。

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

> \[!NOTE]
> 課題フィールドは現在、課題でのみ利用できます。 プル要求では、問題フィールドはサポートされていません。

## フィールド値の設定

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

> \[!NOTE]
> 現在、問題フィールドは URL クエリ パラメーターを使用して事前入力したり、問題テンプレートを使用して設定したりすることはできません。 フィールド値を設定するには、問題のサイドバー、プロジェクト、API、または GitHub Actionsを使用します。

## フィールド値の編集

1. 問題に移動します。
2. 右側のサイドバーで、変更するフィールド値をクリックします。
3. 新しい値を選択するか、新しいエントリを入力します。
4. 変更は自動的に保存されます。

## フィールド値のクリア

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

## ピン留めされたフィールド

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

## タイムラインでのフィールドの変更の表示

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

* 変更されたフィールド
* 設定された新しい値
* 変更を行ったのは誰でしょうか？
* いつ変更が行われたか

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

## フィールドの可視性

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

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

可視性の構成の詳細については、 [組織内の問題フィールドの管理](/ja/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization#setting-field-visibility) を参照してください。

## プロジェクトでの問題フィールドの使用

問題フィールドは、プロジェクト ビューの列として追加できます。ここで、値、グループ化、フィルター、並べ替え、およびビルド グラフを編集できます。 詳細については、「[プロジェクトの問題フィールドについて](/ja/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields)」を参照してください。

## フィールド値による検索

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

* `field.priority:high` 優先度が "高" に設定されている問題を見つけるには
* `field."target date":>=2026-03-01` 2026年3月1日以降の目標日に関する問題を見つけるために
* `field.priority:high,medium` 優先度が "high" または "medium" に設定されている問題を見つけるには

詳細については、「[Issue及びPull Requestのフィルタリングと検索](/ja/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests)」を参照してください。

## API での問題フィールドの使用

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

* **フィールドの管理**: 組織レベルのフィールドを作成、更新、削除します。 組織の [問題フィールド REST API](/ja/rest/orgs/issue-fields) を参照してください。
* **フィールドの使用**: 個々の問題のフィールド値を取得、設定、クリアします。
  [イシューフィールド値 REST API](/ja/rest/issues/issue-field-values) を参照してください。
* **GraphQL**: 問題フィールドの種類と変更は、GraphQL を介して入手することもできます。
  [
  `IssueFields`共用体](/ja/graphql/reference/issues#union-issuefields)、[課題フィールドオブジェクト](/ja/graphql/reference/issues#object-issuefieldtext) (`IssueFieldText`、`IssueFieldSingleSelect`、`IssueFieldNumber`、`IssueFieldDate`など)、[およびミューテーション](/ja/graphql/reference/issues#mutation-createissuefield) (`createIssueField`、`updateIssueField`、`setIssueFieldValue`など) を参照してください。

## GitHub Actions を使用した自動化

問題フィールドの変更により、 `issues` イベントで webhook イベントがトリガーされます。 これらはワークフロー トリガーとして使用できます。

* `field_added`: フィールド値が設定または更新されると発生します。
* `field_removed`: フィールドの値がクリアされると発生します。

たとえば、フィールド値が変更されるたびにワークフローを実行するには、次のようにします。

```yaml
on:
  issues:
    types: [field_added, field_removed]
```

イベント ペイロードには、フィールド名、型、値、および前の値が含まれます。 詳細については、「[ワークフローをトリガーするイベント](/ja/actions/reference/workflows-and-actions/events-that-trigger-workflows#issues)」を参照してください。