FieldCondition 复杂类型(工作项类型定义架构)

更新:2007 年 11 月

为 WHENCHANGED 和 WHENNOTCHANGED 元素定义 field 属性并引用 Rules。

<xs:complexType name="FieldCondition">
        <xs:choice minOccurs="1" maxOccurs="unbounded">
                <xs:group ref="Rules"/>
        </xs:choice>
        <xs:attribute name="field" type="typelib:ReferenceFieldName" use="required"/>
</xs:complexType>

属性和元素

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

属性

属性

说明

field

必需的属性。

指定其他字段的字段引用名称。在 WHENCHANGED 元素中,如果此属性指定的字段的值发生更改,则将应用该元素中包含的规则。在 WHENNOTCHANGED 元素中,如果此属性指定的字段的值未发生更改,则将应用该元素中包含的规则。属性类型为 typelib:ReferenceFieldName。最小长度:1;最大长度:70。

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

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

有关引用名称的更多信息,请参见 FIELD 元素(WORKITEMTYPE 元素)

子元素

元素

说明

REQUIRED 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段必须具有一个值。

READONLY 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段为只读。

EMPTY 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段必须为空。

FROZEN 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段被冻结。提交更改后,不能将冻结的字段更改为任何非空值。但是,您可以手动清除此字段,保存工作项,然后指定其他值。

CANNOTLOSEVALUE 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),不得在当前字段获得值后将它清除或清空。

NOTSAMEAS 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段的值不得与第三个字段的值匹配。在 NOTSAMEAS 元素中指定第三个字段。

VALIDUSER 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),允许值列表必须仅包含系统中的有效用户。

ALLOWEXISTINGVALUE 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),允许使用当前字段已存在的值,即使该值与其他规则冲突也是如此。如果当前字段的值发生更改,则该元素不适用。

MATCH 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段的值必须与指定模式匹配。

ALLOWEDVALUES 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段必须有一个来自指定值列表的值。允许的值指工作项窗体上以及查询生成器中的字段列表中可供选择的值。必须从这些值中选择一个。

SUGGESTEDVALUES 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),指定列表包含当前字段的建议值。建议的值指工作项窗体上以及查询生成器中的字段列表中可供选择的值。您可以输入列表中可用值以外的其他值。

PROHIBITEDVALUES 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段不得包含此列表中的任何值。

DEFAULT 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),指定的值是当前字段的默认值。

COPY 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),来自第三个字段的值将自动复制到当前字段中。在 COPY 元素中指定第三个字段。

SERVERDEFAULT 元素(工作项类型定义架构)

可选的 Rules 组(工作项类型定义架构) 元素。

指定当 field 属性标识的字段的值发生更改时(在 WHENCHANGED 元素中),或未发生更改时(在 WHENNOTCHANGED 元素中),当前字段使用来自指定服务器组件的值。该服务器组件是“clock”(表示更新工作项的时间)和“currentuser”(表示更新工作项的用户标识)。

父元素

备注

FieldCondition 复杂类型是以下元素的元素类型:

WHENCHANGED 元素(工作项类型定义架构)

WHENNOTCHANGED 元素(工作项类型定义架构)

元素信息

命名空间

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

架构名称

工作项类型定义

验证文件

WorkItemTypeDefinition.xsd

是否可以为空

不适用

请参见

其他资源

工作项类型定义架构

字段条件