在列表中展开列表项以及排除组

  • 项目

Azure DevOps Server 2020 |Azure DevOps Server 2019 |TFS 2018

可以使用和filteritems属性展开和筛选列表expanditems。 可以将这些属性应用于这些列表类型元素： ALLOWEDVALUES、 SUGGESTEDVALUES和 PROHIBITEDVALUES。

要更好地理解如何将这些属性用于填充字段的下拉菜单，请查看以下示例：

展开列表和组

You can assign the values true and false to expanditems; its value is true by default. 如果 expanditems 值为 true，则以递归方式展开表示组或全局列表的列表项。 展开组的子组；展开这些子组的子组，以此类推。 展开后，代表组的列表项包括作为列表项值的组和用户。 如果设置为 falseexpanditems，则不执行组或全局列表扩展。

排除组

只能为属性分配值excludegroupsfilteritems。 出现此属性时，已评估所有列表项并已删除任何组。 使用属性 filteritems 仅显示用户，而不是组。

示例中所用的列表和组的内容

此主题提供的示例使用以下值：

组名称和列表

说明

[项目]\业务分析师

  • Chuck Reinhart
  • Christie Church
  • Raisa Pokrovskaya

一个项目组，其中包含三个业务分析师团队成员的名称。

备注

使用文本前缀 [Project] 而不是使用项目的实际名称。

Example1\MyReports

  • 开发
  • 开发用户
  • 测试
  • 测试用户
  • 计划管理
  • pm 用户
  • juser

一个项目组，其中包含一个团队成员、juser 和三个子组，其中每个子组包含一个团队成员的名称。

Example1\MyReports

  • 用户一
  • 用户 2
  • 用户三
  • 我的远程
  • 用户四
  • 用户五

一个项目组，其中包含三个团队成员和一个子组的名称，其中包含两个团队成员的名称。

BoolValues

  • true
  • false

带有两个条目的全局列表。

示例：展开列表和排除组

在此示例中，该字段包含一个字符串值、一个组和一个全局列表。 显示工作项时，将展开列表并排除组。

示例

下拉列表值

<ALLOWEDVALUES expanditems="true" filteritems="excludegroups"> 
<LISTITEM value="string" /> 
<LISTITEM value="[Project]\Business Analysts" />  
<GLOBALLIST name="BoolValues" />
  • 字符串
  • true
  • false
  • Francis Totten
  • 海伦娜·彼得森
  • Jia hao Tseng

示例：展开列表和组，不筛选

在此示例中，该字段包含一个字符串值、两个组和一个全局列表。 显示工作项时，将展开列表，并且不会排除组。

示例

下拉式列表值

<ALLOWEDVALUES expanditems="true">
<LISTITEM value="string" />
<LISTITEM value="Example1\MyReports"/>
<LISTITEM value="Example1\MyTeam" />
<GLOBALLIST name="BoolValues" />
</ALLOWEDVALUES>
  • 字符串
  • true
  • false
  • juser
  • juser2
  • devuser
  • testuser
  • pmuser
  • 开发
  • 测试
  • 计划管理

示例：不要展开列表或组，也不筛选

在此示例中，该字段包含一个字符串值、两个组和一个全局列表。 在运行时，列表不会展开，并且不会筛选出组。如果未展开列表，则显示组名称，但不会显示这些组中的用户。

注意

不显示全局列表名称和内容。

示例

下拉式列表值

<ALLOWEDVALUES expanditems="false">
<LISTITEM value="string" />
<LISTITEM value="Example1\MyReports"/>
<LISTITEM value="Example1\MyTeam" />
<GLOBALLIST name="BoolValues" />
</ALLOWEDVALUES>
  • 字符串
  • MyTeam
  • MyReports

示例：展开列表，排除组和全局列表

在此示例中，该字段包含一个字符串值、一个组和一个全局列表。 运行时，展开列表，筛选组。

备注

MyTeam 是排除且未展开的组， BoolValues 是全局列表，因此既不展开也不显示。

示例

下拉式列表值

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

字符串