定义工作项字段

可以使用工作项字段跟踪工作项类型的数据、定义查询的条件以及设计报表。您可以自定义如何使用工作项类型的预定义工作项字段,也可以创建支持其他数据跟踪要求的字段。对于该默认值中定义的字段索引进程 Team Foundation Server的模板,请参见 工作项字段参考 (Visual Studio ALM)

以下为您希望自定义工作项字段的原因:

  • 更改字段标签以符合团队的命名约定。

  • 添加或修改字段的特性。

  • 指定默认值,或控制用户可设置的字段值。

  • 限制可以修改字段的用户。

  • 添加字段以捕获特定于团队过程或跟踪要求的数据。

  • 定义或自定义选取列表。

  • 将选取列表替换为全局列表,以便在各组之间保持一致性并便于维护。

工作项窗体使用字段来显示数据或者供用户输入数据或选择选项。通过在工作项类型定义中定义工作项窗体中的字段,可以控制这些字段的外观和行为。

在工作项类型定义中,通过指定名称、引用名称和类型来定义字段。也可以定义字段以包括帮助文本,遵循相应规则,以及展示特定报告行为。通过使用全局工作流,可定义应用于为团队项目或集合定义的所有工作项类型的字段。可使用全局工作流来定义和更新影响团队项目或集合中所有工作项类型的字段规则。

每个团队项目集合维护自己的工作项字段。可以更改现有字段的特性,也可以重命名和删除现有字段。

字段元素语法

以下语法结构和特性定义字段:

<FIELD name="field display name" refname="field reference name" type="String | Integer | 
Double | DateTime | PlainText | HTML | History | TreePath | GUID " 
syncnamechanges="true | false" reportable="Dimension | Detail | Measure" formula="sum" 
indexable="true | false" >
</FIELD>

注意以下有关特性指定的信息:

  • 可指定需要的字段名称,并使之在不同的工作项定义中各不相同。所有字段数据都基于引用名称进行跟踪。

  • 类型特性指定字段的数据类型。有关每个数据类型的说明,请参见使用工作项字段。有关显示特定字段类型的控件的信息,请参见指定工作项窗体控件

  • 用于存储人员姓名的字符串字段应将 syncnamechanges 特性设置为 true。此设置指示字段的内容应随 Active Directory 或工作组中人员姓名的更改而进行更新。

  • Reportable 特性赋值为 Detail、Dimension 或 Measure 的字段会在数据仓库中进行跟踪。有关更多信息,请参见使用工作项字段

  • Indexable 特性设置为 True,以提高在筛选条件中指定该字段的查询的运行性能。如果添加了在许多使用您的工作项查询的自定义字段,您可能需要为该字段启用索引。

对于任何字段(除了系统字段),都可使用 witadmin 命令行工具更改字段名称以及 Reportable 和 Indexable 特性的赋值。有关更多信息,请参见管理工作项字段 [witadmin]

返回页首

常规任务

任务

相关主题

了解您可指定的字段类型和字段特性。您可以定义字段以存储特定类型的数据,如文本、数字或 HTML 内容。您还可以设置其他特性,具体取决于您希望如何使用数据字段来进行报告或查询。

查找 FIELD(定义)元素的语法。可使用 FIELD(定义)元素来定义工作项字段。可以使用一个或多个子元素来指定字段的行为、定义默认值或定义值的选取列表。可以组合字段规则元素。可将大多数规则应用于某个特定用户或组,或被某个特定用户或组忽略。

指定字段以执行用于跟踪过程的特定操作。Team Foundation 管理可用于跟踪所有工作项类型的系统字段。所有其他字段都通过工作项类型定义添加到团队项目集合中。工作项类型在已创建的团队项目的过程模板中指定,也可稍后将工作项类型导入团队项目。

为了获得最佳效果,如果已在使用的字段可满足跟踪项目的需要,您应指定这些字段。

指定字段值的行为、默认值或条件。可以设置字段规则,以便定义字段值的行为和约束。字段规则是 FIELD 元素容器内所列的附加元素。可以为字段、状态、转换、原因或全局工作流来定义字段规则。

定义列表项并根据需要设置这些项的条件。使用字段列表来枚举一组允许值、建议值和禁止值。您还可以为所有工作项类型定义全局列表。

返回页首

相关任务

任务

相关主题

了解对命名字段和其他工作项跟踪对象的限制。您可以为所有工作项跟踪对象指定一个友好名称,对于某些工作项跟踪对象还必须指定一个引用名称。这两种名称都必须满足基于对象类型定义的要求。

添加字段或修改现有字段的报告特性。可以添加字段或修改现有字段的特性来支持报告。添加或更改字段时,应系统地命名它们,以便您可以在 Analysis Services 多维数据集中查找字段,因为这些字段按逻辑分组到各个文件夹中。

定义由项目或集合的所有工作项类型使用的字段或列表。可通过将字段和枚举列表作为全局工作流进行定义来对它们进行定义和更新。

添加、移除或修改用于控制工作流的状态或转换。通过定义工作流的初始状态、有效状态、这些状态之间的有效转换以及有权执行这些转换的用户或组,可以控制该工作流。工作项类型的 WORKFLOW 节控制如何跟踪工作项。

修改并自定义某工作项类型的工作项窗体。通过相应工作项类型定义中的 FORM 节,可控制该工作项类型显示用户界面元素的方式。每个工作项类型必须有且只能有一个表单。您需要描述整个窗体,包括它的所有选项卡、字段和组。

返回页首

请参见

概念

Visual Studio ALM 的可报告字段参考

工作项字段参考 (Visual Studio ALM)

所有 WITD XML 元素参考

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

自定义项目跟踪数据、窗体、工作流及其他对象