Freigeben über


Hinzufügen und Verwalten von Feldern (Vererbungsprozess)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Sie können Ihr Arbeitsverfolgungssystem anpassen, indem Sie benutzerdefinierte Felder hinzufügen oder bestimmte Attribute eines geerbten Symbolfelds ändern. Sie können z. B. ein benutzerdefiniertes Feld hinzufügen, um andere Daten zu erfassen oder die im Arbeitsaufgabenformular angezeigte Beschriftung für ein geerbtes Feld zu ändern.

Wichtig

Das Vererbungsprozessmodell ist für Projekte verfügbar, die für die Unterstützung konfiguriert sind. Wenn Sie eine ältere Sammlung verwenden, überprüfen Sie die Prozessmodellkompatibilität. Wenn Ihre lokale Sammlung für die Verwendung des lokalen XML-Prozessmodells konfiguriert ist, können Sie dieses Prozessmodell nur verwenden, um die Arbeitsverfolgungserfahrung anzupassen. Weitere Informationen finden Sie unter Auswählen des Prozessmodells für Ihre Projektsammlung.

Informationen zum Anzeigen aller für Ihre Organisation definierten Felder, einschließlich system- und geerbter Felder, finden Sie unter Anzeigen von Arbeitsaufgabenfeldern und -attributen.

Nachdem Sie ein benutzerdefiniertes Feld hinzugefügt haben, können Sie es zum Erstellen von Abfragen, Diagrammen oder Analyseansichten und Power BI-Berichten verwenden, um verwandte Daten nachzuverfolgen und zu analysieren.

Voraussetzungen

Anleitungen zum Anpassen von Azure Boards an Ihre spezifischen Geschäftsanforderungen finden Sie unter Informationen zum Konfigurieren und Anpassen von Azure Boards.

Kategorie Anforderungen
Berechtigungen – So erstellen, löschen oder bearbeiten Sie einen Prozess: Mitglied der Gruppe Projektsammlungsadministrator oder spezifische Berechtigungen auf Sammlungsebene – Prozess erstellen, Prozess löschen, Prozess bearbeiten oder Feld aus Organisation löschen – auf Zulassen gesetzt. Weitere Informationen finden Sie unter Festlegen von Berechtigungen und Zugriff für die Arbeitsnachverfolgung, Anpassen eines geerbten Prozesses.
- Um Boards zu aktualisieren: Teamadministrator oder ein Mitglied der Gruppe Projektadministratoren.
Zugang – Selbst wenn Sie über Basic oder niedrigeren Zugriff verfügen, können Sie einen Prozess weiterhin ändern, wenn Ihnen jemand die Entsprechenden Berechtigungen erteilt.
- Um den Typ Ihrer vorhandenen Arbeitselemente zu aktualisieren und zu ändern: Mitglied des Projekts.
Projektprozessmodell – Verwenden Sie das Vererbungsprozess-Modell für die Projektsammlung, die das Projekt enthält.
- Verwenden Sie beim Migrieren von Daten zu Azure DevOps Services den Team Foundation Server-Datenbankimportdienst.
Wissen Vertrautheit mit den Anpassungs- und Prozessmodellen.

Organisationsprozesseinstellungen öffnen

  1. Melden Sie sich bei Ihrem organization (https://dev.azure.com/{yourorganization}) an.

  2. Wählen Sie Organisationseinstellungen aus.

    Screenshot: Auszuwählende Schaltfläche „Organisationseinstellungen“

  3. Wählen Sie Prozess aus.

    Screenshot mit zur Auswahl hervorgehobener Schaltfläche „Prozess“.

  1. Melden Sie sich bei Ihrer Sammlung an (https://dev.azure.com/{Your_Collection}).

  2. Wählen Sie Sammlungseinstellungen oder Administratoreinstellungen aus.

  3. Wählen Sie Prozess aus.

    Screenshot mit hervorgehobener Schaltfläche „Verarbeiten“ in den Sammlungseinstellungen.

Hinweis

Wenn Sie einen geerbten Prozess anpassen, spiegeln alle Projekte, die diesen Prozess verwenden, automatisch die Anpassungen wider. Um einen reibungslosen Übergang sicherzustellen, empfehlen wir, einen Testprozess und ein Projekt zu erstellen, mit dem Sie Ihre Anpassungen testen können, bevor Sie sie organisationsweit implementieren. Weitere Informationen finden Sie unter Erstellen und Verwalten geerbter Prozesse.

Benutzerdefinierte Feldnamen

Wenn Sie einem geerbten Prozess ein benutzerdefiniertes Feld hinzufügen, weist Azure DevOps ihm einen Verweisnamen zu, dem " Benutzerdefiniert" vorangestellt ist, und entfernt alle Leerzeichen aus dem Feldnamen. Einem Feld mit dem Namen "DevOps Triage" wird beispielsweise der Verweisname Custom.DevOpsTriage zugewiesen. Leerzeichen sind in Referenznamen nicht zulässig.

Hinzufügen eines benutzerdefinierten Felds

Sie können Felder hinzufügen und die Gruppe und Seite angeben, auf der sie angezeigt werden sollen. Nachdem Sie ein Feld hinzugefügt haben, können Sie es auf einer Seite ziehen und ablegen, um die Platzierung im Formular anzupassen. Wenn Sie beabsichtigen, einer benutzerdefinierten Seite oder Gruppe mehrere Felder hinzuzufügen, erstellen Sie diese Seiten oder Gruppen zuerst , bevor Sie die Felder hinzufügen.

Jeder Prozess kann bis zu 1.024 Felder definieren, einschließlich System- und geerbter Felder. Felder können nur innerhalb einer Seite in einem Formular hinzugefügt werden. Sie können dem grauen Bereich des Formulars keine Felder hinzufügen, in denen sich die Felder "Zugewiesen an", "Bundesland" und "Grund" befinden.

  1. Wählen Sie auf der Seite "Prozess " des ausgewählten geerbten Prozesses den Arbeitsaufgabentyp (Work Item Type, WIT) aus, auf dem Sie das benutzerdefinierte Feld hinzufügen möchten.

    Im folgenden Beispiel wählen wir den Bug-WIT aus. Beachten Sie die Breadcrumb-Links, mit denen Sie zurück zu "Alle Prozesse " und der Seite " MyAgile "-Prozess navigieren können.

    Screenshot zeigt Breadcrumb-Links für alle Prozesse, Prozesse und WIT.

    Wenn das Feld "Neu" und andere Optionen deaktiviert sind, verfügen Sie nicht über die erforderlichen Berechtigungen zum Bearbeiten des Prozesses.

  2. Wählen Sie bei ausgewähltem WIT das Feld "Neu" aus.

    Screenshot der Prozessarbeitsaufgabentypsseite mit der Option zum Hinzufügen eines Feldes zu einem WIT.

  3. Benennen Sie das Feld, und wählen Sie den Feldtyp aus einem der unterstützten Datentypen aus. Geben Sie optional eine Beschreibung ein.

    Feldnamen müssen innerhalb der Organisation eindeutig sein. Ein benutzerdefiniertes Feld in einem Prozess kann nicht denselben Namen wie ein Feld in einem anderen Prozess aufweisen. Weitere Informationen finden Sie unter Was ist ein Feld? Wie werden Feldnamen verwendet?.

    Im folgenden Beispiel fügen wir einen Ganzzahl-Feldtyp mit der Bezeichnung "Customer Ticket" hinzu.

    Screenshot des Hinzufügens eines Felds zum Bug WIT und Auswählen des Feldtyps

  4. (Optional) Geben Sie auf der Registerkarte "Optionen " an, ob das Feld erforderlich ist, und geben Sie einen Standardwert an. Wenn sie leer gelassen wird, bleibt das Feld optional. Wenn Sie ein Feld erforderlich machen, müssen Benutzer einen Wert angeben, um die Arbeitsaufgabe zu speichern. Der Standardwert wird festgelegt, wenn eine Arbeitsaufgabe erstellt oder geöffnet wird und das Feld leer ist.

    Screenshot: Einstellungsoptionen für das Feld

  5. (Optional) Auf der Registerkarte "Layout " können Sie eine andere Formularbezeichnung als den Feldnamen angeben. Sie können auch die Seite und Gruppe auswählen, auf der das Feld im Formular angezeigt wird.

    Im folgenden Beispiel fügen wir das Feld "Kundenticket" zu einer neuen Gruppe mit der Bezeichnung "Kundenfokus" hinzu.

    Screenshot zeigt das Hinzufügen des Felds

    Hinweis

    Während Sie die Formularbezeichnung ändern können, müssen Sie beim Hinzufügen von Feldern zu Karten (Board, Taskboard) oder beim Erstellen von Abfragen basierend auf dem Feld den Feldnamen verwenden.

  6. Wählen Sie "Feld hinzufügen" aus, um den Vorgang abzuschließen. Wenn Sie keine Layoutposition angeben, fügt das System das Feld der ersten Gruppe von Feldern im Formular hinzu.

  7. Öffnen Sie nach Abschluss der Änderungen eine Arbeitsaufgabe des angepassten Typs, um die Aktualisierungen zu überprüfen.

    Das folgende Beispiel zeigt, dass das Feld "Kundenticket" der Gruppe "Status" erfolgreich hinzugefügt wurde. Wenn die Änderungen nicht sofort sichtbar sind, aktualisieren Sie Ihren Browser, um sicherzustellen, dass die Updates ordnungsgemäß angezeigt werden. Mit diesem Schritt wird sichergestellt, dass das neue Feld ordnungsgemäß in das Arbeitsaufgabenformular integriert und einsatzbereit ist.

    Screenshot des Fehlermoduls mit dem Feld

Hinzufügen einer Auswahlliste

Einschränkungen für Arbeitsnachverfolgung, Prozesse und Projekte

Sie können ein neues Feld hinzufügen und eine Auswahlliste definieren oder die Auswahlliste eines geerbten Felds anpassen.

Jede Organisation oder Sammlung kann bis zu 2.048 Auswahllisten definieren. Jede Picklist kann bis zu 2.048 Elemente enthalten. Picklist-Elemente müssen 256 oder weniger Zeichen lang sein. Informationen zum Hinzufügen abhängiger Auswahllisten finden Sie unter Kaskadierende Listen.

  1. Wählen Sie das Neue Feldsymbol " aus, geben Sie dann den Auswahllistentyp (ganzzahl oder Zeichenfolge) an, und fügen Sie dann die Elemente hinzu, die in der Auswahlliste angezeigt werden sollen. Sie können ein Element hinzufügen und dann die EINGABETASTE auswählen, um ein weiteres Element hinzuzufügen.

    Screenshot zeigt Ein Feld zum Fehlerdialog hinzufügen, Eine benutzerdefinierte Auswahlliste hinzufügen.

    Um ein Element in der Liste zu löschen, markieren Sie das Element und wählen Sie dann das Löschen-Symbol aus.

    Um die Auswahlliste eines geerbten Felds zu ändern, wählen Sie "Bearbeiten" aus, um das Feld zu bearbeiten. Auf der Registerkarte "Definition" können Sie "Wert hinzufügen" auswählen.

    Screenshot zeigt das Feld

  2. (Optional) Geben Sie erforderliche oder Standardwerte an, und wählen Sie aus, wo das Feld im Formular angezeigt wird.

    Screenshot zeigt

Hinzufügen eines Identitätsfelds

Verwenden Sie ein Identitätsbasiertes Feld, um ein Feld hinzuzufügen, das dem Feld "Zugewiesen an" ähnelt. Identitätsbasierte Felder wirken auf die gleiche Weise wie das Feld "Zugewiesen an" und stellen eine Such- und Identitätsauswahlfunktion bereit. Wenn Ihre Organisation Benutzer mit Microsoft Entra ID oder Active Directory verwaltet, synchronisiert das System Identitätsbasierte Felder mit den in diesen Verzeichnissen definierten Namen.

Wählen Sie das Feldsymbol " und dann den Feldnamen, den Identitätstyp und optional eine Beschreibung aus.

Screenshot: Ein Feld zum Fehlerdialog hinzufügen, Registerkarte

(Optional) Geben Sie erforderliche oder Standardwerte an, und wählen Sie aus, wo das Feld im Formular angezeigt wird.

Hinzufügen eines Rich-Text-, HTML-Felds

  1. Wählen Sie das WIT aus, dem Sie das Feld hinzufügen möchten, und wählen Sie dann das Neue Feldsymbol Neues Feld" aus.

  2. Wählen Sie Text (mehrere Zeilen) als Typ aus. Hier bezeichnen wir das Feld als Kundenanfrage, um Kundenkommentare für Produktfeatureanforderungen zu erfassen.

    Screenshot der Seite

  3. Das Feld wird der ersten Spalte unter allen vom System definierten Rich-Text-Feldern hinzugefügt, aber vor dem Diskussionssteuerelement.

    Screenshot: Fehlerformular, Feld

  4. (Optional) Geben Sie erforderliche oder Standardwerte an, und wählen Sie aus, wo das Feld im Formular angezeigt wird.

Hinzufügen eines Kontrollkästchenfelds

  1. Wählen Sie das WIT aus, dem Sie das Feld hinzufügen möchten, und wählen Sie dann das Symbol Neues Feld hinzufügen" aus.

  2. Wählen Sie boolean als Typ aus, und geben Sie ihm eine Beschriftung. Hier bezeichnen wir das Feld als Triaged, um den Triagezustand des Fehlers nachzuverfolgen.

    Screenshot zeigt das Hinzufügen eines booleschen Felds.

  3. (Optional) Wählen Sie "Optionen" aus, und geben Sie dann an, ob das Feld erforderlich ist.

    Screenshot zeigt Einstellungsoptionen für boolesches Feld.

  4. Standardmäßig wird das Feld der letzten gruppe hinzugefügt, die in der zweiten Spalte definiert ist. Wählen Sie "Layout" aus, und ziehen Sie das Feld dann in eine andere Gruppe im Formular.

    Hinweis

    Das Feld wird als Kontrollkästchen im Arbeitselementformular angezeigt. Wenn Sie das Kontrollkästchen aktivieren, wird ein True Wert angegeben. Wenn das Feld auf der Tafel oder im Taskboard angezeigt wird, werden die Werte "True " und "False " anstelle eines Kontrollkästchens als Text angezeigt.

Hinzufügen eines vorhandenen Felds zu einem anderen WIT

Vorhandene Felder entsprechen allen geerbten Feldern und benutzerdefinierten Feldern, die in der Auflistung definiert sind. Nachdem Sie einem WIT ein benutzerdefiniertes Feld hinzugefügt haben, können Sie es aus dem Formularmenü zu anderen WITs hinzufügen. Alternativ können Sie einem Arbeitsaufgabentyp in einem anderen Prozess ein feld hinzufügen, das für einen Prozess definiert ist. Öffnen Sie den Arbeitsaufgabentyp, und wählen Sie das vorhandene Feld aus.

Informationen zum Nachschlagen von Beschreibungen eines systemdefinierten Arbeitselementfelds finden Sie im Feldindex "Arbeitselement".

Im folgenden Beispiel fügen wir das Feld "Kundenticket " zum User Story WIT hinzu.

Screenshot zeigt das Hinzufügen eines vorhandenen Feldes zu einer User Story.

(Optional) Geben Sie erforderliche oder Standardwerte an, und wählen Sie aus, wo das Feld im Formular angezeigt wird.

Erneutes Bezeichnen eines Felds

Das Umbenennen eines Felds oder das Ändern des Typs wird nicht unterstützt. Sie können jedoch die Beschriftung ändern, die auf dem Arbeitsaufgabenformular angezeigt wird, auf der Registerkarte "Layout ". Verwenden Sie beim Erstellen von Abfragen den Feldnamen, nicht die Bezeichnung.

Im folgenden Beispiel bezeichnen wir das Feld "Kundenticket " in "Ticketnummer".

Screenshot der Registerkarte

Beschreibungs-Hilfetext ändern

Beschreibungshilfetext wird angezeigt, wenn Benutzer auf ein Feld im Arbeitsaufgabenformular zeigen. Sie können Hilfetext für benutzerdefinierte und geerbte Felder anpassen, das Verhalten unterscheidet sich jedoch je nach Feldtyp:

  • Geerbte Felder: Hilfetext kann für jeden Arbeitsaufgabentyp und -prozess angepasst werden.
  • Benutzerdefinierte Felder: Der Hilfetext ist für alle Arbeitsaufgabentypen und -prozesse konsistent.

Hinweis

Bestimmte Features erfordern die Installation des Azure DevOps Server 2020.1-Updates. Weitere Informationen finden Sie unter Azure DevOps Server 2020 Update 1 RC1 Versionshinweise, Boards.

Um den Hilfetext " Beschreibung " zu ändern, wählen Sie den Arbeitsaufgabentyp aus, den Sie ändern möchten, wählen Sie "Bearbeiten " für das Feld und dann die Registerkarte "Definition " aus. Der geänderte Wert wirkt sich nur auf dieses Feld im Prozess und für diesen Arbeitsaufgabentyp aus.

Hier ändern wir das Feld "Story Points" für "User Story".

Dialogfeld

Ein- oder Ausblenden oder Entfernen eines Felds

Sie können auswählen, dass ein beliebiges Feld oder benutzerdefiniertes Steuerelement in einem Formular angezeigt oder ausgeblendet wird. Wenn Sie ein Feld später wieder in das Formular einblenden möchten, können Sie es sichtbar machen. Diese Aktionen unterscheiden sich von der Option "Löschen", die das Feld aus der Organisation entfernt.

Hinweis

Daten, die für ein geerbtes Feld definiert sind, auch wenn Sie es ausblenden, werden im Datenspeicher und im Arbeitsaufgabenverlauf beibehalten. Sie können einen Datensatz davon anzeigen, indem Sie die Registerkarte "Verlauf" für eine Arbeitsaufgabe anzeigen.

Wenn Sie ein benutzerdefiniertes Feld aus dem Layout entfernen, wird es im Datenspeicher beibehalten, aber aus dem Verlauf entfernt. Sie können sie aus den Abfrageergebnissen anzeigen. Wenn Sie das Feld wieder zum Formular hinzufügen, wird die Historie wiederhergestellt. Informationen zum Löschen eines benutzerdefinierten Felds aus einer Projektsammlung finden Sie unter Löschen eines Felds.

Ausblenden eines Felds oder benutzerdefinierten Steuerelements

  1. Öffnen Sie das Kontextmenü für das Feld oder Steuerelement, und wählen Sie " Aus Layout ausblenden" aus.

    Fehlerlayout, geerbtes Feld, Kontextmenü öffnen, Wählen Sie

  2. Wenn Sie dem Formular ein ausgeblendetes Feld oder Steuerelement hinzufügen möchten, wählen Sie " Im Layout anzeigen" aus.

Entfernen eines benutzerdefinierten Felds aus einem Formular

  1. Wählen Sie "Aus dem Kontextmenü des Felds entfernen" aus, das Sie entfernen möchten.

    Feld aus Fehler-Arbeitsaufgabentyp entfernen

  2. Bestätigen Sie, dass Sie das Feld entfernen möchten.

    Bestätigen, dass das Feld aus dem Arbeitsaufgabenformular für Fehler entfernt wird
  3. Wenn Sie ein benutzerdefiniertes Feld hinzufügen möchten, das entfernt wurde, wählen Sie "Neues Feld " und dann " Vorhandenes Feld verwenden" aus.

Wiederherstellen des Felds auf voreingestellte Standardwerte

Sie können Änderungen, die Sie an einem geerbten Feld vorgenommen haben, verwerfen. Wählen Sie auf der Seite "Layout" des geänderten Arbeitselementtyps die Option "Zurücksetzen " für das Feld aus.

Screenshot: Seite

Ein benutzerdefiniertes Feld löschen

Mit dem Vererbungsprozessmodell können Sie nur benutzerdefinierte Felder löschen. Systemstandardfelder können nicht gelöscht werden.

Durch das Löschen eines Felds werden alle zugeordneten Daten entfernt, einschließlich historischer Werte. Es kann eine kurze Verzögerung geben, bevor Datenlöschaufträge beginnen. Während dieser Zeit können Sie versuchen, das Feld wiederherzustellen und seine Daten mithilfe der Fields - Update REST API wiederherzustellen. Die Wiederherstellung kann je nach verbleibenden Daten vollständig, teilweise oder nicht erfolgreich sein. Verwenden Sie beim Löschen von Feldern Vorsicht, da die Wiederherstellung nicht immer möglich oder abgeschlossen ist.

Hinweis

Diese Aktion kann nicht rückgängig gemacht werden. Löschen Sie nur Felder, die nicht verwendet werden. Verwenden Sie den Befehl "witadmin listfields ", um nicht verwendete Felder zu identifizieren. Weitere Informationen finden Sie unter Verwalten von Arbeitselementfeldern (witadmin).
Wenn Analytics für Ihre Organisation oder Sammlung aktiviert ist, können Sie Analytics abfragen, um zu ermitteln, wo ein benutzerdefiniertes Feld mit der folgenden Syntax verwendet wird:

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItemTypeFields?$filter=FieldReferenceName eq {CustomFieldReferenceName}&$select=WorkItemType

Führen Sie die folgenden Schritte aus, um ein benutzerdefiniertes Feld zu löschen:

  1. Wählen Sie "Organisationseinstellungen>Prozess>Felder>Weitere Aktionen>Löschen" aus.

    Löschen eines Felds

    Mitglied der Gruppe der Projektsammlung-Administratoren sein oder explizite Berechtigungen zum Löschen von Feldern erhalten haben.

  2. Geben Sie den Namen des Felds ein, wie im folgenden Beispiel gezeigt, und bestätigen Sie dann, indem Sie das Feld "Arbeitsaufgabe löschen" auswählen.

    Screenshot zeigt das Feld

Hinweis

Überprüfen Sie änderungen, die an einem geerbten Prozess über das Überwachungsprotokoll vorgenommen wurden. Weitere Informationen finden Sie unter Access, Export und Filtern von Überwachungsprotokollen.