Verwalten von Arbeitsaufgabenfeldern

Sie können die Arbeitsaufgabenfelder verwalten, die für eine Teamprojektauflistung definiert sind, indem Sie folgende witadmin-Befehle verwenden:

• changefield: Ändert mindestens ein Attribut eines Felds.Wenn Sie eines der folgenden Attribute ändern, ändern Sie es für alle Arbeitsaufgabentypen und Teamprojekte in der Teamprojektauflistung:

  • Datentyp für PlainText- oder HTML-Felder.

    Wichtig
    Wenn Sie Team Foundation Server von einer früheren Version auf die aktuelle Version aktualisieren, wird die Typzuweisung für das Feld Beschreibung (System.Description) automatisch von PlainText in HTML konvertiert.Mit dem Befehl changefield können Sie den Inhalt dieses Felds so wiederherstellen, dass einfacher Text angezeigt wird.

  • Anzeigename, der in der Arbeitsaufgabenabfrage anzeigt wird.Dieser Name unterscheidet sich von dem, der auf dem Arbeitsaufgabenformular angezeigt wird.

  • Berichtsattribute, die den Namen des Felds enthalten, wie er in einem Bericht angezeigt wird, sowie den Bezugslistennamen und den Berichterstellungstyp.

  • Synchronisierung mit Active Directory - Sie können die Synchronisierung von Personennamefeldern aktivieren bzw. deaktivieren.

• deletefield: Löscht das angegebene Feld.

• indexfield: Aktiviert bzw. deaktiviert die Indizierung für das angegebene Feld.Wenn Sie die Indizierung für ein Feld aktivieren, wird möglicherweise mehr Leistung benötigt, um Arbeitsaufgaben zu finden, in deren Abfragen dieses Feld angegeben wird.Wenn Sie ein benutzerdefiniertes Feld hinzufügen, das Sie in vielen Arbeitsaufgabeabfragen verwenden, empfiehlt es sich, die Indizierung für dieses Feld zu aktivieren.

• listfields: Führt die Attribute für alle Felder oder ein angegebenes Feld auf.

Um das witadmin-Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, wo entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Ersetzen Sie bei einer 64-Bit-Windows-Edition %programfiles% durch %programfiles(x86)%.

Eine Übersicht über die Felder, die in den Standardprozessvorlagen von Team Foundation Server definiert sind, finden Sie unter Arbeitsaufgabenfeldverweis für Visual Studio ALM.

Hinweis
Mit dem Prozess-Editor, einem Powertool für Visual Studio, können Sie Arbeitsaufgabenfelder erstellen und ändern.Dieses Tool wird nicht unterstützt.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Team Foundation Server Power Tools.

Anforderungen

• Um Felder aufzulisten, muss die Berechtigung Projektebeneninformationen anzeigen für das Teamprojekt in der Auflistung auf Zulassen festgelegt werden.

• Um Felder zu löschen oder umzubenennen oder um das Attribut eines Felds zu ändern, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder der Sicherheitsgruppe Projektauflistungsadministratoren sein.

Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen und Team Foundation Server: Standardgruppen, Berechtigungen und Rollen.

Hinweis

Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, auf dem Windows Server 2008 ausgeführt wird.Um ein Eingabeaufforderungsfenster mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü Eingabeaufforderung, und wählen Sie anschließend Als Administrator ausführen aus.Weitere Informationen finden Sie auf der Microsoft-Website unter Benutzerkontensteuerung.

witadmin changefield /collection:CollectionURL /n:RefName
   [/name:NewName] 
   [/syncnamechanges:true | false]
   [/reportingname:ReportingName] 
   [/reportingrefname:ReportingRefName]
   [/reportingtype:Type]
   [/reportingformula:Formula]
   [/type:PlainText | HTML]
   [/noprompt]

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]

witadmin indexfield /collection:CollectionURL /n:Name /index:on|off 

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

Parameter

Parameter	Beschreibung
/collection:CollectionURL	Gibt den URI der Teamprojektauflistung an.Das Format für den URI sieht folgendermaßen aus: http://Servername:Port/NameDesVirtuellenVerzeichnisses/Auflistungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://Servername:Port/Auflistungsname
/n:RefName /n:Name	Der Verweisname eines Felds des Typs Arbeitsaufgabe.
/index	Gibt an, ob die Indizierung für das angegebene Feld aktiviert oder deaktiviert werden soll.Geben Sie on an, um die Indizierung zu aktivieren, bzw. off, um sie zu deaktivieren.
/name:NewName	Gibt den neuen Namen für das Feld an.
/syncnamechanges	Gibt an, dass das Arbeitsaufgabenfeld zum Speichern von Namen und zur Aktualisierung bei Änderungen in Active Directory oder in einer Arbeitsgruppe verwendet werden sollen.Diese Option ist nur gültig, wenn ein Feld mit dem Datentyp "Zeichenfolge" als typename angegeben wird. Geben Sie true an, um die Synchronisierung für das Datenfeld zu aktivieren. Geben Sie false an, um die Synchronisierung für das Datenfeld zu deaktivieren.
/reportingname:ReportingName	Gibt den Namen des Felds im Data Warehouse an, das zur Berichterstellung verwendet werden soll.
/reportingrefname:ReportingRefName	Gibt den Verweisnamen des Felds im Data Warehouse an, der zur Berichterstellung verwendet werden soll.
/reportingtype:Type	Dient zum Angeben der Verwendung des Felds im Warehouse für die Berichterstellung.Folgende Werte sind gültig: dimension: Wird für Felder vom Typ Integer, String oder DateTime verwendet. detail: Wird für Felder vom Typ Integer, Double, String oder DateTime verwendet. measure: Wird für Felder vom Typ Integer und Double verwendet.Der Standardaggregationstyp ist "sum".Sie können mit dem formula-Parameter einen anderen Aggregationstyp angeben. disable: Wird verwendet, um die Berichtsmöglichkeit im Feld zu deaktivieren. Weitere Informationen finden Sie unter Arbeiten mit Arbeitsaufgabenfeldern.
/reportingformula:Formula	Gibt die Aggregationsformel an, die zu verwenden ist, wenn das Feld als measure gemeldet wird.sum ist die einzige unterstützte Formel.
/type:HTML | PlainText	Gibt an, die Inhalte des Felds von PlainText nach HTML oder von HTML nach PlainText zu konvertieren.Sie können diese Option nur für Felder angeben, deren Typzuweisung PlainText oder HTML ist.Siehe FIELD (Definition)-Element.
/unused	Führt alle Felder auf, die von keinem in der Teamprojektauflistung definierten Teamprojekt verwendet werden.
/noprompt	Deaktiviert die Eingabeaufforderung zur Bestätigung.
/?or help	Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Indizierte Felder

Ein Abfragenindex wird auf Grundlage der Felder mit aktivierter Indizierung erstellt.Dieser Index verbessert die Antwortzeit, wenn Abfragen ausgeführt werden, die indizierte Felder enthalten.

Standardmäßig werden die folgenden Felder indiziert: Zugewiesen an, Datum der Erstellung, Geändert von, Zustand, Grund, Bereichs-ID, Iterations-ID und Arbeitsaufgabentyp.Wenn das Team in seinen Abfragen häufig andere Felder verwendet, können Sie diese dem Abfragenindex hinzufügen.

Synchronisieren von Personennamen mit Active Directory

Jedes benutzerdefinierte Arbeitsaufgabefeld für die Zuweisung von Personennamen, die auf Active Directory verweisen, muss manuell synchronisiert werden.Außerdem müssen Sie die Synchronisierung für alle Felder jeder Teamprojektsammlung aktivieren, die die benutzerdefinierten Felder enthält.

Alle Systemverweisfelder, die Personennamen anzeigen, verfügen über das Attribut syncnamechanges, das auf true festgelegt ist. Diese Felder schließen System.AuthorizedAs, System.AssignedTo, System.ChangedBy und System.CreatedBy ein. Die Synchronisierung ist für jedes Personennamefeld, das in einer der Standardprozessvorlagen definiert ist, aktiviert.Weitere Informationen finden Sie unter Feldverweis für Zuweisungen und Workflow.

Nachdem die Synchronisierung aktiviert wurde, zeigt das Feld keine statische Zeichenfolge mehr an.Stattdessen zeigt das Feld den Namen an, der einem Benutzerkonto zugeordnet ist.Wenn Sie den Benutzernamen unter Active Directory oder in der Arbeitsgruppe ändern, zeigt ein Feld mit der Einstellung true für syncnamechanges automatisch den neuen Namen an.

Wenn Sie einem Zeichenfolgenfeld das syncnamechanges-Attribut zuweisen, akzeptiert das Feld immer gültige Benutzernamen.Das Feld lässt jedoch keine Gruppennamen zu, die in Team Foundation Server oder Active Directory gespeichert sind, wenn irgendeine der folgenden Bedingungen true ist:

• Die VALIDUSER-Regel wird übergreifend für alle Arbeitsaufgabentypen angegeben.

• Die VALIDUSER-Regel wird für einen Arbeitsaufgabentyp angegeben.

• Die ALLOWEDVALUES-Regel wird für einen Arbeitsaufgabentyp angegeben, und diese Regel besitzt ein Filterkriterium, das Gruppen ausschließt.

Weitere Informationen finden Sie unter XML-Elementreferenz für FIELD.

Attribute, die Sie für jeden Arbeitsaufgabentyp ändern können

Sie ändern die folgenden für ein Feld definierten Attribute oder Werte, indem Sie die Definition der Arbeitsaufgabentypen ändern, in der das Feld angezeigt wird:

• Name, der auf dem Arbeitsaufgabenformular angezeigt wird.Siehe XML-Elementreferenz für Control.

• Hilfetext.Siehe Definieren des Hilfetexts für ein Arbeitsaufgabenfeld.

• Zulässige Werte oder Elemente in einer Auswahlliste oder einem Dropdownmenü.Siehe Definieren von Benutzerlisten, Auswahllisten und globalen Listen.

Beispiele

Falls nicht anders angegeben, gelten in jedem Beispiel die folgenden Werte:

• URI für die Teamprojektauflistung: http://AdventureWorksServer:8080/tfs/DefaultCollection

• Name des Arbeitsaufgabenfelds: AdventureWorks.Field

• Standardcodierung: UTF-8

Auflisten von Feldern

Verwenden Sie witadmin listfields, um den verwendeten Satz von Feldern anzuzeigen und eins auszuwählen, das einem Arbeitsaufgabentyp hinzugefügt wird.Außerdem können Sie die für ein bestimmtes Feld definierten Attributzuweisungen aufführen und bestimmen, welche Felder von welchen Teamprojekten verwendet werden.

Anzeigen der Attribute eines Arbeitsaufgabenfelds

• Geben Sie den folgenden Befehl ein, um die Attribute aufzulisten, die für ein bestimmtes Feld, z. B. Microsoft.VSTS.Common.Issue, definiert werden.

  witadmin listfields /collection:http://AdventureWorksServer: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 Use-Parameter gibt den Namen der einzelnen Projekte und den Arbeitsaufgabentyp an, in dem das Feld verwendet wird.Weitere Informationen über Feldattribute finden Sie unter Arbeitsaufgabenfeldverweis für Visual Studio ALM.

Aufführen aller Felder in einer Teamprojektauflistung

• Geben Sie den folgenden Befehl ein, um alle Felder aufzulisten, die für eine Teamprojektauflistung definiert sind.

  witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
  

  Feldinformationen werden für alle Felder der benannten Projektauflistung angezeigt.Siehe Arbeitsaufgabenfeldverweis für Visual Studio ALM.

Auflisten nicht verwendeter Felder

• Geben Sie den folgenden Befehl ein, um die Felder aufzulisten, die in der Teamprojektauflistung von keinem Arbeitsaufgabentyp mehr verwendet werden.

  witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused
  

  Die Feld- und Attributinformationen werden, wie im folgenden Beispiel veranschaulicht, für jedes Feld angezeigt, das nicht verwendet wird.

  Field: Microsoft.VSTS.CMMI.TaskType
  Name: Task Type
  Type: String
  Reportable As: dimension
  Use: Not In Use
  Indexed: False
  
  Field: Microsoft.VSTSUE.Common.Flag
  Name: Flag
  Type: String
  Reportable As: dimension
  Use: Not In Use
  Indexed: False
  
  Field: Microsoft.VSTSUE.Common.Progress
  Name: Progress
  Type: String
  Reportable As: dimension
  Use: Not In Use
  Indexed: False
  

Umbenennen eines Felds

Sie können den Anzeigenamen eines Arbeitsaufgabenfelds ändern, damit es den Benennungskonventionen in Ihrem Team folgt.Beachten Sie, dass der neue Name für alle Arbeitsaufgabentypen übernommen wird, die das geänderte Feld in allen Teamprojekten in der Projektauflistung als Verweis haben.Der Anzeigename wird angezeigt, wenn Sie Filterkriterien in einer Arbeitsaufgabenabfrage definieren.Der Name, der in einem Arbeitsaufgabenformular angezeigt wird, kann sich von dem für dieses Feld definierten Anzeigenamen unterscheiden.

So benennen Sie eine Arbeitsaufgabenfeld um

1. Geben Sie den folgenden Befehl ein, um den Anzeigenamen, der Microsoft.VSTS.Common.Rank zugewiesen wurde auf "Important Rank" zu ändern.

   witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"
   

2. Geben Sie an der Eingabeaufforderung zur Bestätigung y ein, und drücken Sie die EINGABETASTE.Warten Sie, bis die folgende Meldung angezeigt wird:

   Field renamed.

So überprüfen Sie die in ein einzelnes Projekt importierten Änderungen

1. Wählen Sie in Team Explorer die Option Aktualisieren aus.

   Die letzten Updates werden vom Server heruntergeladen, darunter auch die Änderungen, die Sie gerade am Feldnamen vorgenommen haben.Warten Sie einige Sekunden bis die Aktualisierung beendet ist.

2. Wählen Sie Neue Abfrage zum Erstellen einer Abfrage.

3. Wählen Sie im Abfrage-Editor den Link Klicken Sie hier, um eine Klausel hinzuzufügen aus, um eine Zeile hinzuzufügen. Wählen Sie die leere Zelle Feld aus, und geben Sie in diese Zelle "Rank" ein.Die folgende Meldung, die oberhalb der Ergebnisliste angezeigt wird.Diese Meldung gibt an, dass Rank nicht gefunden werden kann.

   Führen Sie die Abfrage aus, um sich die Abfrageergebnisse anzeigen zu lassen. TF51005: Die Abfrage verweist auf ein Feld, das nicht vorhanden ist.Der Fehler wird durch <<Rank>> verursacht.

4. Löschen Sie den Wert Rank aus der Zelle Feld, und geben Sie in die Zelle "Important Rank" ein.

5. Wählen Sie in der Zelle Operator die Option < > aus, und geben Sie in die Zelle Wert den Wert "1" ein.

6. Wählen Sie auf der Symbolleiste Abfrage die Option Ausführen aus.

7. Öffnen Sie das Kontextmenü für jede Zeile in den Ergebnissen, und wählen Sie die Spaltenoptionen aus.Führen Sie in der Liste VerfügbareSpalten einen Bildlauf nach unten durch.Das Feld Rank ist nicht mehr vorhanden, dafür wird nun das Feld Important Rank angezeigt.

8. Wählen Sie im Feld Verfügbare Spalten die Option Important Rank aus, und klicken Sie dann auf die Schaltfläche > (Hinzufügen der ausgewählten Spalten).Klicken Sie auf OK.

   Der angezeigte Name für Microsoft.VSTS.Common.Rank wurde im Abfrage-Generator und den Ergebnislisten von "Rank" in "Important Rank" umbenannt.

9. Schließen Sie die Abfrage.Wählen Sie Nein aus, wenn Sie zum Speichern der Abfrage aufgefordert werden.

10. Erstellen Sie eine neue Arbeitsaufgabe für eine Aufgabe.Wählen Sie den Link Neue Arbeitsaufgaben aus, und klicken Sie dann auf Aufgabe.

    Diese Arbeitsaufgabe wird aus dem von Ihnen geänderten und importierten Arbeitsaufgabentyp erstellt.

11. Beachten Sie, dass sich die Bezeichnung für das umbenannte Feld Rank im Feld Status nicht geändert hat.Das liegt daran, dass sich die Feldbezeichnungen auf dem Arbeitsaufgabenformular auf das übergeordnete Teamprojekt beziehen und nicht von dem eben angegebenen serverweit gültigen Feldnamen abhängig sind.

    Hinweis
    Weitere Informationen zum Ändern von Feldbezeichnungen in Arbeitsaufgabenformularen finden Sie unter Ändern der Bezeichnung für ein Feld.

12. Schließen Sie die neue Aufgabe, und wählen Sie Nein aus, wenn Sie zum Speichern der Arbeitsaufgabe aufgefordert werden.

Ändern des Berichts als Wert für ein Feld

Der folgende Befehl spezifiziert die Berichtsmöglichkeit für den Typ des DateTime-Felds "AdventureWorks.CreatedOn" gegenüber Dimension.Die Daten dieses Felds gelangen in die Warehouse- und Analysis Services-Datenbanken, damit sie zum Filtern von Berichten verwendet werden können.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

Der folgende Befehl spezifiziert die Berichtsmöglichkeit für den Typ des Double-Felds "AdventureWorks.Field" gegenüber Measure.Alle Measures werden durch SUM aggregiert.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Aktivieren der Synchronisierung eines benutzerdefinierten Namensfelds

Der folgende Befehl aktiviert die Synchronisierung für das Arbeitsaufgabenfeld "AW.CustomerName", das für Collection1 auf dem AdventureWorksServer definiert wurde.

Überprüfen des Datentyps des Felds, das Sie konvertieren möchten

• Überprüfen Sie den Datentyp, der dem Feld, das Sie synchronisieren möchten, zugewiesen ist, beispielsweise MyCompany.CustomerName, indem Sie den folgenden Befehl eingeben:

  witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName
  

Aktivieren der Synchronisierung

1. Um die Synchronisierung für ein Personennamenfeld zu aktivieren, geben Sie den folgenden Befehl ein, und ersetzen Sie die Daten mit den hier angezeigt Argumenten:

   witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true
   

2. Die folgende Aufforderung zur Bestätigung wird angezeigt:

   This will change properties for field {0} on the Team Foundation Server.Do you want to continue?

3. Geben Sie 0 ein, um zu bestätigen, dass Sie das Feld ändern möchten, oder 1, um die Anforderung abzubrechen.

   Wenn die Änderungsanforderung erfolgreich ist, wird die folgende Bestätigungsmeldung angezeigt:

   The field was updated.

   Wenn die Änderungsanforderung fehlschlägt, wird eine Fehlermeldung angezeigt.Häufige Fehler sind das versuchte Ändern eines Systemverweisfelds oder eines Felds, das einen anderen Datentyp als "Zeichenfolge" hat.Diese Schritte werden nicht unterstützt.

Löschen eines Felds

Bevor Sie ein Feld löschen, überprüfen Sie, ob das Feld nicht verwendet wird.Wenn das Feld verwendet wird, müssen Sie es vor dem Löschen aus der Teamprojektauflistung aus den Arbeitsaufgabentypen, die das Feld verwenden, entfernen.Der folgende Befehl löscht das Feld "AdventureWorks.Field" aus Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Überprüfen, dass ein Feld nicht verwendet wird

1. Geben Sie den folgenden Befehl ein, und geben Sie die Verweisnamen für das Arbeitsaufgabenfeld an, beispielsweise MyCompany.MyProcess.MyField.

   witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField
   

   Überprüfen Sie in den angezeigten Informationen für das Feld, dass der Wert von Use wie im folgenden Beispiel "Not In Use" lautet.

   Field: MyCompany.MyProcess.MyField
   Name: MyField
   Type: String
   Reportable As: dimension
   Use: Not In Use
   Indexed: False
   

2. Wenn aus der Angabe unter Use hervorgeht, dass das Feld verwendet wird, müssen Sie das Feld aus allen Arbeitsaufgabentypen der aufgeführten Teamprojekte löschen.Beispielsweise gibt das Feld "Microsoft.VSTS.TCM.SystemInfo" an, dass es vom Arbeitsaufgabentyp "Fehler" und vom Arbeitsaufgabentyp "Codefehler" für vier Projekte verwendet wird: Arroyo, Desert, Palm und Springs.

   Field: Microsoft.VSTS.TCM.SystemInfo
   Name: System Info
   Type: Html
   Reportable As: None
   Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)
   Indexed: False
   

   Bevor Sie dieses Feld löschen können, müssen Sie es aus allen aufgeführten Arbeitsaufgabentypen für alle Teamprojekte löschen, für die es definiert wurde.Um das Feld zu entfernen, ändern Sie die Definition für den Arbeitsaufgabentyp, indem Sie die FIELD und Control-Elemente mit den Feldverweisnamen löschen.Siehe Anpassen und Verwalten von Arbeitsaufgabentypen [witadmin], FIELD (Definition)-Element und XML-Elementreferenz für Control.

Löschen eines Felds aus einer Teamprojektauflistung

• Geben Sie zum Löschen des Felds "MyCompany.MyProcess.MyField" den folgenden Befehl ein, und betätigen Sie dann die EINGABETASTE.

  witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName
  

  Geben Sie an der Eingabeaufforderung zur Bestätigung y ein, um diesen Schritt abzuschließen.

Siehe auch

Konzepte

Lösen von Schemakonflikten im Data Warehouse

Hinzufügen und Ändern von Arbeitsaufgabenfeldern zum Unterstützen von Berichten

Arbeitsaufgabenfeldverweis für Visual Studio ALM

Referenz zu berichtsfähigen Feldern für Visual Studio ALM

Weitere Ressourcen

witAdmin: Anpassen und Verwalten von Objekten für die Nachverfolgung von Arbeitsaufgaben