Arbeitselementfelder und Attribute in Azure Boards

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

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.

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.

Wie kann ich den Felddatentyp ermitteln?

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 & 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

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.

Auflisten von Feldattributen

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

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

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

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

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

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

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

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  

Hinzufügen und Ändern von Feldern

Verwandte Artikel