VALIDUSER Element (Work Item Type Definition Schema)

The VALIDUSER element specifies that the field must contain a member of the Team Foundation Valid Users group. You can set this rule to support the optional group attribute that specifies whether the user must be a direct or indirect member of the group that you specify. By default, this rule enables all users who are members of the Team Foundation Valid Users group to be specified in the field.

<xs:element name="VALIDUSER" type="ValidUserRule"/>

<VALIDUSER group="group name" for="user name" not="user name" />

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

for

Optional PlainRule attribute.

The name of a user to whom this rule applies.

not

Optional PlainRule attribute.

The name of a user to whom this rule does not apply.

group

Optional ValidUserRule attribute.

The name of a group for whom this rule applies.

Child Elements

None.

Parent Elements

Element

Description

FIELD Element (WORKFLOW)

Required element.

References a work item field definition and the rules and conditions that apply to the field. The reference is based on the STATE, TRANSITION, DEFAULTREASON, or REASON element that its parent FIELDS element is a child of.

FIELD Element (WORKITEMTYPE Element)

Required element.

Defines a work item field and specifies the rules and conditions that apply to it.

Remarks

VALIDUSER is an optional child element of FIELD (Work Item Type Definition Schema) and FIELD (WORKITEMTYPE element). The VALIDUSER rule is valid only for String field types.

If you do not define one of the optional attributes, all valid Team Foundation Server users and groups will be able to modify the field.

Warning

Work item fields do not distinguish between user identities in different domains. Therefore, "Example1\jaepak" and "Example2\jaepak" are treated as the same user when they are entered into a field that uses the VALIDUSER rule. However, user identities are distinguished by domains elsewhere in Team Foundation Server.

Example

<VALIDUSER for="user name" not="user name" group="group name" />

Element Information

Namespace

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

Schema Name

Work Item Type Definition

Validation File

WorkItemTypeDefinition.xsd

Element Type

ValidUserRule Complex Type (Work Item Type Definition Schema)

Can Be Empty

Not applicable

See Also

Concepts

Available Field Rules

Other Resources

Defining Field Rules

Change History

Date

History

Reason

June 2010

Added more information about the usage of the VALIDUSER element.

Customer feedback.