Share via


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