重命名工作项类型字段

项目
08/12/2011

您可以使用 witadmin changefield 命令行工具更改工作项字段的友好名称，以符合团队使用的命名约定。请注意，在项目集合的所有团队项目中引用该更改字段的所有工作项类型都将应用该新名称。在工作项查询中定义筛选器条件时会显示友好名称。工作项窗体中显示的名称可能与为字段定义的友好名称不同。

若要查看为项目集合定义的字段的列表，请参见列出工作项字段并查看指派给这些字段的特性。

所需权限

若要执行此过程，您必须是**“Team Foundation Administrators (Team Foundation 管理员)”组的成员，或者是使用该字段的所有项目的“Project Administrators (项目管理员)”**组的成员。有关更多信息，请参见 Team Foundation Server 权限。

主题内容

重命名工作项字段的友好名称
确保更改显示在团队资源管理器中

重命名工作项字段的友好名称

重命名工作项字段

打开命令提示符窗口。
键入以下命令然后按 Enter，从而更改到包含要列出的工作项类型的目录。

cd ..驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE

若要重命名工作项字段，请键入以下内容，然后按 Enter。

witadmin changefield /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /n:typename /name:newname

例如：

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

此命令将 Microsoft.VSTS.Common.Rank 字段重命名为 Important Rank。

在确认提示时键入 y 并按 Enter。请等待，直到收到以下消息：

Field renamed.

有关更多信息，请参见管理工作项字段 [witadmin]。

确保更改显示在团队资源管理器中

验证导入到单个项目中的更改

在团队资源管理器中，右击包含已重命名字段的工作项类型所属的团队项目节点，然后单击**“刷新”**。

此时将从服务器下载最新更新，包括您刚刚对字段名称所做的更改。请等待几秒钟，直到刷新了**“工作项”节点。正在加载中的节点显示“正在工作”**。
右击**“工作项”节点，然后选择“添加查询”**创建一个查询。
单击标记为**“单击此处可添加一条子句”的区域以添加一行，选择空白“字段”**单元格，在该单元格中，键入“Rank”。注意显示在结果列表上方的以下消息。该消息指示无法找到“Rank”。

**运行查询以查看查询结果。**TF51005: 该查询引用了不存在的字段。该错误是由 <<Rank>> 引起的。
从**“字段”**单元格中删除“Rank”值，然后在该单元格中键入“Important Rank”。
选择**“运算符”单元格中的“<>”，然后在“值”**单元格中键入“1”。
在**“查询”工具栏上，单击 “运行”**。
右击结果中的任意一行并选择**“列选项”。在“可用列”列表中向下滚动。可以看到，“Rank”字段已不存在，但存在“Important Rank”**字段。
选择**“可用列”框中的“Important Rank”，然后单击“添加所选列”按钮（“>”）。单击“确定”**。

可以看到，在查询生成器和结果列表中，Microsoft.VSTS.Common.Rank 的友好名称都已从“Rank”重命名为“Important Rank”。
单击**“关闭”关闭查询。提示您保存查询时，请单击“否”**。
创建新的任务工作项。为此，右击**“工作项”节点，指向“添加工作项”，然后单击“任务”**。

此工作项是从您已更改并导入的工作项类型创建的。
注意，在**“状态”框中，重命名的字段“Rank”**的标签并未更改。这是因为工作项窗体上的字段标签针对的是父级团队项目，与刚才指定的服务器范围的字段名称无关。

提示

有关如何更改工作项窗体上的字段标签的更多信息，请参见更改字段的标签。
单击**“关闭”关闭新任务。提示您保存工作项时，请单击“否”**。