Hinzufügen oder Ändern eines Felds zur Auftragsnachverfolgung

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Wichtig

Dieser Artikel gilt für die Projektanpassung für lokale XML-Prozessmodelle. Eine Übersicht über Prozessmodelle finden Sie unter Anpassen ihrer Arbeitsnachverfolgungserfahrung.

Ihr Projekt enthält 100 oder mehr Datenfelder basierend auf dem Prozess — Agile, Agileoder CMMI,der zum Erstellen des — Projekts verwendet wurde. Sie aktualisieren Daten, indem Sie das Datenfeld in einem Arbeitselement ändern. Jedes Arbeitselement ist einem Arbeitselementtyp (WIT) zugeordnet, und die Daten, die Sie nachverfolgen können, entsprechen den Feldern, die der WIT zugewiesen sind.

Sie können ein Feld ändern oder ein benutzerdefiniertes Feld hinzufügen, um zusätzliche Datenanforderungen nachzuverfolgen. Beispielsweise können Sie die Auswahlliste in einem Dropdownmenü anpassen, eine Regel zum Festlegen eines Standardwerts hinzufügen oder den Wert begrenzen, den dieser enthalten kann. Sie können ebenfalls ein Feldattribut ändern.

Nicht alle Auswahllisten werden auf die gleiche Weise definiert. Einige Listen werden über die Benutzeroberfläche, den Workflow für eine WIT oder durch Hinzufügen von Benutzerkonten zu einem Projekt definiert, wie in der folgenden Tabelle angegeben.

Hinweis

Featureverfügbarkeit: Sie können einige Features nur von einem lokalen TFS verwenden und werden als solche bezeichnet.

Methoden, mit denen Arbeitselementfelder hinzugefügt werden

Mit Arbeitsaufgabenfeldern können Sie Daten für einen Arbeitsaufgabentyp verfolgen, die Filterkriterien für Abfragen definieren und Berichte generieren. Alle Datenelemente, mit Ausnahme von Systemfeldern, die Sie nachverfolgen möchten, müssen als Arbeitselementfeld definiert werden. Sie können Arbeitsaufgabenfelder innerhalb der Definition eines Arbeitsaufgabentyps oder globalen Workflows definieren.

Arbeitselementfelder werden für eine Projektsammlung verwaltet. Sie fügen Felder hinzu, wenn Sie eine der folgenden Aufgaben ausführen:

  • Erstellen Sie ein -Projekt. Alle innerhalb der Definition eines Arbeitselementtyps oder globalen Workflows definierten Felder, die für die ausgewählte Prozessvorlage definiert sind, werden erstellt. Die Kernsystemfelder werden automatisch für jeden Arbeitselementtyp definiert, der für ein Projekt definiert ist. Eine Liste dieser Felder finden Sie unter Arbeitselementfeldindex.

  • Importieren Sie eine WIT-Definition. Alle neuen Felder, die innerhalb der Definition eines Arbeitselementtyps definiert sind, werden der Auflistung hinzugefügt. Weitere Informationen finden Sie unter Alle WITD-XML-Elemente – Referenz.

  • Importieren Sie eine globale Workflowdefinition. Der Auflistung werden alle neuen Felder, die innerhalb des globalen Workflows definiert sind, hinzugefügt. Ein globaler Workflow wird definiert, um einen Satz von Arbeitsaufgabenfeldern zu verwalten, der von mehreren Arbeitsaufgabentypen genutzt wird. Weitere Informationen finden Sie unter Anpassen des globalen Workflows.

  • Ordnen Sie eine Projektsammlung einer Instanz von Project Web-App (PWA) zu. Nachdem Sie die Team Foundation Server Extensions for Project Server installiert haben, konfigurieren Sie die Integration, indem Sie verschiedene Komponenten von Team Foundation zuordnen. Beim Zuordnen einer Auflistung wird eine globale Workflowdefinition importiert, die mehrere Felder in Project Server-Feldern unterstützt. Weitere Informationen finden Sie unter Project Serverfelder, die TFS hinzugefügt wurden, um die Datensynchronisierung zu unterstützen.

Alle Felder, die in allen WITs und allen globalen Workflows für alle Projekte definiert sind, stellen den vollständigen Satz von Feldern zusammen, die in der Auflistung definiert sind. Sie können deren Attribut ändern, sie umbenennen und vorhandene Felder löschen. Es entstehen jedoch bestimmte Kosten, wenn Sie diese Art von Änderungen vornehmen, insbesondere für den lokalen Server und die Berichterstellung.

Um ein Feld für eine Auflistung hinzuzufügen oder anzupassen, ändern Sie den XML-Inhalt für die WIT-Definition. Definieren Sie jedes Feld über ein FIELD-Element innerhalb des FIELDS-Abschnitts der WIT-Definition. Informationen zur Struktur und zum Speicherort dieser Dateien finden Sie unter All FIELD XML elements reference (Verweis auf alle FIELD XML-Elemente).

Hinzufügen eines Felds oder Anwenden einer Regel oder Ändern eines Attributs

Um ein benutzerdefiniertes Feld hinzuzufügen, Feldregeln hinzuzufügen oder die Bezeichnung eines Felds in einem Arbeitselementformular zu ändern, ändern Sie den Arbeitselementtyp (WIT) oder die Typen, die das Feld verwenden. Befolgen Sie die Anpassungssequenz, die Ihrem Prozessmodell entspricht.

Um ein Feldattribut zu ändern oder ein Feld umzubenennen, verwenden Sie das Befehlszeilentool witadmin. Andernfalls können Sie zum Ändern eines Felds die Regeln hinzufügen oder ändern, die dem Feld innerhalb einer WIT-Definition zugeordnet sind.

Zusammenfassung der Feldattribute und Feldregeln

So bearbeiten Sie eine WIT-Definitionsdatei

Exportieren Sie zum Hinzufügen von Regeln oder einem benutzerdefinierten Feld die WIT-Definitionsdatei, bearbeiten Sie sie, und importieren Sie die Datei anschließend.

Tipp

Mit witadmin können Sie Definitionsdateien importieren und exportieren. Andere Tools, die Sie verwenden können, sind der Prozess-Editor (erfordert, dass Sie eine Version von Visual Studio installiert haben). Installieren Sie den Prozessvorlagen-Editor aus dem Visual Studio Marketplace.

Alternativ können Sie das TFS Team Project Managerverwenden, einen Open-Source-Client, der über GitHub verfügbar ist.

Tipp

Mit witadmin können Sie Definitionsdateien importieren und exportieren. Andere Tools, die Sie verwenden können, sind der Prozess-Editor (erfordert, dass Sie eine Version von Visual Studio installiert haben). Installieren Sie den TFS-Prozessvorlagen-Editor aus dem Visual Studio Marketplace. Sie können diese Version des Prozess-Editors verwenden, um die alten Arbeitselementformulare zu ändern. Sie können es nicht zum Bearbeiten von Formularen verwenden, die den neuen Webformularenzugeordnet sind.

Alternativ können Sie das TFS Team Project Managerverwenden, einen Open-Source-Client, der über GitHub verfügbar ist.

Tipp

Mit witadmin können Sie Definitionsdateien importieren und exportieren. Andere Tools, die Sie verwenden können, sind der Prozess-Editor (erfordert, dass Sie eine Version von Visual Studio installiert haben). Installieren Sie TFS Power Tools. Alternativ können Sie das TFS Team Project Managerverwenden, einen Open-Source-Client, der über GitHub verfügbar ist.

Jedes Feld, das Sie zum Nachverfolgen von Daten verwenden möchten, muss der WIT-Definitionsdatei hinzugefügt werden. Dies gilt für alle Systemfelder (Felder, deren Verweisname mit System beginnt). Alle Systemfelder werden für alle WITs definiert, unabhängig davon, ob Sie sie in der WIT-Definition einschließen. Weitere Informationen zu jedem Feld finden Sie unter Arbeitselementfeldindex.

Hinzufügen eines Kontrollkästchens oder booleschen Felds

Verwenden Sie die folgende Syntax, um ein boolesches Feld im ABSCHNITT FELDER der WIT-Definition hinzuzufügen.

Verwenden Sie die folgende Syntax, um ein boolesches Feld im ABSCHNITT FELDER der WIT-Definition hinzuzufügen. Erfordert TFS 2017.2 oder höher.

<FIELD name="Triage" refname="Fabrikam.Triage" type="Boolean" >
   <DEFAULT from="value" value="False" />
   <HELPTEXT>Triage work item</HELPTEXT>
</FIELD>

Fügen Sie dann im Abschnitt FORM die folgende Syntax hinzu, damit das Feld im Formular angezeigt wird.

<Control Label="Triage" Type="FieldControl" FieldName="Fabrikam.Triage" />

Das Feld wird im Formular als Kontrollkästchen angezeigt.

Anpassen einer Auswahlliste

Auswahllisten sind die aufzählten Werte, die in einem Dropdownmenü in einem Arbeitselementformular und in der Spalte Wert im Abfrage-Editor angezeigt werden. Die Methode, die Sie zum Anpassen einer Auswahlliste verwenden, ist je nach Feld unterschiedlich.

Bearbeiten Sie die WIT-Definition zum Ändern der Auswahlliste für die meisten Zeichenfolgenfelder oder ganzzahligen Felder in einem Arbeitselementformular. Wenn Sie zum Beispiel ein benutzerdefiniertes Auflösungsfeld und eine benutzerdefinierte Auswahlliste hinzufügen möchten, geben Sie den XML-Code wie im Folgenden dargestellt an.

Benutzerdefiniertes Feld und Auswahlliste
Benutzerdefinierte Auswahlliste

<FIELD name="Resolution" refname="MyCompany.Resolution" type="String">    
<ALLOWEDVALUES>
<LISTITEM value="By Design" />
<LISTITEM value="Duplicate" />
<LISTITEM value="External" />
<LISTITEM value="Fixed" />
<LISTITEM value="Not Repro" />
<LISTITEM value="Postponed" />
<LISTITEM value="Won't Fix" />
</ALLOWEDVALUES>
</FIELD>

Regeln unterstützen das Kombinieren von Listen, das Einschränken von Personen, auf die eine Liste angewendet wird, und das Festlegen von Bedingungen in Bezug darauf, wann eine Liste im Arbeitselementformular angezeigt werden soll. Regeln steuern, ob eine Verteilerliste erweitert wird, um ihre einzelnen Elemente oder eine Liste mithilfe der optionalen Expanditems- und filteritems-Attribute zu filtern. Verwenden Sie globale Listen, um die Arbeit zu minimieren, die erforderlich ist, um eine Liste zu aktualisieren, die von WITs oder Projekten gemeinsam genutzt wird.

Wenn Sie eine Liste in mehreren WITs oder in mehreren Projekten verwenden, minimieren Sie ihre Wartungsanforderungen, wenn Sie sie als globale Liste verwalten. Wenn Teile von Listen in WITs oder Projekten als unterschiedlich angezeigt werden sollen, können Sie eine globale Liste für einen Teil einer Auswahlliste definieren. Weitere Informationen finden Sie unter Definieren von Auswahllisten und Definieren globaler Listen.

Hinzufügen von Regeln zu einem Feld

Bearbeiten Sie die WIT-Definition, um ein benutzerdefiniertes Feld hinzuzufügen oder einem Feld Regeln hinzuzufügen. Sie können die Regeln einschränken, die auf bestimmte Benutzer oder Gruppen angewendet werden sollen. Die meisten Regeln unterstützen das -Attribut für oder keine Attribute, um zu konzentrieren, auf wen die Regel angewendet wird und auf die sie nicht angewendet wird.

Beispielsweise können Sie mit dem folgenden Codeausschnitt die Regel erzwingen, dass das Feld „Stapelrang“ nur von Mitgliedern des „Management“-Teams, eine vom Kunden definierte TFS-Gruppe, geändert werden kann, wenn eine Arbeitsaufgabe erstellt wurde.

<FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">  
   <FROZEN not="[project]\Management Team" />  
   <HELPTEXT>Work first on items with lower-valued stack rank. Set in triage.</HELPTEXT>
</FIELD>  

Sie wenden Regeln an, um die folgenden Aktionen auszuführen:

Aktion: Verwenden Sie dieses XML-Element:
Geben Sie eine QuickInfo an. HELPTEXT
Qualifizieren Sie den Wert, den ein Feld aufweisen kann. CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY und REQUIRED
Kopieren Sie einen Wert, oder geben Sie einen Standardwert an. COPY, DEFAULT und SERVERDEFAULT
Einschränken des Personenkreises, von dem ein Feld geändert werden kann VALIDUSER, für und nicht für Feldregelattribute
Erzwingen Sie einen Mustervergleich für ein Zeichenfolgenfeld. MATCH
Wenden Sie Regeln bedingt auf Grundlage von Werten in anderen Feldern an. WHEN, WHENNOT, WHENCHANGED und WHENNOTCHANGED

Systemfelder, deren Namen alle mit dem Präfix "System" beginnen (z. B. System.ID), sind hinsichtlich der Regeln beschränkt, die Sie auf sie anwenden können. Beispielsweise können Sie keine leeren Felder kopieren oder auf diese festlegen, mit denen nachverfolgt wird, wer ein Arbeitselement erstellt, geändert oder geschlossen hat, oder datums- und uhrzeitbezogene Felder, die vom System verwendet werden.

Weitere Informationen zum Anwenden von Feldregeln und Einschränkungen finden Sie unter Regeln und Regelauswertung.

So fügen Sie ein benutzerdefiniertes Felds hinzu

Um ein benutzerdefiniertes Feld hinzuzufügen, bearbeiten Sie die WIT-Definition, um ein FIELD-Element innerhalb des FIELDS-Abschnitts und ein Control-Element im ABSCHNITT FORM hinzuzufügen.

  1. Exportieren Sie die WIT-Definitionsdatei basierend auf dem prozessbasierten Modell, das Sie verwenden.

  2. Suchen Sie den Abschnitt der XML-Datei, der mit FIELDS beginnt.

  3. Fügen Sie das FIELD -Element hinzu, das den Namen des hinzuzufügenden benutzerdefinierten Felds angibt. Sie müssen die folgenden erforderlichen Attribute angeben: name anzeige, refname (Verweisname) und type . Weitere Informationen finden Sie unter FIELD (Definition)-Elementreferenz.

    Der folgende Code gibt das benutzerdefinierte Feld Anforderer mit dem Verweisnamen FabrikamFiber.MyTeam.Requestor und einer Auswahlliste zulässiger Werte mit dem Standardwert Customer an.

    <FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
       <ALLOWEDVALUES>
          <LISTITEM value="Customer" />
          <LISTITEM value="Executive Management" />
          <LISTITEM value="Other" />
          <LISTITEM value="Support" />
          <LISTITEM value="Team" />
          <LISTITEM value="Technicians" />
          <DEFAULTVALUE value="Customer" />
        </ALLOWEDVALUES>
    </FIELD>
    

    Tipp

    Elemente in der Liste werden stets in alphanumerischer Reihenfolge angezeigt, unabhängig davon, wie Sie diese in der XML-Definitionsdatei eingeben. Der Verweisname oder refname ist der programmgesteuerte Name für das Feld. Alle anderen Regeln sollten auf refname verweisen. Weitere Informationen finden Sie unter Benennungseinschränkungen und -konventionen.

  4. Fügen Sie das Control Element innerhalb des FORM Abschnitts hinzu, damit das benutzerdefinierte Feld im Formular in der Gruppe von Elementen angezeigt wird, in der es angezeigt werden soll.

    Der folgende Codeausschnitt fügt beispielsweise das Feld „Requestor“ hinzu, das im Arbeitselementformular unter dem Feld „Grund“ angezeigt wird.

    <Column PercentWidth="50">
       <Group Label="Status">
          <Column PercentWidth="100">
             <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
             <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
             <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
             <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
          </Column>
       </Group>
    </Column>
    

    Tipp

    Die Schemadefinition für die Arbeitsnachverfolgung definiert alle untergeordneten Elemente des FORM Elements als Camel Case und alle anderen Elemente als großgeschrieben. Wenn beim Überprüfen der Typdefinitionsdateien Fehler auftreten, überprüfen Sie die Groß-/Kleinschreibung der Elemente. Die Groß-/Kleinschreibung der Start- und Endtags muss ebenfalls den Regeln der XML-Syntax entsprechen. Weitere Informationen finden Sie unter Control XML-Elementreferenz.

  5. Importieren Sie die WIT-Definitionsdatei gemäß dem verwendeten Prozessmodell.

  6. Öffnen Sie entweder das Webportal oder Team Explorer, um die Änderungen anzuzeigen. Wenn der Client bereits geöffnet ist, aktualisieren Sie ihn.

    Die folgende Abbildung zeigt, dass das Arbeitsaufgabenformular für das Product Backlog Item jetzt das neue Feld enthält.

    Neues Feld im Formular

So ändern Sie die Feldbezeichnung in einem Arbeitsaufgabenformular

Um die Feldbezeichnung zu ändern, ändern Sie den Wert, der dem Control Label Elementattribut zugewiesen ist. Um ein Feld aus dem Arbeitselementformular zu entfernen, löschen Sie das Control Element, das dem Feld zugeordnet ist.

  1. Exportieren Sie die WIT-Definitionsdatei gemäß Ihrem Prozessmodell.

  2. Suchen Sie in den FORM Abschnitten und Layout nach der Definition des Felds, das Sie ändern möchten. In diesem Beispiel wird die Bezeichnung für das Feld Titel geändert:

    <Column PercentWidth="70">  
       <Control Type="FieldControl" FieldName="System.Title" Label="Title" LabelPosition="Left" />  
    </Column>
    
  3. Ändern Sie die Bezeichnung für das Feld, damit die portugiesischen Filiale, die an diesem bestimmten Projekt arbeitet, den Namen des Felds Titel lesen kann, wenn sie mit dem Arbeitselementformular arbeiten. Schließen Sie das portugiesische Wort für "Titel" (Titulo) in das Titelfeld ein.

    <Column PercentWidth="70">  
       <Control Type="FieldControl" FieldName="System.Title" Label="Title (Titulo):" LabelPosition="Left" />  
    </Column>
    
  4. Importieren Sie die geänderte WIT-Definition.

Hinzufügen eines benutzerdefinierten Steuerelements

Mithilfe des Objektmodells zum Nachverfolgenvon Arbeitselementen können Sie programmgesteuert Fehler, Aufgaben und andere WITs erstellen, ändern und suchen. Sie können auch eigene benutzerdefinierte Steuerelemente erstellen, die einem Arbeitsaufgabenformular Funktionalität hinzufügen.

Mithilfe von REST-APIs zum Nachverfolgenvon Arbeitselementen können Sie Programmgesteuertes Erstellen, Ändern und Suchen von Fehlern, Aufgaben und anderen WITs durchführen. Sie können auch eigene benutzerdefinierte Steuerelemente erstellen, die einem Arbeitsaufgabenformular Funktionalität hinzufügen.

Sie können auch ein benutzerdefiniertes Steuerelement hinzufügen, das über die Visual Studio Marketplaceverfügbar ist. Zum Beispiel:

Informationen zum Hinzufügen eines benutzerdefinierten Steuerelements zum neuen Webformular finden Sie unter WebLayout- und Control-Elemente.

Ändern des Attributs eines vorhandenen Felds

Sie verwenden witadmin changefield, um die Attribute eines vorhandenen Felds zu ändern. Beispielsweise ändert der folgende Befehl den für "MyCompany.Type" definierten Anzeigenamen in Auswertungsmethode.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.Type /name:"Evaluation Method"

In der folgenden Tabelle sind die Attribute zusammengefasst, die Sie mit witadmin changefieldändern können.

attribute Beschreibung
Datentyp Gibt den Datentyp an, der vom Feld akzeptiert wird. Im Allgemeinen können Sie den Felddatentyp nach dessen Definition nicht ändern. Sie können den Felddatentyp nur für Felder vom Typ HTML oder PlainText ändern.
Angezeigter Name Der Anzeigename wird in den Dropdownmenüs von Arbeitselementabfragen angezeigt und muss in allen Feldern, die in einer Projektauflistung definiert sind, eindeutig sein. Der Anzeigename kann sich von der Formularbezeichnung des Arbeitselementformulars unterscheiden.
Berichtsattribute Sie können den Feldnamen für die Darstellung in Berichten, den Berichtsverweisnamen und den Berichterstellungstyp ändern. Der Anzeigename des Berichts kann ebenfalls lokalisiert werden.

Der Berichterstellungstyp bestimmt, ob die Felddaten in die relationale Warehouse-Datenbank geschrieben werden, sowohl in die relationale Warehouse-Datenbank als auch den OLAP-Cube geschrieben werden, oder ob beim Verarbeiten des OLAP-Cubes eine im Voraus berechnete Wertsumme generiert wird.

Eine vollständige Liste der berichtsfähigen Standardfelder finden Sie unter Referenz zu berichtsfähigen Feldern. Weitere Informationen zu berichtsfähigen Attributen finden Sie unter Arbeitselementfelder und -attribute, Berichtsfähige Attribute.
Synchronisierung Sie können die Synchronisierung für Felder mit Personennamen mit Active Directory aktivieren oder deaktivieren.

Ändern des Indexattributs eines Felds

Sie können für ein Feld Indizierung aktivieren, um die Antwortzeiten von Abfragen beim Filtern dieses Felds zu verbessern. Standardmäßig werden die folgenden Felder indiziert: Zugewiesen an, Datum der Erstellung, Geändert von, Zustand, Grund, Bereichs-ID, Iterations-ID und Arbeitselementtyp.

Verwenden Sie den witadmin indexfield-Befehl, um die Indizierung für ein Feld zu aktivieren oder zu deaktivieren.

In diesem Thema wurde erläutert, wie Felder für gehostete XML- und lokale XML-Prozessmodelle hinzugefügt und angepasst werden. Informationen zum Hinzufügen und Anpassen von WITs für gehostete XML- und lokale XML-Prozessmodelle finden Sie unter Hinzufügen oder Ändern eines Arbeitselementtyps. Informationen zum Vererbungsprozessmodell finden Sie unter Anpassen eines Prozesses.

Weitere verwandte Themen oder Ressourcen:

Erforderliche Berechtigungen

  • Um Felder aufzulisten, müssen Sie über die Berechtigung View project-level information (Informationen auf Projektebene anzeigen) für das Projekt in der Sammlung verfügen, die auf Zulassen festgelegt ist.
  • (TFS) Um ein Feld hinzuzufügen oder anzupassen, müssen Sie Mitglied der Gruppe Project Administratoren sein oder die Berechtigung Zum Bearbeiten von Informationen auf Projektebene auf Zulassen festgelegt haben.
  • (TFS) Um Felder zu löschen oder umzubenennen oder ein Attribut eines Felds zu ändern, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder der Sicherheitsgruppe Project Sammlungsadministratoren sein.

Um als Administrator hinzugefügt zu werden, fügen Sie Administratoren hinzu.

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 nachzuverfolgen.

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

Beschreibungen und Die Verwendung jedes Felds, das für die Kernsystemprozesse — "Agile", "Agile" und "CMMI"definiert ist, — finden Sie unter Arbeitselementfeldindex.

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 der Konto-/Projektsammlung eindeutig sein.
  • Feldnamen müssen 128 oder weniger Unicode-Zeichen umfassen.
  • Feldnamen dürfen weder führende oder nachfolgende Leerzeichen noch zwei oder mehr aufeinander folgende Leerzeichen enthalten.
  • Feldnamen müssen mindestens ein alphabetisches Zeichen enthalten.
  • Feldnamen dürfen nicht die folgenden Zeichen enthalten: .,;'`:~\/\*|?"&%$!+=()[]{}<> .

Da benutzerdefinierte Felder für die Kontosammlung definiert sind, können Sie einem Prozess mit dem gleichen Feldnamen, den Sie einem anderen geerbten Prozess hinzufügen, kein benutzerdefiniertes Feld hinzufügen.

Auflisten oder Überprüfen von Feldern

Zum Auflisten oder Überprüfen von Feldern können Sie je nach — Prozessmodellvererbung, gehosteter XML oder lokalem XML eines der folgenden Tools — verwenden. Einen Index von Feldern, die in den Standardprozessen definiert sind, finden Sie unter Arbeitselementfeldindex.

Tool Vererbung Gehostetes XML Lokales XML
Webportal: Auflisten geerbter und benutzerdefinierter Felder ✔️ ✔️ 1
Arbeitselementfeld-Explorer ✔️ ✔️ ✔️
witadmin listfields-Befehlszeilentool ✔️ ✔️ ✔️

Hinweis

  1. Wird nur für Standardprozesse (Agile, CMMI, Cms) unterstützt.

Feld-Explorer für Arbeitselemente

Neben den Attributen, die Sie für ein Arbeitsaufgabenfeld ändern können, gibt es mehrere unveränderliche und praktisch ausgeblendete Attribute für jedes Feld. Sie können die Zuweisungen dieser Felder mit dem Feld-Explorer-Tool für Arbeitsaufgaben überprüfen.

Feld-Explorer für Arbeitselemente

Eine Beschreibung der einzelnen Attribute finden Sie unter Arbeitselementfelder und -attribute.

Um auf den Arbeitselementfeld-Explorer zuzugreifen, müssen Sie das Prozess-Editor-Tool installieren. Basierend auf der Version von Visual Studio, die Sie installiert haben, können Sie das Prozess-Editor-Tool aus einer der folgenden Erweiterungen abrufen.

Test-, Build- und Versionskontrollfelder

Mehrere WITs enthalten Felder mit Informationen, die von automatisierten Prozessen generiert werden, die in Team Foundation Build, Microsoft Test Manager und die Team Foundation-Versionskontrolle integriert werden. Um ihren benutzerdefinierten WITs eines dieser Felder hinzuzufügen, bearbeiten Sie die WIT-Definition gemäß den zuvor in diesem Thema beschriebenen Schritten.

Beispielsweise können Sie die Felder Gefunden in und Integriert in Build hinzufügen, die in den Typdefinitionen für Fehler angezeigt werden. Diese Felder ordnen Fehler den Builds zu, in denen sie gefunden oder korrigiert wurden. Sie können den folgenden Codeausschnitt verwenden, um diese Felder einer Definition des Arbeitselementtyps hinzuzufügen.

<FIELD name="Found In" refname="Microsoft.VSTS.Build.FoundIn" type="String" reportable="dimension">
    <HELPTEXT>Product build number (revision) in which this item was found</HELPTEXT>
</FIELD>
<FIELD name="Integration Build" refname="Microsoft.VSTS.Build.IntegrationBuild" type="String" reportable="dimension">
    <HELPTEXT>Product build number this bug was fixed in</HELPTEXT>
</FIELD>

Weitere Informationen finden Sie unter Abfragen basierend auf den Feldern für die Build- und Testintegration.

Feldnamen und Berichterstellung

Sie können Felder hinzufügen oder die Attribute vorhandener Felder ändern, um die Berichterstellung zu unterstützen. Wenn Sie Felder hinzufügen oder ändern, sollten Sie diese systematisch benennen, damit Sie das Feld im Analysis Services-Cube finden können, da die Felder logisch in Ordner gruppiert werden. Weitere Informationen finden Sie unter Hinzufügen oder Ändern von Arbeitselementfeldern zur Unterstützung der Berichterstellung.

Löschen eines Felds

Wenn Sie ein Feld aus einem bestimmten Arbeitselementtyp entfernen, wird dieses Feld nicht aus der Sammlung oder dem Datenbankserver entfernt, auch wenn von keiner WIT mehr auf dieses Feld verwiesen wird. Führen Sie folgende Schritte aus, um ein Feld zu entfernen:

  1. Entfernen Sie die FIELD Definition aus allen WIT-Definitionen und allen globalen Workflows, die darauf verweisen.

  2. Vergewissern Sie sich, dass das Feld nicht verwendet wird. Zum Beispiel:

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact
    
    Field: MyCompany.CustomContact
    Name: Custom Contact
    Type: String
    Reportable As: dimension
    Use: Not In Use
    Indexed: False
    
  3. Löschen Sie das Feld. Zum Beispiel:

    witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomContact
    
  4. Wenn das gelöschte Feld berichtbar war, erstellen Sie das Data Warehouse neu, um das alte Feld und seine Werte zu bereinigen.

Weitere Informationen finden Sie unter Verwalten von Arbeitselementfeldern.