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

發行項
02/28/2013

您可以使用 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" 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="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

範例

下拉式清單值

<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>`	字串