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

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

[!メモ]

FIELD 定義に規則を追加するには、作業項目の種類の定義のインポートとエクスポートのに witadmin のコマンド ライン ツールを使用します。「作業項目の種類のカスタマイズおよび管理 [witadmin]」を参照してください。

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

ページのトップへ

パターン マッチの例

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

リリース番号

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

ページのトップへ

参照

その他の技術情報

フィールド規則の操作