使用工作项字段

  • 项目

使用工作项字段可以跟踪工作项类型的数据、定义查询筛选条件以及生成报告。 任何数据元素，除核心系统数据在 Team Foundation Server (tfs) 字段，要跟踪，用于定义工作流，或者必须定义在工作项类型窗体中显示为工作项字段。 可以在工作项类型或全局工作流的定义中定义工作项字段。

每个团队项目集合维护自己的工作项字段。 执行下列任务之一时添加字段：

  • 创建团队项目。 将创建在工作项类型或全局工作流的定义中定义的所有字段，以及为选定的过程模板定义的所有字段。 对于为团队项目定义的每种工作项类型，系统会自动为其定义核心系统字段。 有关这些字段的列表，请参见工作项字段参考 (Visual Studio ALM)。

  • 导入工作项类型的定义。 工作项类型定义中定义的所有新字段都将添加到该集合中。 有关更多信息，请参见所有 WITD XML 元素参考。

  • 导入全局工作流定义。 全局工作流中定义的所有新字段都将添加到该集合中。 若要维护一组由多种类型的工作项共享的工作项字段，可以定义全局工作流。 有关更多信息，请参见自定义全局工作流。

  • 项目集合映射到 project Web App 实例 (PWA)。 在安装 project server 后 Team Foundation Server 扩展，请通过映射 Team Foundation各种元素配置集成。 映射集合时，将导入支持 Project Server 字段中一些字段的全局工作流定义。 有关更多信息，请参见为支持数据同步而添加的 Project Server 字段。

在所有团队项目的所有工作项类型和全局工作流中定义的所有字段构成了为该集合定义的完整字段集合。 可以更改现有字段的特性，也可以重命名和删除现有字段。 但是，进行这些更改时会产生一些费用。 有关更多信息，请参见自定义项目跟踪数据、窗体、工作流及其他对象。

添加或自定义集合的字段，请修改工作项类型或全局工作流的定义的 XML 内容。 通过在定义的 FIELDS 节中的一个 FIELD 元素定义每个字段工作项类型或全局工作流的。 有关该结构和这些文件位置的信息，请参见所有 WITD XML 元素参考和自定义全局工作流。

主题内容

  • FIELD（定义）语法结构

  • 字段数据类型

  • 指派给字段的可报告特性

  • 索引字段

  • FIELD（定义）子元素

  • 系统字段和预定义字段

FIELD（定义）语法结构

每个 FIELD（定义）元素都有一个可选的友好名称和一个必选的引用名称。 引用名称在该集合中必须是唯一的。 有关更多信息，请参见工作项跟踪对象的命名约定。

重要

使用 witadmin changefield 命令行工具可更改字段的友好名称。但是，如果重命名字段，则会影响该集合中所有团队项目的所有工作项类型。

通过在定义文件的以下 XML 语法定义字段的工作项类型。

<FIELD name="fieldDisplayName"
   refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID"
   syncnamechanges="true | false"
   reportingname="reportingDisplayName"
   reportingrefname="reportingReferenceName"
   reportable="Dimension | Detail | Measure" 
   formula="sum" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

有关更多信息，请参见FIELD（定义）元素。

返回页首

字段数据类型

字段的类型定义字段中可存储的数据的种类和大小。 字段只能对团队项目集合中定义的类型。 此限制促使组织在项目和工作项类型中使用通用字段。

下面的列表显示了受支持的字段类型：

数据类型

描述

DateTime

根据协调世界时 (UTC) 时刻指定日期。

使用 FieldControl 或 DateTimeControltype 属性，添加一个 DateTime 字段添加到工作项窗体。

Double

指定浮点值。 Double 字段通常用在查询筛选器和结果列表中。

使用 FieldControltype 属性，添加一个 Double 字段添加到工作项窗体。

GUID

指定将包含一个唯一标识符的字段。

您不能向工作项窗体中添加 GUID 字段。

History

支持查看讨论线索和跟踪其他历史记录信息。

说明说明
System.History 字段是使用此数据类型的唯一字段。不能使用此数据类型定义自定义字段。

添加 System.History 字段添加到工作项窗体中使用支持 RTF 格式控件的 WorkItemLogControltype 属性。

HTML

支持捕获 RTF 格式数据和使用更长的文本描述（如工作项描述）的功能。 HTML 字段有别于 PlainText 字段，因为 HTML 字段强类型化为 HTML，以便以更丰富的形式显示信息。

使用 HTMLControltype 属性，添加一个 HTML 字段添加到工作项窗体，支持 RTF 格式控件。

Integer

指定 32 位有符号整数值。 Integer 字段通常用在查询筛选器和结果列表中。

使用 FieldControltype 属性，添加一个 Integer 字段添加到工作项窗体。

PlainText

支持输入可包含超过 255 个 Unicode 字符的文本字符串。

添加一个 PlainText 字段添加到工作项窗体中使用 FieldControl 类型属性和限于纯文本或支持 RTF 格式控件的 HTMLControltype 属性。

String

支持输入最多可包含 255 个 Unicode 字符的文本字符串。 String 字段用于标签或者其他最长为一行的短文本字符串。 String 字段通常用在查询筛选器和结果列表中。

使用 FieldControltype 属性，添加一个 String 字段添加到工作项窗体。

TreePath

指定用于在分层结构或树结构中显示条目的字段，例如显示产品的区域和迭代路径的要求。

说明说明
只有 System.AreaPath 和 System.IterationPath 字段使用此数据类型。不能使用此数据类型定义自定义字段。

使用 WorkItemClassificationControl type 特性，添加 System.AreaPath 和 System.IterationPath 字段添加到工作项窗体。

返回页首

指派给字段的可报告特性

某些字段值在报告时特别有用。 通过使用工作项类型定义语言，您可以指定以下可选特性：

  • reportable. 设置是否可报告特性设置为 None、Detail、Dimension或 Measure，开始，并希望如何在报告中包括字段。 具有此特性的值（None 除外）的字段中的数据将导出到数据仓库，并且可以包括在报告中。

    向工作项类型中添加现有字段时，将使用 reportable 特性的当前值。 向工作项类型中添加字段时，除非使用 reportable 特性显式指定报告，否则将禁用报告。

  • reportingname. 分配一个不同的标签。使用的字段，数据在报告中显示。 如果未指定值，则将使用为 name 特性分配的友好名称。

  • reportingrefname. 分配一个不同的引用名称。使用的字段，数据导出到关系数据仓库时导出。 如果您未指定值，则将使用分配给 refname 特性的值。

    使用此属性设置为合并或分离报表中包含的字段。 若要合并两个具有不同的引用名称且在不同的项目集合中定义的字段，请为这两个字段分配同一 reportingrefname。 若要分离两个具有相同的引用名称但在不同的项目集合中定义的字段，请为每个字段分配一个不同的 reportingrefname。

定义字段后，可以在命令提示符处使用 witadmin changefield 命令更改除 refname 特性之外的所有特性的值。

有关出于报告目的而标记字段的最佳做法的信息，请参见添加和修改工作项字段以支持报告。

返回页首

ms194980.collapse_all(zh-cn,VS.110).gifreportable 特性值

如下表所述，您可以向 reportable 特性分配以下值之一：none、dimension、detail 和 measure。

备注

可以在将字段用于工作项之后再为其指定 reportable 属性。设置 reportable 值之后，复制到仓库的工作项的新修订将包含该字段值。但是，对于仓库中的已有修订，则不会使用现有值回填。

特性值

描述

Detail

Detail 类型仅用于 Integer、Double、String 或 DateTime 字段。

该字段中的数据会移动到关系仓库数据库的“工作项”和“当前工作项”表中，但不会移动到 SQL Server Analysis Services 多维数据集中。 通过将此类型用于无限制的文本字段，您可以在报告中使用这些字段，而不会使多维数据集过大。

Dimension

Dimension 类型仅用于 Integer、Double、String 或 DateTime 字段。

此字段中的数据将作为工作项维度的特性进入到关系仓库数据库和 Analysis Services 多维数据集，以便可以使用这些数据来筛选报告。 将此类型用于包含有效值列表的字段。 dimension 类型的一个典型示例是“工作项类型”。

Measure

Measure 类型仅用于 Integer 和 Double 字段。 Measure 是报告中的数值型的值。

在 Analysis Services 多维数据集的处理过程中，设置为 Measure 的字段上的数据将预先计算。 例如，“工作项”和“当前工作项”度量值组包含以下字段的累计数据：初始估计、剩余小时数和已完成小时数。 有关度量值组的更多信息，请参见Analysis Services 多维数据集中提供的透视和度量值组 (Team System)。

指定 Measure 时，必须为 formula 特性指定 sum，以返回在查询中引用的每个度量值的总和。

None

当不希望在报告中包含字段时，请指定 None。 此值为默认分配值。

返回页首

ms194980.collapse_all(zh-cn,VS.110).gif演示如何指定报告的示例

详细信息示例

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

维度示例

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

度量值示例

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

索引字段

使用 witadmin indexfield 命令来对工作项字段启用或禁用索引。 为字段启用索引后，查找在查询中指定了该字段的工作项时可提高性能。 如果添加了在许多工作项查询中都使用的自定义字段，您可能要为该字段启用索引。 有关更多信息，请参见管理工作项字段 [witadmin]。

返回页首

FIELD（定义）子元素

可为工作项字段指定许多可选子元素，例如：

  • 帮助文本。 定义为工作项窗体中的字段显示的工具提示或帮助信息 (HELPTEXT)。

  • 字段限制。 将字段指定为必选、只读、为空、已冻结或匹配特定模式（REQUIRED、READONLY、EMPTY、FROZEN、MATCH）。

  • 字段值自动填充。 为字段（DEFAULT、COPY、SERVERDEFAULT）指定一个值。

  • 字段列表. 指定允许值、建议值或禁止值。 (ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

  • 字段条件. 在其他字段已更改或未更改、其他字段具有或不具有特定值时或在其他条件下（WHEN、WHENNOT、WHENCHANGED、WHENNOTCHANGED、CANNOTLOSEVALUE、 NOTSAMEAS），对字段应用一个或多个规则。

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

返回页首

系统字段和预定义字段

所有系统定义字段的引用名称都以 System 开头，例如 System.AreaPath、System.AssignedTo，后面的部分仍然采用该模式。

该默认值定义的预定义字段处理 TFS 提供以 Microsoft.VSTS 开头的模板进一步然后根据它们的用法。 下面是通常用于计划用途以及用于与 Microsoft Project 集成、与 Team Foundation Build 集成和与 Team Foundation 集成的预定义字段示例：

  • Microsoft.VSTS.Common.Priority

  • Microsoft.VSTS.Scheduling.DueDate

  • Microsoft.VSTS.Build.FoundIn

  • Microsoft.VSTS.TCM.Steps

对于为默认值定义所有系统字段和预定义字段的概述进程 TFS 提供的模板，请参见 工作项字段参考 (Visual Studio ALM)。 有关指定字段名称的更多信息，请参见工作项跟踪对象的命名约定。

返回页首

隐藏的和不可更改的属性以及工作项字段资源管理器

除了可为工作项字段更改的属性外，还有每个字段的许多非可更改和实际上隐藏的属性。 使用工作项字段资源管理器工具，您可以查阅这些字段的分配。 访问从过程编辑器增强工具的工作项字段资源管理器工具。

工作项字段资源管理器

工作项字段资源管理器

备注

过程编辑器增强工具为自定义 Team Foundation 提供的图形用户界面服务器进程模板。您可以使用此工具导入和导出工作项类型，修改过程模板的内容和测试为团队项目集合定义的字段集。有关更多信息，请参见 Microsoft 网站上的以下页面：Team Foundation server 增强工具.

请参见

参考

管理工作项字段 [witadmin]

概念

自定义工作项跟踪和团队项目

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

All FIELD XML 元素引用

其他资源

定义工作项字段