对工作项字段设置条件

项目
08/12/2011

更新：2011 年 1 月

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

可以将这些规则指定为 FIELD（定义）、FIELD（工作流）或 FIELD（全局工作流）元素的子元素。通过分别为 for 或 not 特性指定用户或组，可以根据修改工作项的用户来应用或忽略这些规则。

提示

在定义全局工作流之前，必须在应用层服务器上启用该功能。因此，服务器必须运行支持该功能的 Visual Studio Team Foundation Server 版本，例如 Team Foundation Server 2010 Service Pack 1 (SP1)。可以在 Microsoft 网站上的下列页面获取 Service Pack：Visual Studio Team Foundation Server 2010 Service Pack 1 Beta。有关更多信息，请参见自定义全局工作流。

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

指定 CANNOTLOSEVALUE 规则可以防止在指定值后清除字段的值。如果将此规则应用于一个字段，在用户将此字段设为任意值后，该字段必须始终包含一个非 NULL 值。
```
<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />
```
指定 EMPTY 规则可以清除字段包含的任何值。此规则还会使字段变为只读，并且不应与 READONLY 规则一起使用。用户保存工作项时字段值将被清除，并且您不能指定任何值。此规则主要用来在状态转换期间清除应用于工作项转换到的状态的字段。
```
<EMPTY for="userGroupName"not="userGroupName" />
```
指定 FROZEN 规则可以防止用户在保存工作项后将字段更改为非 NULL 值。一旦字段在数据库中定义了某个值后，该值即不能再修改。
```
<FROZEN for="userGroupName" not="userGroupName" />
```
指定 NOTSAMEAS 规则可以防止对某一字段指派与另一个字段相同的值。 field 特性必须为有效的字段引用名称。
```
<NOTSAMEAS for="userGroupName" not="userGroupName" field="fieldReferenceName"/>
```
例如，下面的代码摘录将防止字段具有与 MyCorp.Reviewer 字段相同的值：
```
<NOTSAMEAS field="MyCorp.Reviewer" />
```
将此规则用于类型相似的字段。不能将此规则用于 PlainText 或 HTML 字段。
指定 READONLY 规则可以防止更改字段值。

使用 EMPTY 元素时不要使用此元素，因为 EMPTY 也会使字段变为只读。如果同时使用这两种元素，可能会产生不一致的结果。
```
<READONLY for="userGroupName" not="userGroupName" />
```
指定 REQUIRED 规则可以要求用户必须为字段指定值。必填字段不能为空。在用户定义所有必需字段之前，他们不能保存工作项。
```
<REQUIRED for="userGroupName" not="userGroupName" />
```

返回页首

特性

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

特性	说明
for	可选。指定 Team Foundation 中应用规则的用户或组的名称。有效名称是包含 1 至 255 个字符的文本字符串。模式值：^[^\\]+\\[^\\]+$ 模式值示例：域\用户 ID
not	可选。指定 Team Foundation 中不应用规则的用户或组的名称。有效名称是包含 1 至 255 个字符的文本字符串。模式值：^[^\\]+\\[^\\]+$ 模式值示例：域\用户 ID
field	对于 NOTSAMEAS 元素是必需的。指定字段的引用名称，不允许当前字段包含该字段的值。引用名称必须与字段 FIELD（定义）元素所定义的引用名称匹配。有关更多信息，请参见 FIELD（定义）元素。模式值：^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ 模式值示例：公司.部门.问题类型

for

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

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

模式值示例：域\用户 ID

not

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

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

模式值示例：域\用户 ID

field

对于 NOTSAMEAS 元素是必需的。指定字段的引用名称，不允许当前字段包含该字段的值。

引用名称必须与字段 FIELD（定义）元素所定义的引用名称匹配。有关更多信息，请参见 FIELD（定义）元素。

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