將模式比對套用至字串欄位

您可以使用 MATCH 項目來強制 String 類型欄位的值遵循您所指定的模式。如果您定義多個 MATCH 項目，當值符合針對該欄位所指定的任何模式時，就是有效的值。如果至少有一個項目成功，欄位就具有有效值。

注意事項
若要將規則加入 FIELD 定義，請使用 witadmin 命令列工具匯入及匯出工作項目類型的定義。請參閱匯入、匯出和管理工作項目類型 [witadmin]。

MATCH 項目語法結構

您可以使用 MATCH 項目定義 String 類型欄位的值必須符合的模式，藉以強制執行基本模式比對。

<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 個字元的文字字串所組成。模式值：^[^\\]+\\[^\\]+$ 模式值範例：Domain\UserID
not	選擇項。指定不適用規則之 Team Foundation 使用者或群組的名稱。有效名稱是由包含 1 到 255 個字元的文字字串所組成。模式值：^[^\\]+\\[^\\]+$ 模式值範例：Domain\UserID

pattern

必要項。只會對其 syncnamechanges="false" 的字串強制執行基本模式比對。

patternValue 的有效值包括 "A"、"N" 和 "X"，分別代表下列類型的字元：

所有其他值會視為常值。最小長度：1；最大長度：255。

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

模式值範例：xxxxx。 nn. nn

for

選擇項。指定適用規則之 Team Foundation 使用者或群組的名稱。有效名稱是由包含 1 到 255 個字元的文字字串所組成。

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

模式值範例：Domain\UserID

not

選擇項。指定不適用規則之 Team Foundation 使用者或群組的名稱。有效名稱是由包含 1 到 255 個字元的文字字串所組成。

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

模式值範例：Domain\UserID

回到頁首

下列範例說明各種欄位使用的成功和失敗模式比對。

模式：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。

回到頁首