{"meta":{"title":"問題フィールドの追加と管理","intro":"個々の問題の問題フィールド値を設定、編集、およびクリアして、チームの構造化されたメタデータをキャプチャできます。","product":"GitHub Issues","breadcrumbs":[{"href":"/ja/issues","title":"GitHub Issues"},{"href":"/ja/issues/tracking-your-work-with-issues","title":"問題"},{"href":"/ja/issues/tracking-your-work-with-issues/using-issues","title":"課題の利用"},{"href":"/ja/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields","title":"問題フィールドの使用"}],"documentType":"article"},"body":"# 問題フィールドの追加と管理\n\n個々の問題の問題フィールド値を設定、編集、およびクリアして、チームの構造化されたメタデータをキャプチャできます。\n\n問題フィールドは、担当者、ラベル、種類などのシステム フィールドと共に、問題の右側のサイドバーに表示されます。 問題を作成または編集するときに値を設定できます。 問題の作成時に問題の種類を選択すると、その種類にピン留めされたすべてのフィールドがサイドバーに自動的に表示されます。\n\n> \\[!NOTE]\n> 課題フィールドは現在、課題でのみ利用できます。 プル要求では、問題フィールドはサポートされていません。\n\n## フィールド値の設定\n\n1. 更新する問題に移動します。\n2. 右側のサイドバーで、目的のフィールドがまだ表示されていない場合は、\\[フィールドの **追加**] をクリックします。\n3. ドロップダウンから、追加するフィールドを選択します。\n4. 値を設定します。\n   * **単一選択フィールドの**場合は、ドロップダウンからオプションを選択します。\n   * **テキスト** フィールドの場合は、値を入力します。 URL は自動的に検出され、リンクとして表示されます。\n   * **数値**フィールドには、数値を入力します。\n   * **日付**フィールドの場合は、日付ピッカーを使用して日付を選択するか、日付を直接入力します。\n5. 変更は自動的に保存されます。\n\n> \\[!NOTE]\n> 現在、問題フィールドは URL クエリ パラメーターを使用して事前入力したり、問題テンプレートを使用して設定したりすることはできません。 フィールド値を設定するには、問題のサイドバー、プロジェクト、API、または GitHub Actionsを使用します。\n\n## フィールド値の編集\n\n1. 問題に移動します。\n2. 右側のサイドバーで、変更するフィールド値をクリックします。\n3. 新しい値を選択するか、新しいエントリを入力します。\n4. 変更は自動的に保存されます。\n\n## フィールド値のクリア\n\n1. 問題に移動します。\n2. 右側のサイドバーで、フィールド値をクリックします。\n3. 値をクリアします。\n   * **単一選択フィールドの**場合は、現在選択されているオプションをクリックして選択を解除します。\n   * **テキスト** フィールドと**数値**フィールドの場合は、入力内のすべてのテキストを削除します。\n   * **日付**フィールドの場合は、日付ピッカーのクリア ボタンをクリックします。\n4. クリアすると、フィールドはサイドバーから削除されます。 \\[ **フィールドの追加** ] ボタンを使用して再追加できます。\n\n## ピン留めされたフィールド\n\n組織の管理者が特定の問題の種類にフィールドをピン留めしている場合、その種類の問題を作成または表示すると、それらのフィールドがサイドバーと問題作成モーダルに自動的に表示されます。 ピン留めされたフィールドを手動で追加する必要はありません。\n\n## タイムラインでのフィールドの変更の表示\n\nフィールド値が変更されると、更新が問題のタイムラインに記録されます。 タイムライン エントリには、次の情報が表示されます。\n\n* 変更されたフィールド\n* 設定された新しい値\n* 変更を行ったのは誰でしょうか？\n* いつ変更が行われたか\n\n\"組織のみ\" の可視性に設定されたフィールドのタイムライン イベントは、組織のメンバーまたはコラボレーターではないユーザーには表示されません。\n\n## フィールドの可視性\n\n組織管理者は、各フィールドの可視性を \"組織のみ\" または \"パブリック\" に設定できます。 これは、表示される内容に影響します。\n\n* フィールドが **\\[組織のみ**] に設定されている場合は、少なくとも読み取りアクセス権を持つ組織のメンバーとリポジトリコラボレーターにのみ表示されます。 メンバーまたはコラボレーターでない場合、このフィールドは問題のサイドバー、タイムライン、検索候補には表示されません。\n* フィールドが **\\[パブリック**] に設定されている場合は、問題を表示しているユーザーに表示されます。\n\n可視性の構成の詳細については、 [組織内の問題フィールドの管理](/ja/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization#setting-field-visibility) を参照してください。\n\n## プロジェクトでの問題フィールドの使用\n\n問題フィールドは、プロジェクト ビューの列として追加できます。ここで、値、グループ化、フィルター、並べ替え、およびビルド グラフを編集できます。 詳細については、「[プロジェクトの問題フィールドについて](/ja/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields)」を参照してください。\n\n## フィールド値による検索\n\n問題ダッシュボードとリポジトリの問題ページの両方で、フィールド値に基づいて問題をフィルター処理して検索できます。 検索バーに「 `field.` 」と入力し、フィールド名と値を入力します。 例えば次が挙げられます。\n\n* `field.priority:high` 優先度が \"高\" に設定されている問題を見つけるには\n* `field.\"target date\":>=2026-03-01` 2026年3月1日以降の目標日に関する問題を見つけるために\n* `field.priority:high,medium` 優先度が \"high\" または \"medium\" に設定されている問題を見つけるには\n\n詳細については、「[Issue及びPull Requestのフィルタリングと検索](/ja/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests)」を参照してください。\n\n## API での問題フィールドの使用\n\n問題フィールドには、完全な REST API と GraphQL API がサポートされています。 フィールド管理を自動化したり、プログラムで値を設定したり、外部ツールと統合したりできます。\n\n* **フィールドの管理**: 組織レベルのフィールドを作成、更新、削除します。 組織の [問題フィールド REST API](/ja/rest/orgs/issue-fields) を参照してください。\n* **フィールドの使用**: 個々の問題のフィールド値を取得、設定、クリアします。\n  [イシューフィールド値 REST API](/ja/rest/issues/issue-field-values) を参照してください。\n* **GraphQL**: 問題フィールドの種類と変更は、GraphQL を介して入手することもできます。\n  [\n  `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`など) を参照してください。\n\n## GitHub Actions を使用した自動化\n\n問題フィールドの変更により、 `issues` イベントで webhook イベントがトリガーされます。 これらはワークフロー トリガーとして使用できます。\n\n* `field_added`: フィールド値が設定または更新されると発生します。\n* `field_removed`: フィールドの値がクリアされると発生します。\n\nたとえば、フィールド値が変更されるたびにワークフローを実行するには、次のようにします。\n\n```yaml\non:\n  issues:\n    types: [field_added, field_removed]\n```\n\nイベント ペイロードには、フィールド名、型、値、および前の値が含まれます。 詳細については、「[ワークフローをトリガーするイベント](/ja/actions/reference/workflows-and-actions/events-that-trigger-workflows#issues)」を参照してください。"}