共用方式為

展開清單項目和排除清單群組

  • 發行項

您可以使用 expanditems 和 filteritems 屬性來展開和篩選清單。 您可以將這些屬性套用至下列清單類型項目：ALLOWEDVALUES、SUGGESTEDVALUES 和 PROHIBITEDVALUES。

若要進一步了解如何使用這些屬性來填入欄位的下拉式功能表，請檢閱下面提供的範例。

主題內容

  • 展開清單和群組

  • 排除群組

  • 範例中使用的清單和群組內容

  • 範例：展開清單並排除群組

  • 範例：展開清單和群組且不篩選

  • 範例：不展開清單或群組且不篩選

  • 範例：展開清單並排除群組和全域清單

展開清單和群組

您可以將 true 和 false 值指定給 expanditems；根據預設，它的值是 true。 當 expanditems 的值是 true 時，代表群組或全域清單的清單項目會以遞迴方式展開。 群組的子群組會展開，這些子群組的子群組也會展開，依此類推。 展開之後，代表群組的清單項目會包含群組與使用者來做為清單項目的值。 如果 expanditems 是設為 false，就不會展開任何群組或全域清單。

排除群組

您可以只將 excludegroups 這個值指定給 filteritems 屬性。 如果出現這個屬性，就會評估所有清單項目，並移除任何群組。 使用 filteritems 屬性只能顯示使用者，而無法顯示群組。

範例中使用的清單和群組內容

此主題中提供的範例會使用下列值：

清單或群組名稱

清單或群組內容

描述

[Project]\Business Analysts

JayHamlin

PilarAckerman

ReshmaPatel

Team 專案群組，包含三個商務分析師小組成員的姓名。

注意事項注意事項
請使用常值前置詞 [Project]，而不要使用 Team 專案的實際名稱。

Example1\MyTeam

開發

devuser

測試

Test user

Program Management

pmuser

juser

Team 專案群組，包含一個小組成員 (juser) 和三個子群組 (其中每個子群組各包含一個小組成員的姓名)。

Example1\MyReports

Userone

Usertwo

Userthree

MyRemotes

userfour

userfive

Team 專案群組，包含三個小組成員的姓名，以及一個子群組 (其中包含兩個小組成員的姓名)。

BoolValues

true

false

一份含有兩個項目的全域清單。

範例：展開清單並排除群組

在這個範例中，欄位包含了一個字串值、一個群組與一個全域清單。 在執行階段，清單會展開且會排除群組。

範例

下拉式清單值

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

string

true

false

JayHamlin

PilarAckerman

ReshmaPatel

範例：展開清單和群組且不篩選

在這個範例中，欄位包含了一個字串值、兩個群組與一個全域清單。 在執行階段，清單會展開但不會排除群組。

範例

下拉式清單值

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

string

true

false

juser

juser2

devuser

testuser

pmuser

開發

測試

Program Management

範例：不展開清單或群組且不篩選

在這個範例中，欄位包含了一個字串值、兩個群組與一個全域清單。 在執行階段，清單不會展開並且不會篩選出群組。 這表示會顯示群組名稱，但不會顯示包含在這些群組內的使用者。

注意事項注意事項

其中不會顯示全域清單的名稱和內容。

範例

下拉式清單值

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

string

MyTeam

MyReports

範例：展開清單並排除群組和全域清單

在這個範例中，欄位包含了一個字串值、一個群組與一個全域清單。 在執行階段，清單會展開並篩選出群組。

注意事項注意事項

MyTeam 是被排除的群組，因此不會展開，而 BoolValues 是全域清單，因此也不會展開或顯示。

範例

下拉式清單值

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

字串

請參閱

概念

定義挑選清單

定義全域清單

定義使用者清單、挑選清單和全域清單