管理工作项字段

  • 项目

可以使用以下 witadmin 命令管理为团队项目集合定义的工作项类型字段：

  • deletefield：删除指定的字段。

  • listfields：列出所有字段或指定字段的特性。

  • indexfield：打开或关闭指定字段的索引。 为字段启用索引后，查找在查询中指定了该字段的工作项时可提高性能。 如果添加了在许多工作项查询中都使用的自定义字段，您可能要为该字段启用索引。

  • changefield：更改字段的一个或多个特性，例如友好字段名、用于数据仓库报告的特性，或同步包含人名的字段的功能。 如果启用了同步，则字段在对 Active Directory 或工作组做出更新时更新。 有关如何使用字段进行报告的信息，请参见使用工作项字段。

    重要说明重要事项

    从早期版本升级到当前版本后，对于所有包含人名的字符串字段，所有内置字段 syncnamechanges 特性设置为 true。 但是，您必须手动为用来存储用户名称以及要保持同步的任何自定义字段指定该特性。 有关更多信息，请参见 更新自定义人名字段以便与 Active Directory 或工作组同步。

在运行 团队资源管理器 的客户端计算机上，witadmin 命令行工具位于驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 中。 

有关字段的更多信息，请参见定义工作项字段。

提示

进程编辑器是 Visual Studio 的一个增强工具，您可以使用该工具创建或修改工作项字段。 此工具不受支持。 有关更多信息，请参见 Microsoft 网站上的以下页面：Team Foundation Server Power Tools April 2010（Team Foundation Server 增强工具 2010 年 4 月版）。

所需权限

对于定义工作项类型字段处的团队项目集合，您必须具有以下权限集：

  • 若要列出字段，您必须是**“Readers (访问者)”组的成员，或者将“查看此节点中的工作项”权限设置为“允许”**。

  • 若要删除或重命名字段或更改字段的报告特征，您必须是**“Team Foundation Administrators (Team Foundation 管理员)”安全组或“Project Administrators (项目管理员)”**安全组的成员。

有关更多信息，请参见Team Foundation Server 权限和Team Foundation Server 默认组、权限和角色。

提示

即使您是以管理权限登录的，也必须使用提升的权限打开命令提示符窗口，才能在运行 Windows Server 2008 的服务器上执行此功能。 若要使用提升的权限打开命令提示符窗口，请单击“开始”，右击“命令提示符”，然后单击“以管理员身份运行”。 有关更多信息，请参见以下 Microsoft 网站：User Access Control（用户访问控制）。

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

说明

/collection:CollectionURL

指定团队项目集合的 URI。 URI 的格式为：http://ServerName:Port/VirtualDirectoryName/CollectionName

如果未使用虚拟目录，则 URI 将为以下格式：

http://服务器名称:端口/集合名称

/n:RefName

/n:Name

工作项类型字段的引用名称。

/index

指定启用或禁用指定字段的索引。 指定 on 启用索引，指定 off 禁用索引。

/name:NewName

指定字段的新名称。

/syncnamechanges

指定将工作项字段用于存储名称，并随着 Active Directory 或工作组中所做的更改进行更新。 此选项只在为 typename 指定数据类型为字符串的字段时才有效。

指定 true 启用数据字段同步，指定 false 禁用数据字段同步。

/reportingname:ReportingName

指定用于报告的数据仓库中的字段的名称。

/reportingrefname:ReportingRefName

指定用于报告的数据仓库中的字段的引用名称。

/reportingtype:Type

指定在用于报告的仓库中字段的使用方式。 以下为有效值：

  • dimension: 用于 Integer、String 或 DateTime 字段。

  • detail:用于 Integer、Double、String 或 DateTime 字段。

  • measure:用于 Integer 和 Double 字段。 默认的聚合类型为 sum。 可以使用 formula 参数指定其他的聚合类型。

  • disable: 用于禁用字段上的可报告性。

有关更多信息，请参见使用工作项字段。

/reportingformula:Formula

指定在该字段报告为 measure 时要使用的聚合公式。 仅支持公式 sum。

/unused

列出团队项目集合中所定义的团队项目未能使用的所有字段。

/noprompt

禁用提示进行确认。

/? or help

在“命令提示符”窗口中显示有关命令的帮助。

备注

将 syncnamechanges 特性分配给字符串字段时，字段将始终接受有效用户名。 但是，如果下列任一条件为 true，则字段不允许存储在 Team Foundation Server 或 Active Directory 中的组名：

  • VALIDUSER 规则，在所有工作项类型中指定

  • VALIDUSER 规则，为工作项类型指定

  • 为工作项类型指定 ALLOWEDVALUES 规则，并且该规则包含已排除组的筛选条件

有关更多信息，请参见 All FIELD XML 元素引用。

有关编制索引的系统字段的摘要，请参见使用系统字段和 MSF 过程模板定义的字段。

示例

除非另外指定，否则下面的值适用于每个示例：

  • 团队项目集合的 URI：http://AdventureWorksServer:8080/AWTeam/Collection1

  • 工作项字段名称：AdventureWorks.Field

  • 默认编码：UTF-8

列出字段

下面的命令显示有关在 AdventureWorksServer 服务器上为 Collection1 定义的每个字段的信息：

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

下面的命令显示 Collection1 使用的指定字段 AdventureWorks.Field 的字段信息：

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

下面的命令显示 Collection1 不使用的所有字段：

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

重命名字段

下面的命令将为 Collection1 将所引用字段 AdventureWorks.Field 的友好名称更改为 NewFieldName：

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

更改字段的“报告为值”

下面的命令将报告 DateTime 字段 AdventureWorks.CreatedOn 类型的能力指定为 dimension。 此字段的数据进入该仓库和 Analysis Services 数据库，以使其可用于筛选报告。

witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.CreatedOn /reportingtype:dimension

下面的命令将报告 Double 字段 AdventureWorks.Field 类型的能力指定为 measure。 所有的 measure 均由 sum 聚合。

witadmin reportfield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AdventureWorks.Field /reportingtype:measure

启用自定义名称字段的同步

下面的命令为在 AdventureWorksServer 上为 Collection1 定义的工作项字段 AW.CustomerName 启用同步。

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

删除字段

下面的命令从 Collection1 中删除字段 AdventureWorks.Field：

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

请参见

任务

列出工作项字段并查看指派给这些字段的特性

概念

使用系统字段和 MSF 过程模板定义的字段

其他资源

解决数据仓库中发生的架构冲突

定义工作项字段

添加和修改工作项字段以支持报告

定义工作项字段

witAdmin：管理用于跟踪工作项的对象