FieldDefinition 复杂类型（WORKITEMTYPE 元素）

  • 项目

更新：2007 年 11 月

定义 FIELD 元素中的元素和组。

<xs:complexType name="FieldDefinition">
        <xs:sequence minOccurs="0">
                <xs:group ref="PlainRules" minOccurs="0" maxOccurs="unbounded"/>
                <xs:element name="HELPTEXT" type="HelpTextRule" minOccurs="0" maxOccurs="1"/>
                <xs:group ref="PlainRules" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
        <xs:attribute name="name" type="typelib:FieldName" use="required"/>
        <xs:attribute name="refname" type="typelib:ReferenceFieldName" use="required"/>
        <xs:attribute name="type" type="FieldType" use="required"/>
        <xs:attribute name="reportable" type="Reportability" use="optional"/>
        <xs:attribute name="formula" type="MeasureFormula" use="optional"/>
</xs:complexType>

属性和元素

下面几部分描述了属性、组、子元素和父元素。

属性

属性

说明

name

必需的属性。

应用该规则和条件处的字段的显示名称。属性类型为 typelib:FieldName。最小长度：1；最大长度：128。

模式值：^[^\.\[\]]+$

模式值示例：指派给

有关更多信息，请参见字段名。

refname

必需的属性。

应用规则和条件的工作项字段的引用名称。引用名称必须与字段定义的 FIELD 元素中所定义的引用名称相匹配。属性类型为 typelib:ReferenceFieldName。最小长度：1；最大长度：70。

模式值：^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

模式值示例：公司.部门.问题类型

有关更多信息，请参见字段引用名。

type

必需的属性。

字段接受的值的类型。属性类型为 FieldType 简单类型（工作项类型定义架构），限于以下值：

  • String

  • Integer

  • Double

  • DateTime

  • PlainText

  • HTML

  • TreePath

  • History

限制基为 xs:string。

有关更多信息，请参见字段类型。

reportable

可选的属性。

来自该字段的数据将被导出到数据仓库并且可以包括在报表中。属性类型为 Reportability 简单类型（工作项类型定义架构），限于以下值：

  • 维度

  • 详细信息

  • 度量

限制基为 xs:string。

有关更多信息，请参见在报告中使用字段。

formula

可选的属性。

可报告值 measure 的聚合类型。sum 是目前唯一受支持的 measure 聚合类型。限制基为 xs:string。

子元素

元素

说明

HELPTEXT 元素（工作项类型定义架构）

可选的元素。

定义显示在字段的工具提示中的文本。

父元素

无

备注

FieldDefinition 复杂类型为 FIELD 元素（WORKITEMTYPE 元素）类型。

组

组

说明

PlainRules 组（工作项类型定义架构）

可选的组。

包括指定要在 FIELD 元素中使用的规则和条件的 Rules 组（工作项类型定义架构）和 Conditions 组（工作项类型定义架构）。

元素信息

命名空间

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

架构名称

工作项类型定义

验证文件

WorkItemTypeDefinition.xsd

是否可以为空

不适用

请参见

参考

witfields

其他资源

工作项类型定义架构

定义工作项类型字段