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
GLOBALLIST Element (Work Item Type Definition Schema)	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.
LISTITEM Element (typelib Schema)	Optional element. You must define at least one child element from this table. Defines a valid list value.

Parent Elements

Element	Description
FIELD Element (WORKFLOW)	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.
FIELD Element (WORKITEMTYPE Element)	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	ListRule Complex Type (Work Item Type Definition Schema)
Can Be Empty	No

See Also

Concepts

Field Rules, Defaults, Qualifiers, Lists, Actions, and Matching Patterns

Defining and Using Lists, Pick Lists, and Global Lists

Other Resources

Setting Conditions on a Work Item Field