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

更新：2007 年 11 月

引用一个工作项字段定义以及应用到该字段的规则和条件。该引用基于 STATE、TRANSITION、DEFAULTREASON 或 REASON 元素，引用的父 FIELDS 元素是这些元素的子元素。

<xs:element name="FIELD" type="FieldReference" minOccurs="1" maxOccurs="unbounded"/>

属性和元素

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

属性

属性	说明
refname	必需的 FieldReference 属性。 应用规则和条件的字段的引用名称。引用名称必须与字段定义的 FIELD 元素中所定义的引用名称相匹配。有关更多信息，请参见 FIELD 元素（WORKITEMTYPE 元素）。

子元素

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

父元素

元素	说明
FIELDS 元素（工作项类型定义架构）	FIELD 元素的集合，这些元素引用包含在工作项类型中的字段定义。

备注

必须为 FIELD（工作项类型定义架构）元素定义至少一个子元素。

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

minOccurs="1"

maxOccurs="unbounded"

示例

<FIELD refname="field reference name">
    <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
元素类型	FieldReference 复杂类型（工作项类型定义架构）
是否可以为空	否

请参见

其他资源

工作项类型定义架构

定义工作项类型字段