FieldCondition Complex Type (Work Item Type Definition Schema)
Defines the field attribute and references Rules for the WHENCHANGED and WHENNOTCHANGED elements.
<xs:complexType name="FieldCondition">
<xs:choice minOccurs="1" maxOccurs="unbounded">
<xs:group ref="Rules"/>
</xs:choice>
<xs:attribute name="field" type="typelib:ReferenceFieldName" use="required"/>
</xs:complexType>
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
Attribute |
Description |
|---|---|
field |
Required attribute. Specifies the field reference name of another field. In the WHENCHANGED element, the rules that are contained in the element are applied when the value of the field specified by this attribute changes. In the WHENNOTCHANGED element, the rules that is contained in the element are applied when the value of the field specified by this attribute is not changed. The attribute type is typelib:ReferenceFieldName. Minimum length: 1; maximum length: 70. Pattern value: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Pattern value example: Company.Division.IssueType For more information about reference names, see FIELD Element (WORKITEMTYPE Element). |
Child Elements
Element |
Description |
|---|---|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the current field must have a value. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the current field is read-only. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the current field must be empty. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the current field is frozen. A frozen field cannot be changed to any non-empty value after changes are committed. However, you can manually clear the field, save the work item, and then specify a different value. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), then after the current field has acquired a value, it cannot be cleared or made empty. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the value of the current field cannot match the value of a third field. You specify the third field in the NOTSAMEAS element. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the list of allowed values must consist only of valid users of the system. |
|
ALLOWEXISTINGVALUE Element (Work Item Type Definition Schema) |
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the value of the current field that already exists will be allowed, even if it violates other rules. If the value of the current field is changed, this element does not apply. |
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the value of the current field must match the specified pattern. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the current field must have a value that comes from the specified list of values. Allowed values are values that are available for selection in a field list on work item forms and in the query builder. You must select from one of these values. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the specified list contains suggested values for the current field. Suggested values are values that are available for selection in a field list on work item forms and in the query builder. You can enter other values in addition to the ones in the list. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the current field cannot contain any values in this list. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the specified value is the default value for the current field. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the value from a third field is automatically copied into the current field. You specify the third field in the COPY element. |
|
Optional Rules Group (Work Item Type Definition Schema) element. Specifies that when the value of the field that is identified by the field attribute changes (in the WHENCHANGED Element), or does not change (in the WHENNOTCHANGED Element), the current field uses the value from the specified server component. The server components are clock, which is the time when the work item is updated, and currentuser, which is the identity that updated the work item. |
Parent Elements
None
Remarks
The FieldCondition Complex Type is the element type for the following elements:
WHENCHANGED Element (Work Item Type Definition Schema)
WHENNOTCHANGED Element (Work Item Type Definition Schema)
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 |