Expanding List Items and Excluding Groups from Lists

You can expand and filter lists by using the expanditems and filteritems attributes. You can apply these attributes to these list type elements: ALLOWEDVALUES, SUGGESTEDVALUES, and PROHIBITEDVALUES.

To better understand how these attributes are used to populate a field's drop-down menu, review the examples provided below.

Topic Contents

• Expanding Lists and Groups

• Excluding Groups

• Contents of Lists and Groups Used in the Examples

• Example: Expand Lists and Exclude Groups

• Example: Expand Lists and Groups and Do Not Filter

• Example: Do Not Expand Lists or Groups, and Do Not Filter

• Example: Expand Lists and Exclude Groups and Global Lists

Expanding Lists and Groups

You can assign the values true and false to expanditems; its value is true by default. When expanditems has the value of true, list items that represent groups or global lists are expanded recursively. A group's subgroups are expanded; the subgroups of those subgroups are also expanded, and continues in this pattern. After expansion, list items that represented groups include both groups and users as list item values. If expanditems is set to false, no group or global list expansion is performed.

Excluding Groups

You can assign only the value excludegroups to the filteritems attribute. When this attribute appears, all the list items are evaluated and any groups are removed. Use the filteritems attribute to show only users, not groups.

Contents of Lists and Groups Used in the Examples

The examples provided in this topic use the following values:

List or group name	List or group contents	Description
[Project]\Business Analysts	JayHamlin PilarAckerman ReshmaPatel	A team project group that contains the names of three business analyst team members. Note Use the literal prefix [Project] instead of using the actual name of the team project.
Example1\MyTeam	Development devuser Test Test user Program Management pmuser juser	A team project group that contains one team member, juser, and three subgroups, where each subgroup contains the name of one team member.
Example1\MyReports	Userone Usertwo Userthree MyRemotes userfour userfive	A team project group that contains the names of three team members and one subgroup which contains the names of two team members.
BoolValues	true false	A global list with two entries.

Example: Expand Lists and Exclude Groups

In this example, the field contains a string value, a group, and a global list. At the time it is run, the list is expanded and groups are excluded.

<ALLOWEDVALUES expanditems="true" filteritems="excludegroups">
   <LISTITEM value = "string" />
   <LISTITEM value = "[Project]\Business Analysts" />
   <GLOBALLIST value = "BoolValues" />
</ALLOWEDVALUES>

Example: Expand Lists and Groups and Do Not Filter

In this example, the field contains a string value, two groups, and a global list. At the time it is run the list is expanded and groups are not excluded.

<ALLOWEDVALUES expanditems="true">
   <LISTITEM value = "string" />
   <LISTITEM value = "Example1\MyReports"/>
   <LISTITEM value = "Example1\MyTeam" />
   <GLOBALLIST value = "BoolValues" />
</ALLOWEDVALUES> 

Example: Do Not Expand Lists or Groups, and Do Not Filter

In this example, the field contains a string value, two groups, and a global list. At run time, the list is not expanded and groups are not filtered out. This means that group names are displayed, but not the users within those groups.

<ALLOWEDVALUES expanditems="false">
   <LISTITEM value = "string" />
   <LISTITEM value = "Example1\MyReports"/>
   <LISTITEM value = "Example1\MyTeam" />
   <GLOBALLIST value = "BoolValues" />
</ALLOWEDVALUES> 

Example: Expand Lists and Exclude Groups and Global Lists

In this example, the field contains a string value, one group, and a global list. At run time, the list is expanded and groups are filtered out.

<ALLOWEDVALUES expanditems="true" filteritems="excludegroups">
   <LISTITEM value = "string" />
   <LISTITEM value = "Example\MyTeam" />
   <GLOBALLIST value = "BoolValues" />
</ALLOWEDVALUES> 

See Also

Concepts

Defining Pick Lists

Defining Global Lists

Defining and Using Lists, Pick Lists, and Global Lists