Share via

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

  • [アーティクル]

限定規則 (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

ページのトップへ

参照

概念

すべての FIELD XML 要素のリファレンス

トークンによるユーザーとグループの参照

その他の技術情報

作業項目を作成または変更するためのアクセス許可の管理

フィールド規則の操作

作業項目フィールドの定義