REASON Element (Work Item Type Definition Schema)

Defines reasons for the occurrence of the transition in addition to the reason specified by 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"/>

Attributes and Elements

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

Attributes

Attribute

Description

value

Required Reason attribute.

The value of the default reason for the transition (for example, Fixed).

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="value of default reason">
    <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 Work Item Workflow