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

  • [アーティクル]

更新 : 2011 年 1 月

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

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

注意

グローバル ワークフローを定義するには、アプリケーション層サーバーでこの機能を有効にする必要があります。 したがって、このサーバーでは、この機能をサポートする Visual Studio Team Foundation Server のバージョン (Team Foundation Server 2010 Service Pack 1 (SP1) など) が実行されている必要があります。 Service Pack は、Microsoft Web サイトの「Visual Studio Team Foundation Server 2010 SP1 Beta」ページで入手できます。 詳細については、「グローバル ワークフローのカスタマイズ」を参照してください。

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

  • 値が指定された後でフィールドから値がクリアされないようにするために、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" />

ページのトップへ

属性

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

属性

説明

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 要素のリファレンス

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

その他の技術情報

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

フィールド規則の操作

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

履歴の変更

日付

履歴

理由

2011 年 1 月

説明を簡潔にし、各規則要素の構文構造を提供。

情報の拡充