作業項目を作成または変更するためのアクセス許可の管理
VALIDUSER 要素を人名フィールドに適用することにより、作業項目を作成または変更できるユーザーを制御できます。この要素を指定すると、ユーザーのユーザーまたはグループがフィールド値として再配置方法を示します。この要素を設定することで、フィールドに割り当てられているユーザーが指定されたグループの直接または間接のメンバーであることを必須とする省略可能な group 属性をサポートできます。既定では、Team Foundation 有効ユーザー グループのすべてのメンバーをフィールドで指定できます。
VALIDUSER 要素は、文字列型のフィールドの種類に対してのみ有効です。この規則は、FIELD (定義) 要素または FIELD (ワークフロー) 要素の子要素として指定できます。
このトピックの内容
人名フィールド
VALIDUSER 構文構造
VALIDUSER 属性
フィールドに対する既存の値の保持の許可による検証エラーの回避
[!メモ]
FIELD 定義に規則を適用するには、作業項目の種類の定義のインポートとエクスポートのに witadmin のコマンド ライン ツールを使用します。「作業項目の種類のカスタマイズおよび管理 [witadmin]」を参照してください。
人名フィールド
人名フィールドを参照するときは、VALIDUSER 規則のみ使用できます。次のシステム フィールドは、人名フィールドの例です。
アクティブ化した人 (System.ActivatedBy)
担当者 (System.AssignedTo)
承認方法 (System.AuthorizedAs)
変更者 (System.ChangedBy)
終了者 (System.ClosedBy)
作成者 (System.CreatedBy)
システム フィールドのほかに、カスタム文字列フィールドを作成し、人名フィールドとして使用することもできます。また、カスタム人名フィールドを Active Directory と同期させることができます。詳細については、「作業項目フィールドの管理 [witadmin]」を参照してください。
VALIDUSER 構文構造
VALIDUSER 要素を使用すると、人名が付けられたフィールドに Team Foundation 有効ユーザー グループまたは指定した別のグループのメンバーの名前が含まれている必要があることを指定できます。
for 属性または not 属性にユーザーまたはグループをそれぞれ指定することで、作業項目を変更するユーザーにこの規則を適用することを許可または制限できます。
<VALIDUSER group="groupName" for="userName" not="userName" />
すべての属性は省略できます。すべての属性は、1 ～ 255 文字のテキスト文字列で構成されている必要があります。トークンを使用してグループを指定できます。詳細については、「トークンによるユーザーとグループの参照」を参照してください。
[!メモ]
作業項目フィールドでは、ユーザーの ID はドメインの違いによって区別されません。したがって、"Example1\jaepak" と "Example2\jaepak" は、VALIDUSER 規則が適用されるフィールドに入力した場合、同じユーザーとして扱われます。ただし、ユーザーの ID は、Visual Studio Team Foundation Server の他の部分ではドメインの違いによって区別されます。
ページのトップへ
VALIDUSER 属性
VALIDUSER 規則を適用するユーザーを制限するかどうかを指定できます。省略可能な属性を 1 つも定義しない場合は、Team Foundation Server のすべての有効なユーザーおよびグループがフィールドを変更できます。
属性 |
説明 |
|---|---|
for |
省略可能です。この規則を適用する Team Foundation のユーザーまたはグループの名前を指定します。有効な名前は、1 ～ 255 文字のテキスト文字列で構成されます。 パターン値 : ^[^\\]+\\[^\\]+$ パターン値の例: Domain\UserID |
not |
省略可能です。この規則を適用しない Team Foundation のユーザーまたはグループの名前を指定します。有効な名前は、1 ～ 255 文字のテキスト文字列で構成されます。 パターン値 : ^[^\\]+\\[^\\]+$ パターン値の例: Domain\UserID |
group |
省略可能です。グループの名前です。ユーザーは、人名フィールドの値としてこのグループのメンバーを指定できます。有効な名前は、1 ～ 255 文字のテキスト文字列で構成されます。 パターン値 : ^[^\\]+\\[^\\]+$ パターン値の例: Domain\GroupID |
ページのトップへ
フィールドに対する既存の値の保持の許可による検証エラーの回避
次の例は、有効なユーザーのみが作業項目に割り当てられていることを確認する方法、作業項目を作成したユーザーに Assigned To フィールドの既定値を設定する方法、チーム プロジェクトの貢献者グループのメンバーを含む名前の選択リストを指定する方法を示します。ALLOWEXISTINGVALUE 要素を指定することで、メンバーがチームを辞めたり、プロジェクトの貢献者として登録されなくなったりしたときに発生する検証エラーを回避します。
<FIELD name="Assigned To" refname="System.AssignedTo" type="String" syncnamechanges="true" reportable="dimension">
<HELPTEXT>The user who is working on this work item</HELPTEXT>
<ALLOWEXISTINGVALUE />
<VALIDUSER />
<ALLOWEDVALUES expanditems="true" filteritems="excludegroups">
<LISTITEM value="Active" />
<LISTITEM value="[project]\Contributors" />
</ALLOWEDVALUES>
<DEFAULT from="field" field="System.CreatedBy" />
</FIELD>