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

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)

<REASON value="value of default reason">
        <FIELDS>…</FIELDS>
</REASON>

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 (Work Item Type Definition Schema)

Optional element.

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

Parent Elements

Element Description

REASONS

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"

Element Information

Namespace

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

Schema Name

Work Item Type Definition

Validation File

WorkItemTypeDefinition.xsd

Element Type

Reason

Can Be Empty

Yes

See Also

Reference

FIELDS Element (Work Item Type Definition Schema)

Other Resources

Defining Work Item Workflow