Problemfelder werden in der rechten Randleiste von Problemen zusammen mit Systemfeldern wie Zuweisungen, Bezeichnungen und Typ angezeigt. Sie können Beim Erstellen oder Bearbeiten eines Problems Werte festlegen. Wenn Sie beim Erstellen eines Problems einen Problemtyp auswählen, werden alle felder, die an diesen Typ angeheftet sind, automatisch in der Randleiste angezeigt.
Hinweis
Problemfelder sind derzeit nur für Probleme verfügbar. Pullanforderungen unterstützen keine Problemfelder.
Festlegen eines Feldwerts
- Navigieren Sie zu dem Problem, das Sie aktualisieren möchten.
- Klicken Sie in der rechten Randleiste, wenn das gewünschte Feld noch nicht sichtbar ist, auf "Feld hinzufügen".
- Wählen Sie in der Dropdownliste das Feld aus, das Sie hinzufügen möchten.
- Legen Sie den Wert fest:
- Wählen Sie für Einzelauswahlfelder eine Option aus der Dropdownliste aus.
- Geben Sie für Textfelder Ihren Wert ein. URLs werden automatisch erkannt und als Links angezeigt.
- Geben Sie für Zahlenfelder einen numerischen Wert ein.
- Verwenden Sie für Datumsfelder die Datumsauswahl, um ein Datum auszuwählen, oder geben Sie das Datum direkt ein.
- Änderungen werden automatisch gespeichert.
Hinweis
Problemfelder können derzeit nicht über URL-Abfrageparameter vorgefüllt oder über Problemvorlagen festgelegt werden. Verwenden Sie zum Festlegen von Feldwerten die Problem-Randleiste, Projekte, die API oder GitHub Actions.
Bearbeiten eines Feldwerts
- Navigieren Sie zum Thema.
- Klicken Sie in der rechten Randleiste auf den Feldwert, den Sie ändern möchten.
- Wählen Sie einen neuen Wert aus, oder geben Sie einen neuen Eintrag ein.
- Änderungen werden automatisch gespeichert.
Löschen eines Feldwerts
- Navigieren Sie zum Thema.
- Klicken Sie in der rechten Randleiste auf den Feldwert.
- Löschen Sie den Wert:
- Klicken Sie bei Einzelauswahlfeldern auf die aktuell ausgewählte Option, um die Auswahl aufzuheben.
- Löschen Sie für Text - und Zahlenfelder den gesamten Text in der Eingabe.
- Klicken Sie für Datumsfelder in der Datumsauswahl auf die Schaltfläche "Löschen".
- Nach dem Bereinigen wird das Feld aus der Seitenleiste entfernt. Sie kann mithilfe der Schaltfläche " Feld hinzufügen " erneut hinzugefügt werden.
Angeheftete Felder
Wenn Felder an einen bestimmten Problemtyp von Ihrem Organisationsadministrator oder von Ihnen für Ihre benutzereigenen Repositorys angeheftet wurden, werden diese Felder automatisch in der Randleiste und beim Erstellen oder Anzeigen eines Problems dieses Typs modal angezeigt. Sie müssen keine angehefteten Felder manuell hinzufügen.
Anzeigen von Feldänderungen in der Timeline
Wenn ein Feldwert geändert wird, wird die Aktualisierung im Änderungsverlauf aufgezeichnet. Der Zeitachseneintrag zeigt Folgendes:
- Welches Feld geändert wurde
- Der neue Wert, der festgelegt wurde
- Die Person, die die Änderung vorgenommen hat
- Der Zeitpunkt der Änderung
Zeitachsenereignisse für Felder, die auf "Eingeschränkte" Sichtbarkeit festgelegt sind, sind nur für Organisationsmitglieder und Repositorymitarbeiter in Organisationsrepositorys oder für den Repositorybesitzer und Mitarbeiter in benutzereigenen Repositorys sichtbar.
Feldsichtbarkeit
Organisationsadministratoren und Benutzerkontobesitzer können die Sichtbarkeit jedes Felds auf "Eingeschränkt" oder "Öffentlich" festlegen. Dies wirkt sich auf die angezeigten Elemente aus:
- Wenn ein Feld auf "Eingeschränkt" festgelegt ist, ist es nur für Organisationsmitglieder und Repositorymitarbeiter mit mindestens Lesezugriff in organisationseigenen Repositorys oder für den Repositorybesitzer und mitarbeiter mit mindestens Lesezugriff in benutzereigenen Repositorys sichtbar. Wenn Sie keinen Zugriff auf das Feld haben, wird es nicht in der Issue-Seitenleiste, der Zeitleiste oder in den Suchvorschlägen angezeigt.
- Wenn ein Feld auf "Öffentlich" festgelegt ist, ist es für jeden sichtbar, der sich die Angelegenheit ansieht.
Weitere Informationen zum Konfigurieren der Sichtbarkeit finden Sie unter Verwalten von Problemfeldern.
Verwenden von Problemfeldern in Projekten
Problemfelder können als Spalten in Projektansichten hinzugefügt werden, in denen Sie Werte, Gruppieren, Filtern, Sortieren und Erstellen von Diagrammen bearbeiten können. Weitere Informationen findest du unter Informationen zu Problemfeldern in Projekten.
Suchen nach Feldwerten
Sie können Probleme basierend auf Feldwerten sowohl auf dem Problemdashboard als auch auf der Problemseite Ihres Repositorys filtern und suchen. Geben Sie field. in der Suchleiste gefolgt vom Feldnamen und -wert ein. Beispiel:
field.priority:highum Probleme mit Priorität zu finden, die auf "Hoch" festgelegt sindfield."target date":>=2026-03-01um Probleme mit einem Zieldatum, das am oder nach dem 1. März 2026 liegt, zu findenfield.priority:high,mediumum Probleme mit Priorität zu finden, die auf "hoch" oder "mittel" festgelegt sind
Weitere Informationen findest du unter Filtern und Suchen von Problemen und Pull-Anforderungen.
Verwenden von Problemfeldern mit der API
Problemfelder verfügen über vollständige REST- und GraphQL-API-Unterstützung. Sie können die Feldverwaltung automatisieren, Werte programmgesteuert festlegen und in externe Tools integrieren.
- Verwalten von Feldern: Erstellen, Aktualisieren und Löschen von Feldern. Weitere Informationen finden Sie in der REST-API für Issue-Felder.
- Verwenden von Feldern: Abrufen, Festlegen und Löschen von Feldwerten für einzelne Probleme. Siehe Problemfeldwert-REST-API.
- GraphQL: Problemfeldtypen und Mutationen sind auch über GraphQL verfügbar.
Siehe die
IssueFieldsUnion, Problemfeldobjekte (z. B.IssueFieldText,IssueFieldSingleSelect,IssueFieldNumber, undIssueFieldDate), und Mutationen (z. B.createIssueField,updateIssueField, undsetIssueFieldValue).
Automatisieren mit GitHub Actions
Problemfeldänderungen lösen Webhook-Ereignisse für das issues Ereignis aus. Sie können diese als Workflowtrigger verwenden:
field_added: wird ausgelöst, wenn ein Feldwert festgelegt oder aktualisiert wird.field_removed: wird ausgelöst, wenn ein Feldwert gelöscht wird.
So führen Sie beispielsweise einen Workflow aus, wenn sich ein Feldwert ändert:
on:
issues:
types: [field_added, field_removed]
Die Ereignisnutzlast enthält den Feldnamen, den Typ, den Wert und den vorherigen Wert. Weitere Informationen findest du unter Ereignisse zum Auslösen von Workflows.