作業項目フィールドの条件の設定

[アーティクル]
02/21/2013

限定規則 (CANNOTLOSEVALUE、EMPTY、FROZEN、NOTSAMEAS、READONLY、REQUIRED などの要素) を指定することにより、フィールドに加えられる変更を制限できます。たとえば、NOTSAMEAS 規則を使用すると、2 つのフィールドに同じ値が割り当てられたり、同時にクリアされたりするのを防ぐことができます。またこの規則を使用すると、"コードレビューアー" フィールドに "担当者" フィールドと同じ値を割り当てることはできなくなります。

これらの規則は、FIELD (定義) 要素、FIELD (ワークフロー) 要素、または FIELD (グローバルワークフロー) 要素の子要素として指定できます。for 属性または not 属性にユーザーまたはグループをそれぞれ指定することで、作業項目を変更するユーザーに基づいて、これらの規則を適用または無視できます。

フィールド値に対する規則要素の構文構造

値が指定された後でフィールドから値がクリアされないようにするために、CANNOTLOSEVALUE 規則を指定できます。フィールドにこの規則を適用する場合は、ユーザーが値を設定したフィールドには、常に NULL 以外の値を含む必要があります。
```
<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />
```
フィールドに設定された値をクリアするには、EMPTY 規則を指定します。この規則はフィールドを読み取り専用にするため、これを READONLY 規則と併用しないでください。フィールド値は、作業項目を保存する時にクリアされますが、値を指定することはできません。この規則は、作業項目の遷移先の状態に適用するフィールドをクリアするために状態遷移中に主に使用されます。
```
<EMPTY for="userGroupName"not="userGroupName" />
```
作業項目が保存された後に、ユーザーがフィールドを NULL 以外の値に変更できないようにするには、FROZEN 規則を指定します。データベースで値を定義された後でフィールドの値を変更することはできません。
```
<FROZEN for="userGroupName" not="userGroupName" />
```
フィールドに別のフィールドと同じ値が割り当てられないようにするには、NOTSAMEAS 規則を指定します。field 属性には、フィールドの有効な参照名を指定する必要があります。
```
<NOTSAMEAS for="userGroupName" not="userGroupName" field="fieldReferenceName"/>
```
たとえば、次の例は、MyCorp.Reviewer フィールドと同じ値が、他のフィールドに指定されないようにします。
```
<NOTSAMEAS field="MyCorp.Reviewer" />
```
この規則は、類似した種類のフィールドに対して使用します。この規則をプレーンテキストフィールドまたは HTML フィールドに使うことはできません。
フィールド値が変更されないようにするには、READONLY 規則を指定します。

この要素を EMPTY 要素と併用しないでください。EMPTY も、フィールドを読み取り専用に設定します。両方の要素を併用すると、矛盾した結果が生じる場合があります。
```
<READONLY for="userGroupName" not="userGroupName" />
```
ユーザーがフィールドに値を指定することを必須にするには、REQUIRED 規則を指定します。必須フィールドは空にできません。ユーザーは、すべての必須フィールドを定義するまでは作業項目を保存できません。
```
<REQUIRED for="userGroupName" not="userGroupName" />
```

ページのトップへ

属性

限定規則を適用するユーザーを制限できます。次の表に、これらの要素が参照する属性を示します。

属性	Description
for	省略可能です。この規則を適用する Team Foundation のユーザーまたはグループの名前を指定します。有効な名前は、1 ～ 255 文字のテキスト文字列で構成されます。パターン値 : ^[^\\]+\\[^\\]+$ パターン値の例: Domain\UserID
not	省略可能です。この規則を適用しない Team Foundation のユーザーまたはグループの名前を指定します。有効な名前は、1 ～ 255 文字のテキスト文字列で構成されます。パターン値 : ^[^\\]+\\[^\\]+$ パターン値の例: Domain\UserID
field	NOTSAMEAS 要素では必須。現在のフィールドに設定できない値が設定されたフィールドの参照名を指定します。参照名は、FIELD (定義) 要素で定義されている参照名と一致する必要があります。詳細については、「FIELD (定義) 要素」を参照してください。パターン値 : ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ パターン値の例 : Company.Division.IssueType

for

省略可能です。この規則を適用する Team Foundation のユーザーまたはグループの名前を指定します。有効な名前は、1 ～ 255 文字のテキスト文字列で構成されます。

パターン値 : ^[^\\]+\\[^\\]+$

パターン値の例: Domain\UserID

not

省略可能です。この規則を適用しない Team Foundation のユーザーまたはグループの名前を指定します。有効な名前は、1 ～ 255 文字のテキスト文字列で構成されます。

パターン値 : ^[^\\]+\\[^\\]+$

パターン値の例: Domain\UserID

field

NOTSAMEAS 要素では必須。現在のフィールドに設定できない値が設定されたフィールドの参照名を指定します。

参照名は、FIELD (定義) 要素で定義されている参照名と一致する必要があります。詳細については、「FIELD (定義) 要素」を参照してください。

パターン値 : ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$