TRANSITION Element (Work Item Type Definition Schema)

Defines a valid state transition for the work item type.

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)

<xs:element name="TRANSITION" type="Transition" maxOccurs="unbounded"/>

Attributes and Elements

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

Attributes

Attribute

Description

from

Required Transition attribute.

The name of the state from which the work item is transitioning.

to

Required Transition attribute.

The name of the state to which the work item is transitioning.

for

Optional Transition attribute.

The name of a user or group who can perform this transition.

not

Optional Transition attribute.

The name of a user or group who cannot perform this transition.

Child Elements

Element

Description

ACTIONS Element (Work Item Type Definition Schema)

Optional element.

Defines a collection of ACTION elements that each define an action string that can be used when calling the WorkItem.GetNextState method to get the post-action state of the work item.

REASONS Element (Work Item Type Definition Schema)

Required element.

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

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

TRANSITIONS Element (Work Item Type Definition Schema)

Required element.

A collection of TRANSITION elements that define the valid state transitions for the work item type.

Remarks

TRANSITION is a required child element of TRANSITIONS.

You must define exactly one transition to move the work item from nothing (from="") to a named state such as Active. This transition identifies the default state for a new work item.

minOccurs="1"

maxOccurs="unbounded"

Example

<TRANSITION from="name of starting state" to="name of ending state" for="user or group name" not="user or group name">
    <ACTIONS>…</ACTIONS>
    <REASONS>…</REASONS>
    <FIELDS>…</FIELDS>
</TRANSITION>

Element Information

Namespace

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

Schema Name

Work Item Type Definition

Validation File

WorkItemTypeDefinition.xsd

Element Type

Transition Complex Type (Work Item Type Definition Schema)

Can Be Empty

No

See Also

Concepts

Designing the Workflow

Other Resources

Defining Work Item Workflow