将模式匹配应用于字符串字段

可以使用 MATCH 元素强制字符串类型字段中的值遵循指定的模式。 如果定义多个 MATCH 元素,则值在与任何为该字段指定的模式匹配时是有效的。 如果至少有一个元素成功,则字段具有有效值。

备注

若要向 FIELD 定义添加规则,请使用 witadmin 命令行工具导入和导出工作项类型的定义。请参阅导入、导出和管理工作项类型 [witadmin]

MATCH 元素语法结构

使用 MATCH 可通过定义字符串类型字段中的值必须匹配的模式,来强制实施基本模式匹配。

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

特性

可以指定 MATCH 规则适用的用户。 如果未定义任何可选特性,则 Team Foundation Server 中的所有有效用户和组都必须指定与模式匹配的值。

特性

描述

pattern

必需。 仅针对字符串并且仅针对 syncnamechanges="false" 的字符串强制实施基本模式匹配。

patternValue 的有效值是“A”、“N”和“X”,这些值表示以下字符类型:

  • “A”表示字母字符。

  • “N”表示数字字符。

  • “X”表示任何字母数字字符。

所有其他值都作为原义字符。 最小长度:1;最大长度:255。

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

模式值示例:xxxxx。 nn. nn

for

可选。 指定对其应用规则的 Team Foundation 中的用户或组名。 有效名称为一个文本字符串,该字符串含 1 到 255 个字符。

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

模式值示例:域\用户 ID

not

可选。 指定不对其应用规则的 Team Foundation 中的用户或组名。 有效名称为一个文本字符串,该字符串含 1 到 255 个字符。

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

模式值示例:域\用户 ID

返回页首

模式匹配示例

以下示例说明各种字段用法的成功和失败模式匹配。

发行版号

模式:ANN.NN.NN

验证

R01.03.04 或 V05.08.99

验证失败

1.3.4、V5.8.99 或 v1.3

灵活的标识符

模式:XXX-XXX

验证

001-abc 或 a00-b02

验证失败

1-abc 或 001.abc

优先级

模式:PN

验证

P1、P5 或 P9

验证失败

1 或 P10

匹配标记不区分大小写。 因此,“PN”与 P1 和 p1 匹配。

返回页首

请参见

其他资源

将规则应用于工作项字段