Listen von Arbeitsaufgabenfeldern und Attributen

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

Arbeitsaufgabenfelder werden verwendet, um Informationen in Azure DevOps nachzuverfolgen. Diese Felder werden auf Organisationsebene definiert und für alle Projekte in der Organisation freigegeben. Um die für Ihre Organisation definierten Felder zu überprüfen, können Sie eines der folgenden beiden Tools verwenden, die sowohl für geerbte als auch für gehostete XML-Prozessmodelle verfügbar sind:

• Webseite 'Prozessfelder > '
• Feld-Explorer für Arbeitselemente

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

Voraussetzungen

Berechtigungen: Um die für eine Organisation oder Sammlung definierten Felder anzuzeigen, müssen Sie Mitglied der Anwendungsgruppe "Gültige Benutzer" der Project-Sammlung sein oder die Berechtigung "Informationen auf Instanzebene anzeigen" auf "Zulassen" für die Organisation oder Sammlung festlegen.

Auflisten oder Überprüfen von Feldern

Verwenden Sie zum Auflisten oder Überprüfen von Feldern eines der folgenden Tools basierend auf Ihrem Prozessmodell – geerbt, gehostete XML oder lokale XML. 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 Arbeitsaufgabentyp gibt die Felder an, die in Arbeitsaufgaben dieses Typs enthalten sind. Jedes Feld verfügt über mehrere Attribute, von denen viele systemdefiniert und unveränderlich sind.

Felder werden durch die folgenden drei Attribute definiert:

• Datentyp: Gibt die Art der Daten an, die in das Feld eingegeben werden können, z. B. Boolean, Double, Integer, HTML oder String. Ausführliche Beschreibungen der einzelnen Datentypen finden Sie unter Abfragefelder, Operatoren und Makros.
• Anzeigename: Der dem Feld zugewiesene benutzerfreundliche Name, der beim Auswählen eines Felds in einer Abfrageklausel verwendet wird. Dieser Name unterscheidet sich möglicherweise von dem Namen, der im Arbeitsaufgabenformular angezeigt wird.
• Referenzname: Der Bezeichner, der beim Erstellen von WIQL-Abfragen, improvisierten Arbeitsaufgabenvorlagen, Ausführen von REST-API-Befehlen oder Definieren von XML-Arbeitsaufgabentypdefinitionen verwendet wird. Der Verweisname ist dauerhaft und kann nicht mehr geändert werden, nachdem festgelegt wurde.

Eine detaillierte Beschreibung der einzelnen Feldattribute und Anweisungen zum Auflisten dieser Attribute finden Sie weiter unten in diesem Artikel unter Feldattribute und Listenfeldattribute . Eine Übersicht über Arbeitsaufgabentypen (Work Item Types, WITs) und Arbeitsaufgaben finden Sie unter "Arbeiten mit Benutzergeschichten nachverfolgen", "Probleme", "Fehler", "Features" und "Epen".

Was ist ein Feld? Wie werden Feldnamen verwendet?

Jeder Arbeitsaufgabentyp enthält 31 Systemfelder und mehrere typspezifische Felder. Arbeitsaufgaben werden verwendet, um Ihr Projekt zu planen und nachzuverfolgen.

Jedes Feld erfasst spezifische Informationen zu der auszuführenden Arbeit. Die Werte, die Sie diesen Feldern zuweisen, werden im Datenspeicher für die Arbeitsnachverfolgung gespeichert, sodass Sie Abfragen erstellen können, die Status und Trends bestimmen.

Beschreibungen und Verwendung der einzelnen Felder, die für die Kernsystemprozesse (Agile, Basic, Scrum und CMMI) definiert sind, finden Sie im Feldindex "Arbeitselement".

Feldnamen

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

• Eindeutigkeit: Feldnamen müssen innerhalb des Kontos oder der Projektsammlung eindeutig sein.
• Länge: Feldnamen müssen maximal 128 Unicode-Zeichen enthalten.
• Abstand: Feldnamen dürfen keine führenden oder nachgestellten Leerzeichen enthalten oder zwei oder mehr aufeinander folgende Leerzeichen enthalten.
• Komposition: Feldnamen müssen mindestens ein alphabetisches Zeichen enthalten.
• Unzulässige Zeichen: Feldnamen dürfen die folgenden Zeichen nicht enthalten: .,;':~/*|?" &%$!+=()[]{}<>'.

Da benutzerdefinierte Felder auf Organisation oder Sammlungsebene definiert sind, können Sie kein benutzerdefiniertes Feld mit demselben Namen zu mehreren Prozessen hinzufügen.

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

System- und vordefinierte Felder

Ein Arbeitselementfeldname identifiziert jedes Feld innerhalb von Azure DevOps eindeutig. Stellen Sie sicher, dass die Feldnamen den folgenden Richtlinien entsprechen:

• Eindeutigkeit: Feldnamen müssen innerhalb eines Kontos oder einer Projektsammlung eindeutig sein.
• Länge: Feldnamen müssen maximal 128 Unicode-Zeichen enthalten.
• Abstand: Feldnamen dürfen keine führenden oder nachgestellten Leerzeichen enthalten oder mehrere aufeinander folgende Leerzeichen enthalten.
• Komposition: Feldnamen müssen mindestens ein alphabetisches Zeichen enthalten.
• Unzulässige Zeichen: Feldnamen dürfen die folgenden Zeichen nicht enthalten: .,;':~/*|?" &%$!+=()[]{}<>'.

Da benutzerdefinierte Felder auf Organisation oder Sammlungsebene definiert sind, können Sie kein benutzerdefiniertes Feld mit demselben Namen zu mehreren Prozessen hinzufügen.

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

Benutzerdefinierte Felder

Da benutzerdefinierte Felder auf Organisation- oder Projektsammlungsebene definiert sind, können Sie kein benutzerdefiniertes Feld mit demselben Namen zu mehreren Prozessen hinzufügen.

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

• Maximale Anzahl von Feldern pro Arbeitsaufgabentyp (WIT): 64
• Maximale Anzahl von Feldern pro Prozess: 512

Der Felddatentyp bestimmt die Art und Größe von Daten, die im Feld gespeichert werden können. Jedes Feld kann nur einen Typ innerhalb einer Projektsammlung definieren und die Verwendung gemeinsamer Felder in verschiedenen Projekten und Arbeitsaufgabentypen fördern.

Wenn Sie einem geerbten Prozess ein benutzerdefiniertes Feld hinzufügen, weist Azure DevOps dem Feldnamen ohne Leerzeichen einen Verweisnamen mit dem Präfix "Benutzerdefiniert" zu. Beispielsweise führt das Hinzufügen eines Felds namens DevOps Triage zum Verweisnamen Custom.DevOpsTriage. Leerzeichen sind in Referenznamen nicht zulässig.

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

Wie kann ich den Felddatentyp ermitteln?

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

Liste "Überprüfen von Feldern"

Führen Sie die folgenden Schritte aus, um die Liste der für eine Organisation oder Sammlung definierten Felder zu überprüfen:

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

   

2. Wählen Sie Prozess aus.

   

3. Wählen Sie Felder aus.

   Die aufgelisteten Felder entsprechen allen für die Organisation oder Sammlung definierten Feldern, die alle benutzerdefinierten Felder und die für Systemprozesse definierten Felder enthalten.

   

   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, Verwendungs- und Referenznamen jedes Felds finden Sie im Feldindex "Arbeitselement". Darüber hinaus können Sie Feldverweisnamen mithilfe der Feldtypen "Work Item Types - List REST API" 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 Arbeitsaufgaben zuzugreifen, installieren Sie das Prozess-Editor-Tool. Rufen Sie basierend auf Ihrer installierten Version von Visual Studio das Prozess-Editor-Tool aus einer der folgenden Erweiterungen ab.

• Visual Studio 2019 & 2022: Ab sofort ist keine spezifische Prozessvorlagen-Editor-Erweiterung verfügbar. Sie können Prozessvorlagen jedoch weiterhin mit anderen Tools wie text-Editor oder XML-Editor anpassen. Sie können auch das Azure DevOps-Webportal für bestimmte Anpassungen verwenden, insbesondere für geerbte Prozesse.
• 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

Es gibt viele nicht veränderbare und ausgeblendete Attribute für jedes Arbeitsaufgabenfeld. In der folgenden Tabelle werden die einzelnen Attribute beschrieben. Attribute weisen unterschiedliche Namen auf, je nachdem, ob Sie sie über die Felder abrufen – REST-API abrufen oder sie über das Tool "Arbeitselementfeld-Explorer (WIFE)" anzeigen.

Attribute, die einem Feld zugewiesen sind, hängen von der Plattform und Version ab, die Sie verwenden. Einige Attribute werden beispielsweise beim Vererbungsprozess nicht unterstützt. Informationen zum Nachschlagen des Verweisnamens für ein Feld finden Sie im Feldindex "Arbeitselement".

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 bestimmter Felder sind diejenigen, die vom System festgelegt werden, z. B. die Felder 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 auflisten, die einem Feld zugewiesen sind, mithilfe der Fields - Get REST API. Ersetzen Sie "OrganizationName" durch Ihren tatsächlichen Organisationsnamen.

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

Wenn Sie beispielsweise die Attribute für den Iterationspfad auflisten möchten, verwenden Sie den Verweisnamen System.IterationPath für die fabrikam Organisation:

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

**Returned data:**

> [!div class="tabbedCodeSnippets"]
> ```JSON
> {
> "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

• In der Kurzübersicht zur Abfrage finden Sie schnell informationen zur Abfragesyntax und -verwendung.
• Erkunden Sie den Arbeitselementfeldindex , um alle verfügbaren Arbeitsaufgabenfelder anzuzeigen.
• Hinzufügen und Verwalten von Feldern für einen geerbten Prozess zum Anpassen von Feldern gemäß den geerbten Prozessanforderungen.
• Greifen Sie auf die Metadatenreferenz für Azure Boards Analytics zu, um Analysemetadaten und Berichterstellungsfunktionen zu verstehen.