MATCH Element (Work Item Type Definition Schema)

Defines a pattern for the field that the field value must match.

<VALIDUSER for="user name" not="user name" pattern="pattern to match" />

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 or group to whom this rule applies.

not

Optional PlainRule attribute.

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

pattern

Required PatternRule attribute.

Enforces basic pattern matching for strings only. Valid values are "A,” "N,” "X.” All other values are taken as literals. "A" represents an alphabetical character. "N" represents a numeric character. "X" represents any alphanumeric character.

Child Elements

None.

Parent Elements

Element Description

FIELD (Work Item Type Definition Schema)

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 (WORKITEMTYPE element)

Required element.

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

WHENCHANGED

Optional element.

Specifies one or more rules to apply to the current field when a specified field is changed.

WHENNOTCHANGED

Optional element.

Specifies one or more rules to apply to the current field when a specific field is not changed.

Remarks

MATCH is an optional child element of FIELD (Work Item Type Definition Schema), FIELD (WORKITEMTYPE Element), WHENCHANGED, and WHENNOTCHANGED.

If you define multiple MATCH elements, the value will be valid if it matches any of the patterns defined for the field.

Element Information

Namespace

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

Schema Name

Work Item Type Definition

Validation File

WorkItemTypeDefinition.xsd

Element Type

PatternRule

Can Be Empty

Not applicable

See Also

Reference

FIELD Element (Work Item Type Definition Schema)
FIELD Element (WORKITEMTYPE Element)
WHENCHANGED Element (Work Item Type Definition Schema)
WHENNOTCHANGED Element (Work Item Type Definition Schema)

Other Resources

Defining Field Rules