文字列フィールドとパターンの一致

[アーティクル]
08/09/2011

更新 : 2011 年 1 月

MATCH 要素を使用すると、指定したパターンに文字列型のフィールドの値を強制的に合わせることができます。複数の MATCH 要素を定義した場合、フィールドに指定したパターンのいずれかと一致する値が有効になります。最低でも 1 つの要素が一致であれば、フィールドには有効な値があります。

MATCH 要素の構文構造

MATCH 要素を使用すると、文字列型のフィールドの値が一致する必要があるパターンを定義することで、基本的なパターンマッチを適用できます。

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

属性

MATCH 規則を適用するユーザーを指定できます。省略可能な属性を定義しない場合は、Team Foundation Server のすべての有効なユーザーおよびグループはパターンに一致する値を指定する必要があります。

属性	説明
pattern	必須。基本的なパターンマッチを文字列だけに適用します。 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

必須。基本的なパターンマッチを文字列だけに適用します。 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

ページのトップへ

パターンマッチの例

次の例では、さまざまなフィールドの用途での有効なパターンマッチと無効なパターンマッチを示します。

リリース番号

パターン: 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 の両方に一致します。

ページのトップへ

参照

その他の技術情報

フィールド規則の操作

履歴の変更

日付	履歴	理由
2011 年 1 月	MATCH 要素の構文を追加。	情報の拡充

2011 年 1 月

MATCH 要素の構文を追加。

情報の拡充