Mit Issue-Feldern können Sie strukturierte Metadaten zu Problemen in Ihren Repositorys hinzufügen. Anstatt sich auf Bezeichnungen oder Freitextumgehungen zu verlassen, können Sie Felder wie Priorität, Aufwand, Auswirkung oder eine benutzerdefinierte Kategorie erstellen, die Ihr Team benötigt. Felder werden auf Organisation oder Benutzerebene definiert und gelten für alle Repositorys.
Informationen zu Problemfeldtypen
Sie können bis zu 25 Vorgangsfelder erstellen. Folgende Feldtypen sind verfügbar:
- Einzelauswahl: Wählen Sie eine Option aus einer vordefinierten Liste aus. Optionen können Namen, Beschreibungen und Farben enthalten.
- Text: Erfassen von Freiformtext. URLs werden automatisch erkannt und als klickbare Links angezeigt.
- Zahl: Akzeptieren Sie numerische Eingaben, einschließlich Dezimalstellen.
- Datum: Stellen Sie einen Datumsauswahl-Dialog zur Verfügung.
Standardfelder
Wenn Issue-Felder aktiviert sind, werden automatisch vier Standardfelder erstellt:
- Priorität (einzelauswahl): Dringend, Hoch, Mittel, Niedrig
- Aufwand (einzelauswahl): Hoch, Mittel, Niedrig
- Startdatum (Datum )
- Zieldatum (Datum )
Diese Standardfelder sind den Vorgangstypen wie folgt zugeordnet:
| Feld | Kein Typ | Fehler | Aufgabe | Feature |
|---|---|---|---|---|
| Priority | ||||
| Effort | ||||
| Startdatum | ||||
| Zieldatum |
Diese Standardfelder können vollständig angepasst werden. Sie können deren Namen, Beschreibungen und Optionen bearbeiten oder löschen, wenn sie nicht in Ihren Workflow passen.
Tipp
Sie können Optionen umbenennen, deren Farben ändern, sie neu anordnen oder neue Werte hinzufügen, die dem Workflow Ihres Teams entsprechen. Sie könnten zum Beispiel die Aufwandsoptionen auf T‑Shirt-Größen (XS, S, M, L, XL) umstellen.
Erstellen eines Problemfelds
- Klicken Sie unter ihrem Organisationsnamen oder Benutzerprofil auf "Einstellungen".
- Klicken Sie im Abschnitt „Planung” auf der Seitenleiste auf Problemfelder.
- Klicke auf Neues Feld.
- Geben Sie unter "Feldname" den Namen des neuen Felds ein.
- Geben Sie optional unter "Beschreibung" eine Beschreibung ein, damit andere personen den Zweck des Felds verstehen können.
- Wählen Sie unter "Feldtyp" den Typ des Felds aus, das Sie erstellen möchten.
- Wenn Sie "Einzelauswahl" ausgewählt haben, fügen Sie optionen für das Feld hinzu:
- Klicken Sie auf "Option hinzufügen" , und geben Sie den Optionsnamen ein.
- Wenn Sie optional eine Farbe für eine Option festlegen möchten, klicken Sie neben der Option auf "Bearbeiten", klicken Sie auf "Bearbeiten", wählen Sie eine Farbe aus, und klicken Sie auf " Speichern".
- Wiederholen Sie diesen Vorgang, um weitere Optionen hinzuzufügen.
- Wählen Sie unter "Feldsichtbarkeit" eine der folgenden Optionen aus:
- Berechtigungen: Wählen Sie aus, wer das Feld und dessen Wert sehen kann. Optionen sind eingeschränkt (Standard) oder öffentlich. Diese Einstellung gilt nur für Probleme in öffentlichen Repositorys.
- An Vorgangstypen anheften: Klicken Sie auf , um auszuwählen, bei welchen Vorgangstypen dieses Feld in der Vorgangsansicht und beim Erstellen von Vorgängen angezeigt wird. Wählen Sie einen oder mehrere Problemtypen oder "Probleme ohne Typ" aus. Felder, die nicht angeheftet sind und keinen Wert aufweisen, bleiben im Problembetrachter und Ersteller ausgeblendet.
- Klicke auf Erstellen.
Bearbeiten eines Problemfelds
- Klicken Sie unter ihrem Organisationsnamen oder Benutzerprofil auf "Einstellungen".
- Klicken Sie im Abschnitt „Planung” auf der Seitenleiste auf Problemfelder.
- Klicken Sie rechts neben dem Feld, das Sie bearbeiten möchten, auf .
- Klicken Sie auf "Bearbeiten" , und nehmen Sie Ihre Änderungen vor.
- Klicken Sie auf Feld speichern.
Löschen eines Problemfelds
Wenn Sie ein Problemfeld löschen, werden alle Werte, die für Probleme für dieses Feld festgelegt sind, dauerhaft entfernt.
- Klicken Sie unter ihrem Organisationsnamen oder Benutzerprofil auf "Einstellungen".
- Klicken Sie im Abschnitt „Planung” auf der Seitenleiste auf Problemfelder.
- Klicken Sie rechts neben dem Feld, das Sie löschen möchten, auf .
- Klicken Sie auf "Löschen ", und bestätigen Sie den Löschvorgang.
Tipp
Wenn Sie keine Vorgangsfelder verwenden möchten, können Sie alle Standardfelder aus Ihren Einstellungen löschen. Dadurch werden sie aus allen Issues entfernt. Sie können Felder jederzeit erneut erstellen.
Neuanordnen von Problemfeldern
Die Reihenfolge der angehefteten Felder wird pro Problemtyp verwaltet. Die Feldreihenfolge bestimmt, wie Felder auf der Problemseitenleiste und im Dialogfeld für die Problemerstellung angezeigt werden.
- Klicken Sie unter ihrem Organisationsnamen oder Benutzerprofil auf "Einstellungen".
- Klicken Sie im Abschnitt "Planung" der Randleiste auf "Problemtypen".
- Klicken Sie auf den Problemtyp, für den Sie Felder neu anordnen möchten.
- Ziehen Sie unter „Angeheftete Problemfelder“ Felder, um sie neu anzuordnen.
- Klicke auf Speichern.
Felder an Vorgangstypen anheften
Sie können Problemfelder bestimmten Problemtypen zuordnen, sodass beim Erstellen oder Anzeigen von Problemen dieses Typs nur die relevantesten Felder angezeigt werden. Sie können z. B. "Schweregrad" Fehlern und "Einfluss" Features zuordnen.
- Klicken Sie unter ihrem Organisationsnamen oder Benutzerprofil auf "Einstellungen".
- Klicken Sie im Abschnitt „Planung” auf der Seitenleiste auf Problemfelder.
- Klicken Sie auf das Feld, das Sie anheften möchten.
- Klicken Sie unter „Für Typen anheften“ auf und wählen Sie die Vorgangstypen aus, in denen dieses Feld angezeigt werden soll.
- Klicken Sie auf Feld speichern.
Angeheftete Felder werden automatisch in der Problem-Randleiste basierend auf dem ausgewählten Problemtyp angezeigt. Wenn Sie Felder an Probleme anheften möchten, die keinen Typ aufweisen, wählen Sie die Option "Probleme ohne Typ" aus.
Hinweis
Felder müssen an mindestens einen Problemtyp oder an "Probleme ohne Typ" angeheftet werden, damit sie in der Problem-Randleiste angezeigt werden. Auf Felder, die nicht an einen Typ angeheftet sind, kann nur über die Schaltfläche " Feld hinzufügen " oder in Projekten zugegriffen werden.
Wenn für Ihre Probleme kein Feld angezeigt wird, überprüfen Sie, ob es an den relevanten Problemtyp oder an "Probleme ohne Typ" angeheftet ist. Felder, die nicht angeheftet sind und für die kein Wert festgelegt ist, werden in der Issue-Seitenleiste ausgeblendet.
Festlegen der Sichtbarkeit von Feldern
Für Organisationen oder Benutzerprofile mit öffentlichen Repositorys können Sie steuern, ob jedes Problemfeld für jeden sichtbar ist, oder nur für Mitglieder, Repositorybesitzer und Mitarbeiter.
- Klicken Sie unter ihrem Organisationsnamen oder Benutzerprofil auf "Einstellungen".
- Klicken Sie im Abschnitt „Planung” auf der Seitenleiste auf Problemfelder.
- Klicken Sie rechts neben dem Feld auf .
- Klicken Sie auf Bearbeiten.
- Wählen Sie unter "Feldsichtbarkeit" eine der folgenden Optionen aus:
- Eingeschränkt: Das Feld ist nur für Organisationsmitglieder und Repositorymitarbeiter mit mindestens Lesezugriff in organisationseigenen Repositorys oder für den Repositorybesitzer und Mitarbeiter mit mindestens Lesezugriff in persönlichen Repositorys sichtbar.
- Öffentlich: Das Feld ist für jeden sichtbar, der das Problem anzeigt.
- Klicke auf Speichern.
Standardmäßig werden alle neuen und vorhandenen Felder auf "Eingeschränkt" festgelegt. Sichtbarkeitseinstellungen werden über die Web-UI, API, Problemzeitachsenereignisse und Suchvorschläge erzwungen.
Problemfelder und Projekte
Vorgangsfelder sind in jedem Projekt in Ihrer Organisation oder Ihrem Benutzerprofil verfügbar, einschließlich öffentlicher und interner Projekte. Ausführliche Informationen zum Hinzufügen, Entfernen und Bearbeiten von Problemfeldern in Projekten finden Sie unter Informationen zu Problemfeldern in Projekten.
Sichtbarkeit in öffentlichen und internen Projekten
Nur Felder mit öffentlicher Sichtbarkeit sind in öffentlichen und internen Projekten verfügbar. Felder, die auf "Eingeschränkt " festgelegt sind, werden nicht angezeigt. Beim Hinzufügen von Feldern zu einem öffentlichen Projekt werden nur Öffentliche Sichtbarkeitsfelder im Dialogfeld "Add-Field" angezeigt.
Wenn die Sichtbarkeit eines Felds von "Öffentlich" in "Eingeschränkt" geändert wird, während es in einem öffentlichen Projekt verwendet wird, wird das Feld automatisch aus dem Projekt entfernt. Um es wiederherzustellen, ändern Sie die Sichtbarkeit des Felds wieder in "Öffentlich".
Von Projektfeldern zu Vorgangsfeldern migrieren
Wenn Sie bereits benutzerdefinierte Felder auf Projektebene für Metadaten wie Priorität oder Aufwand verwenden, können Sie Problemfelder einführen, um diese Werte auf Problemebene zu zentralisieren.
- Problemfelder sind die Quelle der Wahrheit. Der Wert ist dem Vorgang zugeordnet und in allen Projekten, denen der Vorgang angehört, identisch.
- Projektfelder sind auf ein einzelnes Projekt beschränkt. Dasselbe Problem kann unterschiedliche Projektfeldwerte in verschiedenen Projekten aufweisen.
- Beide können koexistieren. Sie müssen Projektfelder nicht sofort entfernen, aber beides kann Verwirrung verursachen, wenn sie dasselbe Konzept nachverfolgen (z. B. zwei "Prioritätsfelder").
- Um zu migrieren, erstellen Sie das entsprechende Problemfeld, und entfernen Sie dann das Feld auf Projektebene aus ihren Projektansichten, wenn Ihr Team bereit ist.
Feldgrenzwerte in Projekten
Projekte unterstützen bis zu 50 Felder insgesamt, und Problemfelder und Systemfelder zählen zu diesem Grenzwert. Wenn ein Projekt bereits an der Feldgrenze liegt, müssen Sie vorhandene Felder entfernen, bevor Problemfelder hinzugefügt werden können.
Grenzen
| Resource | Limit |
|---|---|
| Problemfelder | 25 |
| Optionen pro Einzelauswahlfeld | 100 |
| Angeheftete Felder pro Problemtyp | 10 |
| Gesamtfelder in einem Projekt (einschließlich Problemfelder und Systemfelder) | 50 |