Arbeitselementfelder und Attribute in Azure Boards

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

Mit Arbeitselementfeldern werden Informationen nachverfolgt. Felder werden für eine Organisation definiert und für alle Projekte freigegeben, die für diese Organisation definiert sind. Sie können eines von zwei Tools verwenden, um die für die Organisation definierten Felder zu überprüfen. Diese Tools sind sowohl für geerbte als auch gehostete XML-Prozessmodelle verfügbar.

• Prozess>Webseite „Felder“
• Feld-Explorer für Arbeitselemente

Eine Beschreibung aller mit einem Systemprozess definierten Felder finden Sie unter Index der Arbeitselementfelder.

Voraussetzungen

• Um die für eine Organisation oder Sammlung definierten Felder anzuzeigen, müssen Sie Mitglied der Anwendungsgruppe Gültige Benutzer für Projektsammlung sein, oder die Berechtigung Instanzebeneninformationen anzeigen muss für die Organisation oder Sammlung auf Zulassen gesetzt sein.

Auflisten oder Überprüfen von Feldern

Zum Auflisten oder Überprüfen von Feldern können Sie je nach Prozessmodell (Vererbung, Gehostetes XML oder Lokales XML) eines der folgenden Tools verwenden. Einen Index der Felder, die im Rahmen der Standardprozesse definiert werden, finden Sie unter Index der Arbeitselementfelder.

Tool	Vererbung	Gehostetes XML	Lokales XML
Webportal: Auflisten geerbter und benutzerdefinierter Felder	✔️	✔️1
Feld-Explorer für Arbeitselemente	✔️	✔️	✔️
Befehlszeilentool „witadmin listfields“	✔️	✔️	✔️

Hinweis

1. Nur für Standardprozesse (Agile, CMMI, Scrum) unterstützt.

Typen und Namen von Felddaten

Jeder Arbeitselementtyp gibt die Felder an, die für die Arbeitselemente definiert sind, die auf diesen Typ verweisen. Jedem Feld ist eine Reihe von Attributen zugeordnet, von denen viele vom System festgelegt werden und nicht geändert werden können.

Jedes Feld wird durch die folgenden drei Attribute definiert.

• Datentyp: Gibt den Typ der Daten an, die in das Feld eingegeben werden können, z. B. „Boolean“, „Double“, „Integer“, „HTML“ und „String“. Beschreibungen der einzelnen Datentypen finden Sie unter Abfragefelder, Operatoren und Makros.
• Anzeigename: Gibt den Namen an, der dem Feld zugewiesen ist und den Sie für ein Feld in einer Abfrageklausel auswählen. Dieser Name kann von dem auf dem Arbeitselementformular angezeigten Namen abweichen.
• Verweisname: Gibt den Namen an, den Sie beim Erstellen einer WIQL-Abfrage oder einer improvisierten Arbeitselementvorlage, bei der Nutzung von REST-API-Befehlen oder beim Definieren von XML-Arbeitselement-Typdefinitionen verwenden. Nach der Definition kann der Verweisname nicht mehr geändert werden.

Eine Beschreibung der einzelnen Feldattribute und ihrer Auflistung finden Sie weiter unten in diesem Artikel unter Feldattribute und Auflisten von Feldattributen. Eine Übersicht der Arbeitselementtypen und Arbeitselemente finden Sie unter Nachverfolgen von Arbeit mit User Storys, Problemen, Fehlern, Features und Epics.

Was ist ein Feld? Wie werden Feldnamen verwendet?

Jedem Arbeitselementtyp sind 31 Systemfelder und mehrere typspezifische Felder zugeordnet. Sie verwenden Arbeitselemente, um Ihr Projekt zu planen und nachzuverfolgen.

Jedes Feld unterstützt die Nachverfolgung einzelner Informationen über die auszuführende Arbeit. Werte, die Sie einem Feld zuweisen, werden im Datenspeicher für die Arbeitsnachverfolgung gespeichert, und Sie können Abfragen erstellen, um Status und Trends zu ermitteln.

Beschreibungen und Hinweise zur Verwendung der einzelnen Felder, die für die Kernsystemprozesse (Agile, Basic, Scrum und CMMI) definiert werden, finden Sie unter Index der Arbeitselementfelder.

Feldnamen

Ein Feldname für eine Arbeitsaufgabe legt jedes Arbeitsaufgabenfeld eindeutig fest. Stellen Sie sicher, dass Ihre Feldnamen den folgenden Richtlinien entsprechen:

• Feldnamen müssen innerhalb des Kontos oder der Projektsammlung eindeutig sein.
• Feldnamen dürfen maximal 128 Unicode-Zeichen umfassen.
• Feldnamen dürfen weder führende oder nachgestellte Leerzeichen noch zwei oder mehr aufeinanderfolgende Leerzeichen enthalten.
• Feldnamen müssen mindestens ein alphabetisches Zeichen enthalten.
• Feldnamen dürfen die folgenden Zeichen nicht enthalten: .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Da benutzerdefinierte Felder für eine Organisation oder Sammlung definiert werden, können Sie einem Prozess kein benutzerdefiniertes Feld mit demselben Feldnamen hinzufügen, den Sie einem anderen Prozess hinzufügen.

Weitere Informationen finden Sie unter Benennungseinschränkungen und -konventionen.

System- und vordefinierte Felder

Alle systemseitig definierten Felder verfügen über Verweisnamen, die mit System beginnen, z. B. „System.AreaPath“, „System.AssignedTo“, und werden in diesem Muster fortgesetzt.

Vom Standardprozess vordefinierte Felder beginnen mit „Microsoft.VSTS“ und unterscheiden sich in der weiteren Benennung je nach Verwendung. Beispiele für vordefinierte Felder, die gemeinsam, für Planungszwecke und Integration in Office Project, für die Integration in Team Foundation Build und die Integration in die Testfallverwaltung (Test Case Management, TCM) verwendet werden, sind:

• Microsoft.VSTS.Common.Priority
• Microsoft.VSTS.Scheduling.DueDate
• Microsoft.VSTS.Build.FoundIn
• Microsoft.VSTS.TCM.Steps

Eine Übersicht über alle Systemfelder und vordefinierten Felder, die für die Standardprozesse/Prozessvorlagen definiert werden, finden Sie unter Index der Arbeitselementfelder. Weitere Informationen zum Angeben von Feldnamen finden Sie unter Benennungseinschränkungen.

Benutzerdefinierte Felder

Da benutzerdefinierte Felder für eine Organisation oder Projektsammlung definiert werden, können Sie einem Prozess kein benutzerdefiniertes Feld mit demselben Feldnamen hinzufügen, den Sie einem anderen Prozess hinzufügen.

Beachten Sie beim Hinzufügen benutzerdefinierter Felder die folgenden Grenzwerte:

• Für jeden Arbeitselementtyp können maximal 64 Felder definiert werden.
• Pro Prozess können maximal 512 Felder definiert werden.

Der Felddatentyp bestimmt die Art und die Größe der Daten, die Sie in dem Feld speichern können. Für ein Feld kann nur ein Typ innerhalb einer Projektsammlung definiert werden. Diese Einschränkung bietet Unternehmen den Vorteil, dass allgemeine Felder übergreifend über Projekte und Arbeitselementtypen verwendet werden können.

Wenn Sie einem geerbten Prozess ein benutzerdefiniertes Feld hinzufügen, weist Azure DevOps einen Verweisnamen mit dem Präfix Custom und dann den Namen des Felds mit entfernten Leerzeichen zu. Wenn Sie beispielsweise ein Feld mit dem Namen DevOps Triage hinzufügen, lautet der Verweisname Custom.DevOpsTriage. Innerhalb des Verweisnamens sind keine Leerzeichen zulässig.

Wie kann ich den Felddatentyp ermitteln?

Zum Anzeigen des Datentyps von Feldern, die für Ihre Organisation definiert sind, öffnen Sie „Prozess“>Seite „Felder“.

Prozess>Webseite „Felder“

Um die Liste der Felder zu überprüfen, die für eine Organisation oder Sammlung definiert sind, öffnen Sie Organisationseinstellungen>Prozess>Felder.

1. Wählen Sie das Azure DevOps-Logo aus, um Projekte zu öffnen. Wählen Sie dann Organisationseinstellungen aus.

   

2. Wählen Sie dann Prozess aus.

   

   Hinweis

   Wenn Prozess nicht angezeigt wird, arbeiten Sie mit TFS-2018 oder einer früheren Version. Die Seite "Prozess " wird nicht unterstützt. Sie müssen die für das lokale XML-Prozessmodell unterstützten Features verwenden.

3. Wählen Sie dann Felder aus.

   Die aufgelisteten Felder entsprechen allen Feldern, die für die Organisation oder Sammlung definiert sind. Dies schließt alle benutzerdefinierten Felder und die für Systemprozesse definierten Felder ein.

   

   Hinweis

   Wenn Felder nicht angezeigt wird, verwendet Ihre Sammlung den lokalen XML-Prozess. Die Seite „Felder“ wird für diesen Prozess nicht unterstützt.

   Beschreibungen und Hinweise zur Verwendung der einzelnen Felder sowie den Verweisnamen jedes Felds können Sie im Index der Arbeitselementfelder nachschlagen. Sie können Verweisnamen von Feldern auch mit der REST-API zum Auflisten von Feldern für einen Arbeitselementtyp abrufen.

Feld-Explorer für Arbeitselemente

Mit dem Feld-Explorer für Arbeitselemente können Sie die Zuweisungen von Feldattributen überprüfen.

Um auf den Feld-Explorer für Arbeitselemente zugreifen zu können, müssen Sie das Prozess-Editor-Tool installieren. Je nach installierter Version von Visual Studio rufen Sie das Prozess-Editor-Tool aus einer der folgenden Erweiterungen ab.

• Visual Studio 2019: Prozessvorlagen-Editor.
• Visual Studio 2017: TFS-Prozessvorlagen-Editor. Sie können diese Version des Prozess-Editors auch verwenden, um die Arbeitselementformulare im alten Format zu ändern. Sie können damit keine Formulare bearbeiten, die den neuen Webformularen zugeordnet sind.
• Visual Studio 2015: TFS-Powertools.

Feldattribute

Für jedes Arbeitselementfeld sind viele nicht veränderliche und ausgeblendete Attribute vorhanden. In der folgenden Tabelle werden die einzelnen Attribute beschrieben. Attribute haben unterschiedliche Namen, je nachdem, ob Sie sie über die REST-APIzum Abrufen von Feldern oder über das Feld-Explorer-Tool für Arbeitselemente (Work Item Field Explorer, WIFE) abrufen.

Attribute, die einem Feld zugewiesen sind, hängen von der verwendeten Plattform und Version ab. Beispielsweise werden einige Attribute beim Vererbungsprozess nicht unterstützt. Informationen zum Nachschlagen des Verweisnamens für ein Feld finden Sie unter Index der Arbeitselementfelder.

Attribut

Attributtyp

Beschreibung

---

REST:
WIFE: AllowedValues

collection

Ruft die Sammlung gültiger Werte für ein Feld ab, das Auswahllistenwerte enthält. Sie können dies ändern, indem Sie eine Auswahlliste oder eine globale Liste (lokal) angeben.
Änderung möglich?=Ja

REST: canSortBy
WIFE: CanSortBy

boolean

Gibt an, ob Sie Abfrageergebnisse mit diesem Feld sortieren können.
Änderung möglich?=Nein

REST: description
WIFE: HelpText

Zeichenfolge

Gibt eine Beschreibung für das Feld an, die auch den Hilfetext definiert, der beim Zeigen auf das Feld im Arbeitselementformular angezeigt wird.
Änderung möglich?=Ja

REST:
WIFE: ID

Integer

Gibt die interne ID des Felds an.
Änderung möglich?=Nein

REST:
WIFE: IsCloneable

boolean

Gibt an, ob der für das Feld definierte Wert kopiert wird, wenn ein Benutzer ein Arbeitselement kopiert. Beispielsweise werden die Felder Titel, Tags und Beschreibung kopiert, die Felder ID und Verlauf jedoch nicht.
Änderung möglich?=Nein

REST:
WIFE: IsComputed

boolean

Gibt an, ob der in diesem Feld festgelegte Wert vom System berechnet wird (True) oder nicht (False). Beispiele für berechnete Felder sind vom System festgelegte Felder, z. B ID, Überarbeitungsdatum, Änderungsdatum und Anzahl externer Links.
Änderung möglich?=Nein

REST:
WIFE: IsCoreField

boolean

Gibt an, ob dieses Feld für alle Arbeitselementtypen angegeben ist.
Änderung möglich?=Nein

REST:
WIFE: IsEditable

boolean

Gibt an, ob Benutzer dieses Feld ändern können (True) oder nicht (False). Beispiele für nicht bearbeitbare Felder sind vom System festgelegte Felder, z. B. ID, Revision, Erstellt von und Geändert von.
Änderung möglich?=Nein

REST: isIdentity
WIFE: IsIdentity

boolean

Gibt an, ob es sich bei diesem Feld um ein Identitätsfeld handelt. Identitätsfelder sind Zeichenfolgenfelder, die zum Speichern von Benutzeridentitäten verwendet werden.
Änderung möglich?=Nein

REST:
WIFE: IsIndexed¹

boolean

Gibt an, ob dieses Feld zur Unterstützung der Suche indiziert ist.
Änderung möglich?=Nein

REST:
WIFE: IsLongText

boolean

Gibt an, dass das Feld mehr als 255 Zeichen enthalten kann, z. B. Felder, denen der Datentyp PlainText, HTML oder History zugewiesen ist.
Änderung möglich?=Nein

REST: isPicklist² WIFE:

boolean

Gibt an, ob dem Feld eine Auswahlliste zugeordnet ist. Der Wert wird auf True festgelegt, wenn ein benutzerdefiniertes Feld für Azure DevOps definiert ist und der Typ „Auswahlliste (Zeichenfolge)“ oder „Auswahlliste (Integer)“ ausgewählt ist. Der Wert wird für geerbte Felder, die Auswahllisten definieren, auf False festgelegt.
Änderung möglich?=Nein

REST: isPicklistSuggested² WIFE:

boolean

Gibt an, ob das Feld es Benutzern ermöglicht, eigene Werte für eine Auswahlliste einzugeben. Der Wert wird auf True festgelegt, wenn ein benutzerdefiniertes Feld für Azure DevOps definiert ist, „Auswahlliste (Zeichenfolge)“ oder „Auswahlliste (Zeichenfolge)“ aktiviert ist und das Kontrollkästchen für Benutzern das Festlegen eigener Werte erlauben aktiviert ist.
Änderung möglich?=Ja

REST: isQueryable
WIFE: IsQueryable

boolean

Gibt an, ob das Feld innerhalb der Gruppe von Feldern angezeigt wird, die Sie hinzufügen können, um eine Arbeitselementabfrage zu filtern (True) oder nicht (False). Die meisten Felder sind abfragbar.
Änderung möglich?=Nein

REST:
WIFE: IsReportable ³

boolean

Gibt an, ob das Reportable-Attribut definiert oder auf einen anderen Wert als None festgelegt ist. Dieses Attribut kann für lokale Umgebungen geändert werden.
Änderung möglich?=Ja

REST:
WIFE: IsUsedInGlobalWorkflow

boolean

Gibt an, ob das Feld innerhalb eines globalen Workflows definiert ist.
Änderung möglich?=Nein

REST:
WIFE: IsUserNameField

boolean

Gibt an, ob das Feld zum Anzeigen eines Identitätsfelds verwendet wird.
Änderung möglich?=Nein

REST: name
WIFE: Name

Zeichenfolge

Anzeigename, der dem Feld zugewiesen ist. Der Anzeigename kann für Azure DevOps nicht geändert werden, jedoch für lokale Bereitstellungen mithilfe des Befehls witadmin changefield.
Änderung möglich?=Nur lokal

REST: picklistId
WIFE: HelpText

GUID

Wenn es sich bei dem Feld um eine Auswahlliste handelt, ist dies der Bezeichner der zugeordneten Auswahlliste, andernfalls NULL. Ein eindeutiger GUID-Wert wird zugewiesen, wenn ein benutzerdefiniertes Feld für Azure DevOps definiert ist und der Typ „Auswahlliste (Zeichenfolge)“ oder „Auswahlliste (Integer)“ ausgewählt ist.
Änderung möglich?=Nein

REST:
WIFE: ProhibitedValues

collection

Ruft die Sammlung der unzulässigen Werte für ein Feld ab, das solche Werte angibt. Sie können unzulässige Werte nur für lokale Bereitstellungen definieren.
Änderung möglich?=Nur lokal

REST: readOnly
WIFE:

boolean

Gibt an, ob das Feld als schreibgeschützt festgelegt ist. Für Azure DevOps Services können nur benutzerdefinierte Felder in schreibgeschützt geändert werden. Systemfelder können nicht geändert werden.
Änderung möglich?=Ja

REST: referenceName
WIFE: ReferenceName

Zeichenfolge

Gibt den Verweisnamen eines Felds an.
Änderung möglich?=Nein

REST:
WIFE: ReportingAttributes³

Gibt Detail, Dimension oder Measure an, je nachdem, ob und wie das Feld in Berichte eingeschlossen werden soll. Daten, die aus Feldern mit einem anderen Wert als None für dieses Attribut stammen, werden in das Data Warehouse exportiert und können in SQL-Berichte aufgenommen werden.
Änderung möglich?=Nur lokal

REST:
WIFE: ReportingName³

Zeichenfolge

Gibt die Bezeichnung für ein Feld an, wenn Daten in SQL-Berichten angezeigt werden. Wenn Sie keinen Wert angeben, wird der Anzeigename des Felds verwendet.
Änderung möglich?=Nur lokal

REST:
WIFE: ReportingReferenceName³

Zeichenfolge

Gibt einen anderen Verweisnamen für ein Feld an, das beim Exportieren von Daten in das relationale Data Warehouse verwendet wird. Wenn Sie keinen Wert angeben, wird der Verweisname des Felds verwendet.
Änderung möglich?=Nur lokal

REST: supportedOperations
WIFE:

set

Die Gruppe von Abfrageoperatoren, die beim Verweisen auf dieses Feld verwendet werden können. Eine kurze Übersicht über unterstützte Vorgänge je nach Datentyp finden Sie unter Kurzübersicht zu Abfragen: Operatoren und Makros, die für jeden Datentyp unterstützt werden.
Änderung möglich?=Nein

REST:
WIFE: SupportsTextQuery

boolean

Gibt an, ob das Feld Textabfragen unterstützt, z. B. Enthält Wörter, Enthält keine Wörter.
Änderung möglich?=Nein

REST:
WIFE: SystemType

Zeichenfolge

Gibt den Datentyp des Felds an, der auf den Systemnamen verweist, z. B. „System.DateTime“ oder „System.String“.
Änderung möglich?=Nein

REST: type
WIFE: FieldType

Zeichenfolge

Gibt den Datentyp des Felds an, z. B. Boolean, DateTime, Integer, String usw. Eine vollständige Liste und Beschreibungen finden Sie unter Abfragefelder, Operatoren und Makros.
Änderung möglich?=Nein

REST: usage
WIFE: Usage

Zeichenfolge

Gibt an, ob das Feld für die Verwendung mit Arbeitselementen (WorkItem) oder Objekten des Typs Arbeitselementlink (WorkItemLink) vorgesehen ist. Die Verwendung der meisten Felder ist „WorkItem“. Eine vollständige Liste der Verwendungswerte finden Sie unter Abrufen von Feldern, FieldUsage.
Änderung möglich?=Nein

Hinweis

1. Bei lokalen Bereitstellungen können Sie die Indizierung für ein Feld aktivieren, um die Antwortzeiten von Abfragen beim Filtern nach diesem Feld zu verbessern. Weitere Informationen finden Sie weiter unten in diesem Artikel unter Indizierte Felder.
2. Die Attribute isPicklist und isPicklistSuggested werden nur benutzerdefinierten Feldern zugewiesen, die für einen geerbten Prozess definiert sind. Das geerbte Prozessmodell wird für Azure DevOps Server 2019 und höhere Versionen unterstützt. Weitere Informationen finden Sie unter Geerbtes Prozessmodell.
3. Alle Berichterstellungsattribute sind nur für lokale Bereitstellungen gültig, deren Projekte so konfiguriert wurden, dass sie SQL Server Reporting und SQL Server Analysis Services unterstützen.

Auflisten von Feldattributen

Sie können die Attribute, die einem Feld zugewiesen sind, mithilfe der REST-APIzum Abrufen von Feldern auflisten. Geben Sie für OrganizationName Ihren Organisationsnamen ein.

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

Hier werden beispielsweise die Attribute für den Iterationspfad aufgelistet, indem der Verweisname (System.IterationPath) für die Organisation „fabrikam“ angegeben wird.

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

Zurückgegebene Daten:

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
}

Hinzufügen und Ändern von Feldern

Um einem Prozess Felder hinzuzufügen, fügen Sie diese einem oder mehreren Arbeitselementtypen hinzu. Weitere Informationen finden Sie unter Anpassen eines Vererbungsprozesses.

Verwandte Artikel

• Kurzübersicht zu Abfragen
• Arbeitselement-Feldindex
• Hinzufügen und Verwalten von Feldern für einen geerbten Prozess
• Metadatenreferenz für Azure Boards Analytics