STATE Element (Work Item Type Definition Schema)
Defines a valid state for the work item type and can contain a FIELDS element that references rules and conditions to be applied to a specific field when a work item makes the transition to that state.
Schema Hierarchy
WITD Element (Work Item Type Definition Schema)
WORKITEMTYPE Element (Work Item Type Definition Schema)
WORKFLOW Element (Work Item Type Definition Schema)
STATES Element (Work Item Type Definition Schema)
STATE Element (Work Item Type Definition Schema)
<xs:element name="STATE" type="State" minOccurs="1" maxOccurs="unbounded"/>
<STATE value="value of state">
<FIELDS>…</FIELDS>
</STATE>
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
Attribute |
Description |
|---|---|
value |
Required State attribute. The value of the state (for example, Active). |
Child Elements
Element |
Description |
|---|---|
Optional element. Defines a collection of FIELD elements that specify conditions to be applied to the field when the work item makes the transition to the new state. For more information, see FIELD Element (WORKFLOW). |
Parent Elements
Element |
Description |
|---|---|
Required element. Defines a collection of STATE elements that describe the valid states that the work item type can be in. |
Remarks
STATE is a required child element of STATES.
minOccurs="1"
maxOccurs="unbounded"
When you specify the value of a field for a state, you use the FIELDS and FIELD elements for workflow. For more information, see FIELDS Element (WORKFLOW) and FIELD Element (WORKFLOW).
Example
<STATE value="Unapproved"></STATE>
<STATE value="Active">
<FIELDS>
<FIELD refname="Microsoft.VSTS.Common.ClosedDate">
<EMPTY />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...
<FIELDS>
</STATE>
Element Information
Namespace |
https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef |
Schema Name |
Work Item Type Definition |
Validation File |
WorkItemTypeDefinition.xsd |
Element Type |
|
Can Be Empty |
Yes |
See Also
Tasks
How to: Change the Workflow of a Work Item Type