对工作项字段设置条件

可以限制对字段所做的更改。通过指定限定规则 (例如, CANNOTLOSEVALUE、 EMPTY、 FROZEN、 NOTSAMEAS、 READONLY和 REQUIRED 元素。例如,可以使用 NOTSAMEAS 规则防止对两个字段指派相同的值或同时清除。此外,还可以使用规则防止对 “代码审阅者”字段赋值和 “指派给”字段指派相同。

可以将这些规则指定为 FIELD (定义), FIELD (工作流),或者 FIELD (全局工作流) 元素的子元素。可以应用或忽略基于用户通过指定用户或组修改工作项 for 或 not 属性,分别的这些规则。

字段值规则元素的语法结构

  • ,在指定值后,您可以指定 CANNOTLOSEVALUE 规则可以防止字段将被清除。如果将此规则应用于一个字段,该字段必须始终包含非 null 值,在用户将字段设为任意值之后。

    <CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />
    
  • 您指定 EMPTY 规则清除字段包含的任何值。此规则还会使字段变为只读,并且,不应与 READONLY 规则。清除字段值,则在保存工作项时,因此,您不能指定任何值。主要用来在状态转换期间此规则清除应用于工作项转换到的状态的字段。

    <EMPTY for="userGroupName"not="userGroupName" />
    
  • 您指定 FROZEN 规则可以防止用户将该字段更改为非空值在保存工作项后。如果某个已定义的值在数据库,不能再修改该值。

    <FROZEN for="userGroupName" not="userGroupName" />
    
  • 您指定 NOTSAMEAS 规则可以防止字段赋值和另一个字段相同。field 属性必须是有效的字段引用名称。

    <NOTSAMEAS for="userGroupName" not="userGroupName" field="fieldReferenceName"/>
    

    例如,下面的代码摘录防止字段具有与 MyCorp.Reviewer 字段的值:

    <NOTSAMEAS field="MyCorp.Reviewer" />
    

    是一个类型相似的字段使用此规则。不能为纯文本或 HTML 字段。

  • 您指定 READONLY 规则可以防止更改字段值。

    ,因为 EMPTY 还会使字段变为只读,不要将 EMPTY 元素使用此元素。如果同时使用这两个元素,可能会产生不一致的结果。

    <READONLY for="userGroupName" not="userGroupName" />
    
  • 您指定 REQUIRED 规则要求用户必须为字段指定值。必填字段不能为空。用户无法保存工作项,直至定义所有必需字段。

    <REQUIRED for="userGroupName" not="userGroupName" />
    

返回页首

属性

可以限制限定规则的应用对象。下表描述了这些元素引用的属性:

特性

说明

for

选项。在应用规则的 Team Foundation 指定用户或组的名称。有效名称包含 1 至 255 个字符的文本字符串。

模式值:^ [^ \ \] + \ \ [^ \ \] +$

模式值示例: 域\UserID

not

选项。在规则不适用的 Team Foundation 指定用户或组的名称。有效名称包含 1 至 255 个字符的文本字符串。

模式值:^ [^ \ \] + \ \ [^ \ \] +$

模式值示例: 域\UserID

field

NOTSAMEAS 元素。指定值当前字段不允许包含字段的引用名称。

引用名称必须与由 FIELD 的引用名称 (定义) 元素定义的。有关更多信息,请参见 FIELD(定义)元素

模式值:^ [a-zA-Z_] [[a-za-z0-9_]+] * (\。[[a-za-z0-9_]+] +) +$

模式值示例:公司

返回页首

请参见

概念

All FIELD XML 元素引用

用标记引用用户和组

其他资源

管理创建或修改工作项的权限

使用字段规则

定义工作项字段