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

更新:2007 年 11 月

为 WHEN 和 WHENNOT 元素定义属性并整合 Rules。

<xs:complexType name="FieldValueCondition">
        <xs:complexContent>
                <xs:extension base="FieldCondition">
                        <xs:attribute name="value" type="typelib:Constant" use="required"/>
                </xs:extension>
        </xs:complexContent>
</xs:complexType>

属性和元素

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

属性

属性

说明

field

必选的 FieldCondition 复杂类型(工作项类型定义架构) 属性。

指定其他字段的字段引用名称。在 WHEN 元素中,标识根据此元素中将应用于当前字段的规则必须具有指定值的字段。在 WHENNOT 元素中,标识根据此元素中将应用于当前字段的规则不得具有指定值的字段。

属性类型为 typelib:ReferenceFieldName。最小长度:1;最大长度:70。

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

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

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

value

必需的属性。

指定 field 属性标识的字段的值。在 WHEN 元素中,如果 field 属性值等于此属性指定的值,则将应用该元素中包含的规则。在 WHENNOT 元素中,如果 field 属性值不等于此属性指定的值,则将应用该元素中包含的规则。属性类型为 typelib:Constant。最大长度:255。

子元素

元素

说明

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段必须包含一个值。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段为只读。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段不得包含值。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段冻结。提交更改后,不能将冻结的字段更改为任何非空值。但是,您可以手动清除此字段,保存工作项,然后指定其他值。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,不能清除当前字段,也不得在当前字段获得值后将它清空。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段的值不得与第三个字段的值匹配。在 NOTSAMEAS 元素中指定第三个字段。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,允许值列表必须仅包含系统中的有效用户。

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

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

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

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段的值必须与指定模式匹配。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段必须有一个来自指定值列表的值。允许的值指工作项窗体上以及查询生成器中的字段列表中可供选择的值。必须从这些值中选择一个。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,指定列表包含当前字段的建议值。建议的值指工作项窗体上以及查询生成器中的字段列表中可供选择的值。您可以输入列表中可用值以外的其他值。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段不能包含此列表中的任何值。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,此元素为当前字段指定默认值。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,来自第三个字段的值将自动复制到当前字段中。在 COPY 元素中指定第三个字段。

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

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

指定在 field 属性标识的字段具有指定值(在 WHEN 元素中),或不具有指定值(在 WHENNOT 元素中)的情况下,当前字段将从指定的服务器组件获得值。该服务器组件是“clock”(表示更新工作项的时间)和“currentuser”(表示更新工作项的用户标识)。

父元素

备注

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

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

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

FieldValueCondition 是 FieldCondition 复杂类型(工作项类型定义架构)的扩展。

元素信息

命名空间

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

架构名称

工作项类型定义

验证文件

WorkItemTypeDefinition.xsd

是否可以为空

不适用

请参见

其他资源

工作项类型定义架构

字段条件