Verwalten von Arbeitsaufgabenfeldern

Artikel
08/10/2011

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

deletefield: Löscht das angegebene Feld.
listfields: Führt die Attribute für alle Felder oder ein angegebenes Feld auf.
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 Abfragen von Arbeitsaufgaben verwenden, empfiehlt es sich, die Indizierung für dieses Feld zu aktivieren.
changefield: Ändert ein oder mehrere Attribute eines Felds, z. B. den Anzeigenamen des Felds, Attribute für die Data Warehouse-Berichterstellung oder die Fähigkeit, ein Feld zu synchronisieren, das Personennamen enthält. Wenn die Synchronisierung aktiviert ist, wird das Feld aktualisiert, sobald Updates an Active Directory oder einer Arbeitsgruppe vorgenommen werden. Weitere Informationen darüber, wie Felder für die Berichterstellung verwendet werden, finden Sie unter Arbeiten mit Arbeitsaufgabenfeldern.

Wichtig

Wenn Sie ein Upgrade von einer früheren Version auf die aktuelle Version durchführen, werden alle integrierten Felder für alle Zeichenfolgenfelder mit Personennamen mit dem syncnamechanges-Attribut auf true festgelegt. Sie müssen jedoch allen benutzerdefinierten Feldern, mit denen Sie Personennamen speichern und die Sie synchronisiert haben möchten, das Attribut manuell zuweisen. Weitere Informationen finden Sie unter Aktualisieren benutzerdefinierter Personennamensfelder zum Synchronisieren mit Active Directory oder Arbeitsgruppen.

Das Befehlszeilentool witadmin befindet sich im Verzeichnis Laufwerk:\Programme\Microsoft Visual Studio 10.0\Common7\IDE auf dem Clientcomputer, der Team Explorer ausführt.

Weitere Informationen über Felder finden Sie unter Definieren von Arbeitsaufgabenfeldern.

Tipp

Mit dem Prozess-Editor, einem Powertool für Visual Studio, können Sie Arbeitsaufgabenfelder erstellen und bearbeiten. Dieses Tool wird nicht unterstützt. Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Team Foundation Server Power Tools April 2010 (möglicherweise in englischer Sprache).

Erforderliche Berechtigungen

Für die Teamprojektauflistung, in der die Arbeitsaufgabentypfelder definiert sind, müssen die folgenden Berechtigungen festgelegt sein:

Um Felder aufzulisten, müssen Sie Mitglied der Gruppe Readers sein, oder Ihre Berechtigung Arbeitsaufgaben in diesem Knoten anzeigen muss auf Zulassen festgelegt sein.
Um Felder zu löschen oder umzubenennen oder um die Berichtseigenschaften eines Felds zu ändern, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder der Sicherheitsgruppe Projektadministratoren sein.

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

Tipp

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. Klicken Sie zum Öffnen eines Eingabeaufforderungsfensters mit erhöhten Rechten auf Start, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. Weitere Informationen finden Sie auf der folgenden Microsoft-Website: Benutzerzugriffssteuerung.

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

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

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

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

Parameter

Parameter	Beschreibungen
/collection:CollectionURL	Gibt den URI der Teamprojektsammlung an. Das Format für den URI sieht folgendermaßen aus: http://ServerName:Port/VirtuellerVerzeichnisname/Auflistungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://Servername:Port/Auflistungsname
/n:RefName /n:Name	Der Verweisname eines Arbeitsaufgabentypfelds
/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 der 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	Gibt an, wie das Feld im Warehouse zur Berichterstellung verwendet wird. 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.
/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

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.

Eine Zusammenfassung der Systemfelder, die indiziert werden, finden Sie unter Verwenden von Systemfeldern und von den MSF-Prozessvorlagen definierten Feldern.

Beispiele

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

URI für die Teamprojektsammlung: http://AdventureWorksServer:8080/AWTeam/Collection1
Name des Arbeitsaufgabenfelds: AdventureWorks.Field.
Standardcodierung: UTF-8

Auflisten von Feldern

Der folgende Befehl zeigt Informationen zu jedem Feld an, das für Collection1 auf dem Server AdventureWorksServer definiert wurde:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Der folgende Befehl zeigt die Feldinformationen für das angegebene, von Collection1 verwendete Feld "AdventureWorks.Field" an:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

Der folgende Befehl zeigt alle Felder an, die Collection1 nicht verwendet:

witadmin listfields /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /unused

Umbenennen eines Felds

Mit dem folgenden Befehl wird der Anzeigename des Felds "AdventureWorks.Field", auf das verwiesen wird, für Collection1 in "NewFieldName" geändert:

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /name:NewFieldName

Ä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 das Warehouse und die Analysis Services-Datenbanken, damit sie zum Filtern von Berichten verwendet werden können.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /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/AWTeam/Collection1 /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.

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.CustomerName /syncnamechanges:true

Löschen eines Felds

Der folgende Befehl löscht das Feld "AdventureWorks.Field" aus Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field

Siehe auch

Freigeben über