FIELD 元素（WORKITEMTYPE 元素）

更新：2007 年 11 月

定义一个工作项字段，并指定应用到该字段的规则和条件。

架构层次结构

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

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

        FIELDS 元素（WORKITEMTYPE 元素）

            FIELD 元素（WORKITEMTYPE 元素）

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

属性和元素

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

属性

属性	说明
name	必需的 FieldDefinition 属性。 应用该规则和条件处的字段的显示名称。有关更多信息，请参见字段名。
refname	必需的 FieldDefinition 属性。 应用规则和条件的字段的引用名称。引用名称必须与字段定义的 FIELD 元素中所定义的引用名称相匹配。有关更多信息，请参见字段引用名。
type	必需的 FieldDefinition 属性。 字段接受的值的类型。有关更多信息，请参见字段类型。
reportable	可选的 FieldDefinition 属性。 来自该字段的数据将被导出到数据仓库并且可以包括在报表中。有关更多信息，请参见在报告中使用字段。
formula	可选的 FieldDefinition 属性。 measure 可报告类型的聚合类型。sum 是目前唯一受支持的 measure 聚合类型。有关更多信息，请参见 witfields。

子元素

元素	说明
HELPTEXT 元素（工作项类型定义架构）	可选。 定义工具提示中为此字段显示的文本。
REQUIRED 元素（工作项类型定义架构）	可选。 将此字段定义为必需字段。
READONLY 元素（工作项类型定义架构）	可选。 将此字段定义为只读。
EMPTY 元素（工作项类型定义架构）	可选。 将此字段定义为空。
FROZEN 元素（工作项类型定义架构）	可选。 将此字段定义为冻结。提交更改后，不能将冻结的字段更改为任何非空值。但是，您可以手动清除此字段，保存工作项，然后指定其他值。
CANNOTLOSEVALUE 元素（工作项类型定义架构）	可选。 将字段定义为不能丢失值。这意味着当前字段一旦获得值，就不得清除或为空。
NOTSAMEAS 元素（工作项类型定义架构）	可选。 指定另外一个字段，该字段的值不能与当前字段的值相同。
VALIDUSER 元素（工作项类型定义架构）	可选。 指定允许值列表必须仅包含系统中的有效用户。
ALLOWEXISTINGVALUE 元素（工作项类型定义架构）	可选。 将字段定义为允许使用现有值。也就是说，允许使用已存在的字段值，即使这些值无效也是如此。所有新的字段值都必须有效。
MATCH 元素（工作项类型定义架构）	可选。 为此字段定义一个模式，字段值必须与其匹配。
ALLOWEDVALUES 元素（工作项类型定义架构）	可选。 为此字段定义一个允许值的列表。允许的值指工作项窗体上以及查询生成器中的字段列表中可供选择的值。必须从这些值中选择一个。
SUGGESTEDVALUES 元素（工作项类型定义架构）	可选。 为此字段定义一个建议值的列表。建议的值指工作项窗体上以及查询生成器中的字段列表中可供选择的值。您可以输入列表中可用值以外的其他值。
PROHIBITEDVALUES 元素（工作项类型定义架构）	可选。 为此字段定义一个禁止值的列表。
DEFAULT 元素（工作项类型定义架构）	可选。 为此字段定义一个默认值。
COPY 元素（工作项类型定义架构）	可选。 指定另外一个字段，该字段包含将要复制到当前字段中的值。
SERVERDEFAULT 元素（工作项类型定义架构）	可选。 指定将为此字段提供值的服务器组件。
WHEN 元素（工作项类型定义架构）	可选。 在另一个字段具有特定值时，将一个或多个规则应用于当前字段。
WHENNOT 元素（工作项类型定义架构）	可选。 当另一个字段没有特定值时，将一个或多个规则应用于当前字段。
WHENCHANGED 元素（工作项类型定义架构）	可选。 当特定字段的值发生更改时，将一个或多个规则应用于当前字段。
WHENNOTCHANGED 元素（工作项类型定义架构）	可选。 当特定字段的值不发生更改时，将一个或多个规则应用于当前字段。

父元素

元素	说明
FIELDS 元素（WORKITEMTYPE 元素）	必需。 包含工作项类型字段定义。

备注

FIELD 是 FIELDS 的一个必需的子元素。

minOccurs="1"

maxOccurs="unbounded"

示例

<FIELD name="field display name" refname="field reference name" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath" reportable="Dimension | Detail | Measure" formula="sum">
    <HELPTEXT>…</HELPTEXT>
    <REQUIRED>…</REQUIRED>
    <READONLY>…</READONLY>
    <EMPTY>…</EMPTY>
    <FROZEN>…</FROZEN>
    <CANNOTLOSEVALUE>…</CANNOTLOSEVALUE>
    <NOTSAMEAS>…</NOTSAMEAS>
    <VALIDUSER>…</VALIDUSER>
    <ALLOWEXISTINGVALUE>…</ALLOWEXISTINGVALUE>
    <MATCH>…</MATCH>
    <ALLOWEDVALUES>…</ALLOWEDVALUES>
    <SUGGESTEDVALUES>…</SUGGESTEDVALUES>
    <PROHIBITEDVALUES>…</PROHIBITEDVALUES>
    <DEFAULT>…</DEFAULT>
    <COPY>…</COPY>
    <SERVERDEFAULT>…</SERVERDEFAULT>
    <WHEN>…</WHEN>
    <WHENNOT>…</WHENNOT>
    <WHENCHANGED>…</WHENCHANGED>
    <WHENNOTCHANGED>…</WHENNOTCHANGED>
</FIELD>

元素信息

命名空间	https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef
架构名称	工作项类型定义
验证文件	WorkItemTypeDefinition.xsd
元素类型	FieldDefinition 复杂类型（WORKITEMTYPE 元素）
是否可以为空	是

请参见

参考

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

其他资源

工作项类型定义架构

定义工作项类型字段