witfields
Use the witfields command to administer work item type fields for Team Foundation Server.
 Note |
|---|
| Team Project Administrators may not be able to administer all the fields for Team Foundation Server. |
The witfields command-line utility is located in <drive >\Program Files\Visual Studio8\Common7\IDE on Team Explorer client computer.
witfields view /s:tfs [refname | /unused]
witfields rename /s:tfs refname newname
witfields report /s:tfs refname {dimension | detail | measure | disable}[:sum | :count | :distinctcount | :avg | :min | :max]
witfields delete /s:tfs refname
witfields rebuildcache /s:tfs
witfields help
Parameters
| Parameter | Description |
|---|---|
| /s: tfs | The computer name of the Team Foundation Server on which to view or edit fields, or a fully specified URL for a Team Foundation Server. |
| refname | The reference name of the field for which to perform the command. |
| /unused | Displays all fields that are not used by a work item type on Team Foundation Server. |
| newname | The new friendly name of the field. |
| dimension | Reportability type used for the Integer, String, or DateTime fields. No optional attribute should be specified. |
| detail | Reportability type used for the Integer, Double, String, or DateTime fields. No optional attribute should be specified. |
| measure | Reportability type used for the Integer and Double fields. The only supported aggregation type is sum. If another aggregation type is entered, it is converted to sum. |
| disable | Not supported in this version. |
| sum | Default aggregation type for measure. |
| count | Not supported in this version. |
| distinctcount | Not supported in this version. |
| avg | Not supported in this version. |
| min | Not supported in this version. |
| max | Not supported in this version. |
| help | Displays the witfields context help. |
| /? | Displays the witfields context help. |
The following command displays field information for all the fields on the Team Foundation Server AdventureWorksServer.
>witfields view /s:AdventureWorksServer
The following command displays the field information for the specified field AdventureWorks.Field.
>witfields view /s:AdventureWorksServer AdventureWorks.Field
The following command displays all fields that are not being used on the Adventure Works Team Foundation Server.
>witfields view /s:AdventureWorksServer /unused
This following command changes the friendly name of the referenced field AdventureWorks.Field to NewFieldName.
>witfields rename /s:AdventureWorksServer AdventureWorks.Field NewFieldName
The following command specifies the reportability type of the DateTime field AdventureWorks.CreatedOn to dimension. This field's data enters the warehouse and cube so that it can be used to filter reports.
>witfields report /s:AdventureWorksServer AdventureWorks.CreatedOn dimension
The following command specifies the reportability type of the Double field AdventureWorks.Field to measure. All measures are aggregated by sum.
>witfields report /s:AdventureWorksServer AdventureWorks.Field measure
The following command deletes the field AdventureWorks.Field from the Team Foundation Server AdventureWorksServer.
>witfields delete /s:AdventureWorksServer AdventureWorks.Field
The following command invalidates the metadata cache for all clients on the Team Foundation Server AdventureWorksServer. The client caches are updated the next time they connect to the server.
>witfields rebuildcache /s:AdventureWorksServer
The following commands display the context help for the witfields command-line utility.
>witfields help >witfields /?
