Arbeitselementfelder und Attribute in Azure Boards

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

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

Arbeitselementfelder werden zum Nachverfolgen von Informationen verwendet. Felder werden für eine Auflistung definiert und für alle Projekte freigegeben, die für diese Auflistung definiert sind. Sie können eine von zwei Tools verwenden, um die für die Auflistung definierten Felder zu überprüfen.

Arbeitselementfelder werden zum Nachverfolgen von Informationen verwendet. Felder werden für eine Auflistung definiert und für alle Projekte freigegeben, die für diese Auflistung definiert sind. Um alle felder anzuzeigen, die für eine Auflistung definiert sind, können Sie das Tool "Arbeitselementfeld-Explorer" verwenden, ein Plug-In, um Visual Studio.

Eine Beschreibung jedes Felds, das mit einem Systemprozess definiert ist, finden Sie unter Arbeitselementfeldindex.

Voraussetzungen

  • Um die für eine Organisation oder Auflistung definierten Felder anzuzeigen, müssen Sie Mitglied der Project Sammlung gültige Benutzeranwendungsgruppe sein oder über die Berechtigung "Informationen auf Instanzebene anzeigen" auf "Zulassen" für die Organisation oder Sammlung verfügen.

Listen- oder Überprüfungsfelder

Zum Auflisten oder Überprüfen von Feldern können Sie je nach Prozessmodell – Vererbung, gehosteter XML oder lokalem XML – eine der folgenden Tools verwenden. Ein Index von Feldern, die in den Standardprozessen definiert sind, finden Sie unter Arbeitselementfeldindex.

Tool Vererbung Gehosteter XML-Code Lokales XML
Webportal: Vererbte und benutzerdefinierte Felder auflisten ✔️ ✔️1
Arbeitselementfeld-Explorer ✔️ ✔️ ✔️
witadmin listfields-Befehlszeilentool ✔️ ✔️ ✔️

Hinweis

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

Felddatentypen und -namen

Jeder Arbeitselementtyp gibt die Felder an, die für die Arbeitselemente definiert sind, die auf diesen Typ verweisen. Jedes Feld ist einer 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 Datentyp an, der in das Feld eingegeben werden kann, 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 sie für ein Feld in einer Abfrageklausel auswählen. Dieser Name kann sich von dem Namen unterscheiden, der im Arbeitselementformular angezeigt wird.
  • Referenzname: Gibt den Namen an, den Sie beim Erstellen einer WIQL-Abfrage oder einer improvisierten Arbeitselementvorlage verwenden, mithilfe von REST-API-Befehlen oder definieren XML-Arbeitselementtypdefinitionen. Nach der Definition kann der Verweisname nicht geändert werden.

Eine Beschreibung der einzelnen Feldattribute und deren Liste finden Sie weiter unten in diesem Artikel unter Feldattribute und Listenfeldattribute . Eine Übersicht über WITs und Arbeitselemente finden Sie unter Nachverfolgen der Arbeit mit Benutzergeschichten, Problemen, Fehlern, Features und Epen.

Was ist ein Feld? Wie werden Feldnamen verwendet?

Jeder Arbeitselementtyp ist 31 Systemfeldern und mehreren typspezifischen Feldern zugeordnet. Sie verwenden Arbeitselemente, um Ihr Projekt zu planen und zu verfolgen.

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

Beschreibungen und Verwendung jedes Felds, das für die Kernsystemprozesse definiert ist – Agile, Basic, Scrum und CMMI-Prozesse – finden Sie unter Arbeitselementfeldindex.

Feldnamen

Ein Feldname für eine Arbeitsaufgabe legt jedes Arbeitsaufgabenfeld eindeutig fest. Stellen Sie sicher, dass Ihre Feldnamen in diese Richtlinien fallen:

  • Feldnamen müssen innerhalb der Konto-/Projektsammlung eindeutig sein.
  • Feldnamen müssen 128 oder weniger Unicode-Zeichen sein
  • Feldnamen können keine führenden oder nachgestellten Leerzeichen oder zwei oder mehr aufeinander folgende Leerzeichen enthalten.
  • Feldnamen müssen mindestens ein alphabetisches Zeichen enthalten.
  • Feldnamen können nicht die folgenden Zeichen enthalten: .,;'`:~\/\*|?"&%$!+=()[]{}<>

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

Weitere Informationen finden Sie unter Benennungseinschränkungen und Konventionen.

System- und vordefinierte Felder

Alle vom System definierten Felder enthalten Referenznamen, die mit System beginnen, z. B. System.AreaPath, System.AssignedTo, und fahren Sie in diesem Muster fort.

Vordefinierte Felder, die durch den Standardprozess definiert sind, beginnen mit Microsoft.VSTS und unterscheiden sich dann je nach Verwendung weiter. Beispiele für vordefinierte Felder, die häufig verwendet werden, für Terminplanungszwecke und Integration mit Office Project, für die Integration mit Team Foundation Build und die Integration in die Testfallverwaltung (TCM) sind wie folgt:

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

Eine Übersicht über alle System- und vordefinierten Felder, die für die Standardprozesse/Prozessvorlagen definiert sind, finden Sie unter Arbeitselementfeldindex. Weitere Informationen zum Angeben von Feldnamen finden Sie unter Benennungseinschränkungen.

Benutzerdefinierte Felder

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

Beachten Sie beim Hinzufügen von benutzerdefinierten Feldern die folgenden Grenzwerte:

  • Maximal 256 Felder können für jede WIT definiert werden.
  • Maximal 512 Felder können pro Prozess definiert werden.

Der Felddatentyp bestimmt die Art und Größe von Daten, die Sie im Feld speichern können. Ein Feld kann nur einen Typ innerhalb einer Projektsammlung definieren. 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 zu, der mit "Benutzerdefiniert" vorangestellt ist, und dann den Namen des Felds mit entfernten Leerzeichen. Sie fügen beispielsweise ein Feld namens DevOps Triage hinzu, der Verweisname ist Custom.DevOpsTriage. Es sind keine Leerzeichen innerhalb des Referenznamens zulässig.

Wie kann ich den Felddatentyp bestimmen?

Sie können den Datentyp der für Ihre Organisation definierten Felder anzeigen, indem Sie die Seite "ProcessFields>" öffnen.

Process>Fields page

Wenn Ihre Projektsammlung das Vererbungsprozessmodell zum Anpassen der Arbeitsnachverfolgung verwendet, können Sie den Datentyp von Feldern anzeigen, indem Sie die Seite "ProcessFields>" öffnen.

Process>Fields page

Wenn das lokale XML-Prozessmodell verwendet wird, können Sie den Datentyp über den Feldindex "Arbeitselement" nachschlagen. Alternativ können Sie den Feld-Explorer für Arbeitselemente öffnen, um die definierten Felder und deren Attributzuweisungen zu überprüfen, oder verwenden Sie den Befehl witadmin listfields , um die Feldattribute auflisten zu können. Ausführliche Informationen finden Sie weiter unten in diesem Artikel unter Arbeitselementfeld-Explorer und Listenfeldattribute .

Sie können den Datentyp über den Feldindex "Arbeitselement" nachschlagen. Alternativ können Sie den Feld-Explorer für Arbeitselemente öffnen, um die definierten Felder und deren Attributzuweisungen zu überprüfen, oder verwenden Sie den Befehl witadmin listfields , um die Feldattribute auflisten zu können. Ausführliche Informationen finden Sie weiter unten in diesem Artikel unter Arbeitselementfeld-Explorer und Listenfeldattribute .

ProcessFields-Webseite>

Um die Liste der felder zu überprüfen, die für eine Organisation oder Auflistung definiert sind, öffnen Sie "Organization settingsProcessFields>>".

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

    Choose Organization settings.

  2. Wählen Sie dann "Prozess" aus.

    Choose Process.

    Hinweis

    Wenn "Prozess" nicht angezeigt wird, arbeiten Sie von TFS-2018 oder früherer Version. Die Seite "Prozess" wird nicht unterstützt. Sie müssen die features verwenden, die für das lokale XML-Prozessmodell unterstützt werden.

  3. Wählen Sie dann "Felder" aus.

    Die aufgelisteten Felder entsprechen allen für die Organisation oder Auflistung definierten Feldern. Dies umfasst alle benutzerdefinierten Felder und die für Systemprozesse definierten.

    Make a copy of a selected inherited process

    Hinweis

    Wenn Felder nicht angezeigt werden, verwendet die Auflistung den lokalen XML-Prozess. Die Seite "Felder" wird für diesen Prozess nicht unterstützt.

    Für Beschreibungen und Verwendung jedes Felds sowie den Verweisnamen für jedes Feld können Sie es aus dem Feldindex "Arbeitselement" nachschlagen. Sie können auch den Verweisnamen von Feldern aus dem Feld "Arbeitselementtypen – Listen-REST-API" abrufen.

Feld-Explorer für Arbeitselemente

Sie können die Zuordnungen von Feldattributen mithilfe des Tools "Arbeitselementfeld-Explorer" nachschlagen.

Work item field explorer

Um auf den Arbeitselementfeld-Explorer zuzugreifen, müssen Sie das Prozess-Editor-Tool installieren. Rufen Sie basierend auf der Version von Visual Studio, die Sie installiert haben, das Prozess-Editor-Tool aus einer der folgenden Erweiterungen ab.

Feldattribute

Es gibt viele nicht wechselbare und ausgeblendete Attribute für jedes Arbeitselementfeld. In der folgenden Tabelle werden die einzelnen Attribute beschrieben. Attribute weisen unterschiedliche Namen auf, je nachdem, ob Sie sie über die Felder –GetREST-API erhalten oder über das Tool "Arbeitselementfeld-Explorer(FRAU)" und die FieldDefinition-Eigenschaften anzeigen.

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

Attribut

Attributtyp

Beschreibung


REST:
FRAU: AllowedValues

collection

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

REST: canSortBy
FRAU: CanSortBy

boolean

Gibt an, ob Sie Abfrageergebnisse mit diesem Feld sortieren können.
Kann geändert werden?=Nein

REST: Beschreibung
FRAU: HelpText

Zeichenfolge

Gibt eine Beschreibung für das Feld an, die auch den Hilfetext definiert, der angezeigt wird, wenn Sie auf das Feld innerhalb des Arbeitselementformulars zeigen.
Kann ändern?=Ja

REST:
FRAU: ID

Integer

Gibt die interne ID des Felds an.
Kann geändert werden?=Nein

REST:
FRAU: IsCloneable

boolean

Gibt an, ob der für das Feld definierte Wert kopiert wird, wenn ein Benutzer ein Arbeitselement kopiert. Titel -,Tags- und Beschreibungsfelder werden beispielsweise kopiert, die Felder "ID " und " Verlauf " werden jedoch nicht kopiert.
Kann geändert werden?=Nein

REST:
FRAU: IsComputed

boolean

Gibt an, ob der von diesem Feld festgelegte Wert vom System (True) oder nicht (False) berechnet wird. Beispiele für berechnete Felder sind diejenigen, die vom System festgelegt werden, z. B. die ID, das überarbeitete Datum, das geänderte Datum und die Anzahl externer Verknüpfungen.
Kann geändert werden?=Nein

REST:
FRAU: IsCoreField

boolean

Gibt an, ob dieses Feld für alle Arbeitsaufgabentypen angegeben wird.
Kann geändert werden?=Nein

REST:
FRAU: IsEditable

boolean

Gibt an, ob Benutzer dieses Feld (True) oder nicht (False) ändern können. Beispiele für nicht bearbeitbare Felder sind felder, die vom System festgelegt werden, z. B. ID, Revision, Erstellt von und Geändert nach Feldern
Kann geändert werden?=Nein

REST: isIdentity
FRAU: 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.
Kann geändert werden?=Nein

REST:
FRAU: IsIndexed1

boolean

Gibt an, ob dieses Feld indiziert ist, um die Suche zu unterstützen.
Kann geändert werden?=Nein

REST:
FRAU: IsLongText

boolean

Gibt an, dass das Feld mehr als 255 Zeichen enthalten kann, z. B. Felder, die einem Datentyp von PlainText, HTML oder History zugewiesen sind.
Kann geändert werden?=Nein

REST: isPicklist2 WIFE:

boolean

Gibt an, ob das Feld einer Auswahlliste zugeordnet ist. Der Wert wird auf True festgelegt, wenn ein benutzerdefiniertes Feld für Azure DevOps und Picklist (String) oder Picklist (Integer) ausgewählt ist. Der Wert wird auf "False" für geerbte Felder festgelegt, die Auswahllisten definieren.
Kann geändert werden?=Nein

REST: isPicklistSuggested2 WIFE:

boolean

Gibt an, ob das Feld Benutzern ermöglicht, eigene Werte für eine Auswahlliste einzugeben. Der Wert wird auf "True" festgelegt, wenn ein benutzerdefiniertes Feld für Azure DevOps, Picklist (String) oder Picklist (Integer) aktiviert ist, und das Kontrollkästchen zum Festlegen eigener Werte wird aktiviert.
Kann ändern?=Ja

REST: isQueryable
FRAU: IsQueryable

boolean

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

REST:
FRAU: IsReportable 3

boolean

Gibt an, ob das berichtbare Attribut definiert oder auf nichts anderes als "None" festgelegt ist. Dieses Attribut kann für lokale Umgebungen geändert werden.
Kann ändern?=Ja

REST:
FRAU: IsUsedInGlobalWorkflow

boolean

Gibt an, ob das Feld innerhalb eines globalen Workflows definiert ist.
Kann geändert werden?=Nein

REST:
FRAU: IsUserNameField

boolean

Gibt an, ob das Feld zum Anzeigen eines Identitätsfelds verwendet wird.
Kann geändert werden?=Nein

REST: Name
FRAU: Name

Zeichenfolge

Anzeigename, der dem Feld zugewiesen ist. Der Anzeigename kann für Azure DevOps nicht geändert werden, kann aber für lokale Benutzer mithilfe des Befehls "witadmin changefield" geändert werden.
Kann nur geändert werden?=On-prem

REST: picklistId
FRAU: HelpText

GUID

Wenn es sich bei dem Feld um eine Auswahlliste handelt, ist der Bezeichner der zugeordneten Auswahlliste, andernfalls null. Ein eindeutiger GUID-Wert wird zugewiesen, wenn ein benutzerdefiniertes Feld für Azure DevOps und Picklist (String) oder Picklist (Integer) ausgewählt ist.
Kann geändert werden?=Nein

REST:
FRAU: Verbotene Werte

collection

Ruft die Auflistung verbotener Werte für ein Feld ab, das solche Werte angibt. Sie können nur unzulässige Werte für lokale Bereitstellungen definieren.
Kann nur geändert werden?=On-prem

REST: readOnly
FRAU:

boolean

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

REST: referenceName
FRAU: ReferenceName

Zeichenfolge

Gibt den Verweisnamen eines Felds an.
Kann geändert werden?=Nein

REST:
FRAU: ReportingAttributes3

Gibt Detail, Dimension oder Measure an, je nachdem, ob und wie das Feld in Berichte eingeschlossen werden soll. Daten aus Feldern, die einen anderen Wert als "Keine" für dieses Attribut haben, werden in das Data Warehouse exportiert und können in SQL Berichten eingeschlossen werden.
Kann nur geändert werden?=On-prem

REST:
FRAU: ReportingName3

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.
Kann nur geändert werden?=Lokal

REST:
FRAU: ReportingReferenceName3

Zeichenfolge

Gibt einen anderen Verweisnamen für ein Feld an, das verwendet wird, wenn Daten in das relationale Data Warehouse exportiert werden. Wenn Sie keinen Wert angeben, wird der Feldreferenzname verwendet.
Kann nur geändert werden?=Lokal

REST: supportedOperations
FRAU:

set

Der Satz von Abfrageoperatoren, die für die Verwendung gültig sind, wenn auf dieses Feld verwiesen wird. Eine Kurzübersicht zu unterstützten Vorgängen basierend auf dem Datentyp finden Sie unter "Abfrageschnellübersicht", "Operatoren" und "Makros", die für jeden Datentyp unterstützt werden.
Kann geändert werden?=Nein

REST:
FRAU: SupportsTextQuery

boolean

Gibt an, ob das Feld Textabfragen wie "Enthält Wörter" unterstützt, "Keine Wörter enthält".
Kann geändert werden?=Nein

REST:
FRAU: SystemType

Zeichenfolge

Gibt den Datentyp des Felds an, der auf den Systemnamen verweist, z. B. System.DateTime oder System.String.
Kann geändert werden?=Nein

REST: Typ
FRAU: FieldType

Zeichenfolge

Gibt den Datentyp des Felds an, z. B. Boolean, DateTime, Integer, String usw. Eine vollständige Liste und Beschreibung finden Sie unter Abfragefelder, Operatoren und Makros.
Kann geändert werden?=Nein

REST: Verwendung
FRAU: Verwendung

Zeichenfolge

Gibt an, ob das Feld für die Verwendung mit Arbeitselementen (WorkItem) oder Arbeitselementverknüpfungsobjekten (WorkItemLink) vorgesehen ist. Die Verwendung für die meisten Felder ist WorkItem. Eine vollständige Liste der Verwendungswerte finden Sie unter Get Fields, FieldUsage.
Kann geändert werden?=Nein

Hinweis

  1. Für lokale Bereitstellungen können Sie die Indizierung für ein Feld aktivieren, um die Abfrageantwortzeiten beim Filtern im 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 SQL Server Berichterstellung und SQL Server Analysis Services unterstützt werden.

Reportable-Attribute

Alle Berichterstellungsattribute sind nur für lokale Bereitstellungen gültig, deren Projekte so konfiguriert wurden, dass SQL Server Berichterstellung und SQL Server Analysis Services unterstützt werden. Ausführliche Informationen finden Sie unter Hinzufügen von Berichten zu einem Projekt.

Eine Beschreibung jedes berichtbaren Attributs finden Sie unter Hinzufügen oder Ändern von Arbeitselementfeldern zur Unterstützung der Berichterstellung.

Eine Liste von Feldern mit berichtsfähigen Attributen, die standardmäßig definiert sind, finden Sie unter Referenz zu berichtsfähigen Feldern.

Indizierte Felder

Sie können die Indizierung für ein Arbeitselementfeld aktivieren oder deaktivieren, indem Sie den Befehl "witadmin indexfield " verwenden. Wenn Sie die Indizierung für ein Feld aktivieren, wird möglicherweise mehr Leistung benötigt, um Arbeitselemente zu finden, in deren Abfragen dieses Feld angegeben wird. Standardmäßig werden die folgenden Felder indiziert: Zugewiesen an, Datum der Erstellung, Geändert von, Zustand, Grund, Bereichs-ID, Iterations-ID und Arbeitselementtyp.

Wenn Sie ein benutzerdefiniertes Feld hinzufügen, das Sie in vielen Abfragen von Arbeitselementen verwenden, empfiehlt es sich, die Indizierung für dieses Feld zu aktivieren. Weitere Informationen finden Sie unter "Verwalten von Arbeitselementfeldern (witadmin)".

Listenfeldattribute

Sie können die Attribute auflisten, die einem Feld zugewiesen sind, mithilfe der Felder – REST-API abrufen. Geben Sie Ihren Organisationsnamen für "OrganizationName" ein.

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

Hier werden beispielsweise die Attribute für den Iterationspfad aufgeführt, der den Referenznamen angibt, System.IterationPathfür die Fabrikam-Organisation.

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"
}

Sie können die Attribute auflisten, die einem Feld zugewiesen sind, mithilfe der Felder – REST-API abrufen. Geben Sie Ihren Organisationsnamen für "OrganizationName" ein. Weitere Informationen zur Verwendung von REST finden Sie unter Azure DevOps Services REST-API-Referenz

https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}

Hier werden beispielsweise die Attribute für den Iterationspfad aufgeführt, der den Referenznamen angibt, System.IterationPathfür den Fabrikam-Server.

https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1

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://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}

Listenattribute mithilfe des witadmin Befehlszeilentools

Mithilfe des Befehls "witadmin listfields" können Sie Feldattribute( z. B. datentyp, berichtsfähige Attribute und Indizierung) auflisten.

Sie können z. B. den folgenden Befehl eingeben, um die für ein angegebenes Feld definierten Attribute wie Microsoft.VSTS.Common.Issue aufzuführen.

witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue  

Die Feld- und Attributinformationen werden für das benannte Feld, wie im folgenden Beispiel dargestellt, angezeigt.

Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False  

Der Parameter Use gibt den Namen jedes Projekts und den Arbeitselementtyp an, in dem das Feld verwendet wird.

Project Integration und Projektfeldzuordnung

Sie können ändern, wie Arbeitsnachverfolgungsfelder Feldern in Project zugeordnet werden, und Sie können ändern, wie bestimmte Felder veröffentlicht werden. Siehe [Die Microsoft Project Feldzuordnungsdatei](/previous-versions/azure/devops/reference/xml/customize-project-field-mapping-file.

Hinzufügen und Ändern von Feldern

Zum Hinzufügen von Feldern zu einem Prozess fügen Sie diese zu einem oder mehreren Arbeitsaufgabentypen hinzu. Weitere Informationen finden Sie unter Anpassen eines Vererbungsprozesses.

Sie können die In einem WIT enthaltenen Felder hinzufügen oder ändern oder eine benutzerdefinierte WIT hinzufügen. Weitere Informationen finden Sie unter:

Sie können den Feldnamen, den Index und die Berichtsattribute für jedes Feld mit Ausnahme von Systemfeldern ändern, indem Sie das Befehlszeilentool witadmin verwenden. Weitere Informationen finden Sie unter "Verwalten von Arbeitsaufgabenfeldern-witadmin".

Zum Hinzufügen von Feldern zu einem Projekt fügen Sie sie zu einem oder mehreren Arbeitsaufgabentypen hinzu. Weitere Informationen finden Sie unter Hinzufügen oder Ändern eines Felds zum Nachverfolgen der Arbeit.

Sie können den Feldnamen, den Index und die Berichtsattribute für jedes Feld mit Ausnahme von Systemfeldern ändern, indem Sie das Befehlszeilentool witadmin verwenden. Weitere Informationen finden Sie unter "Verwalten von Arbeitsaufgabenfeldern-witadmin".