SUGGESTEDVALUES Element (Work Item Type Definition Schema)

Defines a list of suggested values for the field.

<SUGGESTEDVALUES for="user or group name" not="user or group name" expanditems="true | false" filteritems="excludegroups">
    <GLOBALLIST>…</GLOBALLIST>
    <LISTITEM>…</LISTITEM>
</SUGGESTEDVALUES>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description

for

Optional PlainRule attribute.

The name of a user or group to whom this rule applies.

not

Optional PlainRule attribute.

The name of a user or group to whom this rule does not apply.

expanditems

Optional ListRule attribute.

A Boolean value that specifies whether the list will or will not appear expanded. The default value is true.

filteritems

Optional ListRule attribute.

The groups that should be excluded from the list.

Child Elements

Element Description

GLOBALLIST (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

Optional element.

You must define at least one child element from this table.

Defines a valid list value.

Parent Elements

Element Description

FIELD (Work Item Type Definition Schema)

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 (WORKITEMTYPE element)

Required element.

Defines a work item field and specifies the rules and conditions that apply to it.

WHENCHANGED

Optional element.

Specifies one or more rules to apply to the current field when a specified field is changed.

WHENNOTCHANGED

Optional element.

Specifies one or more rules to apply to the current field when a specific field is not changed.

Remarks

SUGGESTEDVALUES is an optional child element of FIELD (Work Item Type Definition Schema), FIELD (WORKITEMTYPE Element), WHENCHANGED, and WHENNOTCHANGED.

Element Information

Namespace

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

Schema Name

Work Item Type Definition

Validation File

WorkItemTypeDefinition.xsd

Element Type

ListRule

Can Be Empty

No

See Also

Reference

FIELD Element (Work Item Type Definition Schema)
FIELD Element (WORKITEMTYPE Element)
WHENCHANGED Element (Work Item Type Definition Schema)
WHENNOTCHANGED Element (Work Item Type Definition Schema)
GLOBALLIST Element (Work Item Type Definition Schema)
LISTITEM Element (typelib Schema)

Concepts

Available Field Rules