SUGGESTEDVALUES Element (Work Item Type Definition Schema)
Defines a list of suggested values for the 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.
<xs:element name="SUGGESTEDVALUES" type="ListRule"/>
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
Attribute |
Description |
|---|---|
for |
Optional PlainRule attribute. Specifies the name of a user or group to whom this rule applies. |
not |
Optional PlainRule attribute. Specifies the name of a user or group to whom this rule does not apply. |
expanditems |
Optional ListRule attribute. Specifies whether a group specified by the LISTITEM element should be expanded to include subordinate groups in the list. The default value is true. |
filteritems |
Optional ListRule attribute. Specifies that only the members of groups, and not group names, are included in the list. The only allowed attribute value is excludegroups. |
Child Elements
Element |
Description |
|---|---|
Optional element. You must define at least one child element from this table. References a global list that contains values to include in the selection of values for the ALLOWEDVALUES, PROHIBITEDVALUES, and SUGGESTEDVALUES elements. |
|
Optional element. You must define at least one child element from this table. Defines a valid list value. |
Parent Elements
Element |
Description |
|---|---|
Required element. References a work item field definition and the rules and conditions that apply to the field. The reference is based on the STATE, TRANSITION, DEFAULTREASON, or REASON element that its parent FIELDS element is a child of. |
|
Required element. Defines a work item field and specifies the rules and conditions that apply to it. |
Remarks
SUGGESTEDVALUES is an optional child element of FIELD (Work Item Type Definition Schema) and FIELD (WORKITEMTYPE element).
Example
<SUGGESTEDVALUES for="user or group name" not="user or group name" expanditems="true | false" filteritems="excludegroups">
<GLOBALLIST name="global list value" />
<LISTITEM value="list item value" />
</SUGGESTEDVALUES>
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 |
No |