Transition Complex Type (Work Item Type Definition Schema)

Article
12/06/2010

Defines attributes and child elements for the TRANSITION Element.

<xs:complexType name="Transition">
    <xs:all>
        <xs:element name="ACTIONS" type="ActionList" minOccurs="0"/>
        <xs:element name="REASONS" type="Reasons"/>
        <xs:element name="FIELDS" type="FieldReferences" minOccurs="0"/>
    </xs:all>
    <xs:attribute name="from" type="typelib:PlainConstant" use="required"/>
    <xs:attribute name="to" type="typelib:NonEmptyPlainConstant" use="required"/>
    <xs:attribute name="for" type="typelib:IdentityName"/>
    <xs:attribute name="not" type="typelib:IdentityName"/>
</xs:complexType>

Attributes and Elements

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

Attributes

Attribute	Description
from	Required attribute. The name of the state from which the work item is transitioning. The attribute type is typelib:PlainConstant. Maximum length: 255. Pattern value: ^[^\\]*$ Pattern value example: Active
to	Required attribute. The name of the state to which the work item is transitioning. The attribute type is typelib:NonEmptyPlainConstant. Minimum length: 1; maximum length: 255. Pattern value: ^[^\\]*$ Pattern value example: Resolved
for	Optional attribute. The name of a user or group who can perform this transition. The attribute type is typelib:IdentityName. Minimum length: 1; maximum length: 255 Pattern value: ^[^\\]+\\[^\\]+$ Pattern value example: Domain\userID
not	Optional attribute. The name of a user or group who cannot perform this transition. The attribute type is typelib:IdentityName. Minimum length: 1; maximum length: 255 Pattern value: ^[^\\]+\\[^\\]+$ Pattern value example: Domain\userID

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. Defines a collection of DEFAULTREASON and REASON elements that define valid reasons for which the work item can complete the transition.
FIELDS Element (WORKFLOW)	Optional element. Defines a collection of FIELD elements that reference the field definitions that are contained in the work item type.

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.

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

FIELDS Element (WORKFLOW)

Optional element.

Defines a collection of FIELD elements that reference the field definitions that are contained in the work item type.

Parent Elements

None

Remarks

The Transition Complex Type is the TRANSITION Element (Work Item Type Definition Schema) type.

Element Information

Namespace	https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef
Schema Name	Work Item Type Definition
Validation File	WorkItemTypeDefinition.xsd
Can be Empty	Not applicable