REASON Element (Work Item Type Definition Schema)

Specifies a reason for the occurrence of a transition in addition to the reason that is specified in the DEFAULTREASON element.

Schema Hierarchy

WITD Element (Work Item Type Definition Schema)

    WORKITEMTYPE Element (Work Item Type Definition Schema)

        WORKFLOW Element (Work Item Type Definition Schema)

            TRANSITIONS Element (Work Item Type Definition Schema)

                TRANSITION Element (Work Item Type Definition Schema)

                    REASONS Element (Work Item Type Definition Schema)

                        REASON Element (Work Item Type Definition Schema)

<xs:element name="REASON" type="Reason" minOccurs="0" maxOccurs="unbounded"/>

<REASON value="ValueOfReason">
    <FIELDS>…</FIELDS>
</REASON>

Attributes and Elements

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

Attributes

Attribute

Description

value

Required Reason attribute.

The text string value of the reason for the transition.

The attribute type is typelib:NonEmptyPlainConstant. Minimum length: 1; maximum length: 255.

Pattern value: ^[^\\]*$

Pattern value example: Test Passed

Child Elements

Element

Description

FIELDS Element (WORKFLOW)

Optional element.

A collection of FIELD elements that reference the field definitions contained in the work item type.

Parent Elements

Element

Description

REASONS Element (Work Item Type Definition Schema)

Required element.

Specifies a collection of DEFAULTREASON and REASON elements that define valid reasons the work item can complete the transition.

Remarks

REASON is an optional child element of REASONS.

minOccurs="0"

maxOccurs="unbounded"

Example

<REASON value="Test Passed">
    <FIELDS>…</FIELDS>
</REASON>

Element Information

Namespace

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

Schema Name

Work Item Type Definition

Validation File

WorkItemTypeDefinition.xsd

Element Type

Reason Complex Type (Work Item Type Definition Schema)

Can Be Empty

Yes

See Also

Concepts

Designing the Workflow

Other Resources

Defining and Customizing Work Item Workflow

Change History

Date

History

Reason

October 2010

Corrected the description of the element, and added information about its value attribute.

Customer feedback.