Share via


ListRule Complex Type (Work Item Type Definition Schema)

Defines attributes for use by selected elements in the Rules group.

<xs:complexType name="ListRule">
    <xs:complexContent>
        <xs:extension base="PlainRule">
            <xs:sequence maxOccurs="unbounded">
                <xs:choice>
                    <xs:element name="GLOBALLIST" type="typelib:GlobalList"/>
                    <xs:element name="LISTITEM" type="typelib:ListItem"/>
                </xs:choice>
            </xs:sequence>
            <xs:attribute name="expanditems" type="xs:boolean" default="true"/>
            <xs:attribute name="filteritems" type="FilterItems"/>
        </xs:extension>
    </xs:complexContent>
</xs:complexType>

Attributes and Elements

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

Attributes

Attribute

Description

for

Optional PlainRule Complex Type (Work Item Type Definition Schema) attribute.

The name of a user or group to whom this rule applies. The attribute type is typelib:IdentityName. Minimum length: 1; maximum length: 255.

Pattern value: ^[^\\]+\\[^\\]+$

Pattern value example: Domain\userID

not

Optional PlainRule Complex Type (Work Item Type Definition Schema) attribute.

The name of a user or group to whom this rule does not apply. The attribute type is typelib:IdentityName. Minimum length: 1; maximum length: 255

Pattern value: ^[^\\]+\\[^\\]+$

Pattern value example: Domain\userID

expanditems

Optional 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. The type is xs:Boolean.

filteritems

Optional attribute.

Specifies that only the members of groups, and not group names, are included in the list. The only allowed attribute value is excludegroups. The type is FilterItems Simple Type (Work Item Type Definition Schema).

Child Elements

Element

Description

GLOBALLIST Element (Work Item Type Definition Schema)

Optional element.

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.

Defines a valid list value.

Parent Elements

None

Remarks

You must define at least one child element (GLOBALLIST or LISTITEM).

The ListRule Complex Type is the element type for the following elements:

The ListRule Complex Type is an extension of the PlainRule Complex Type (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

See Also

Reference

Rules Group (Work Item Type Definition Schema)

Concepts

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

Other Resources

Setting Conditions on a Work Item Field