次の方法で共有

リスト項目の展開とリストからのグループの除外

  • [アーティクル]

expanditems 属性および filteritems 属性を使用して、リストを展開およびフィルター処理できます。 これらの属性をリスト型要素である ALLOWEDVALUES、SUGGESTEDVALUES、および PROHIBITEDVALUES に適用できます。

これらの属性を使用してフィールドのドロップダウン メニューを設定する方法について理解するには、次の例を確認してください。

トピック目次

  • リストとグループの展開

  • グループの除外

  • 例で使用されているリストおよびグループの内容

  • 例: リストの展開とグループの除外を行う

  • 例: リストとグループを展開し、フィルター処理を行わない

  • 例: リストとグループの展開およびフィルター処理を行わない

  • 例: リストの展開およびグループとグローバル リストの除外を行う

リストとグループの展開

expanditems には、true および false の値を割り当てることができます。既定値は true です。 expanditems の値が true の場合、グループまたはグローバル リストを表すリスト項目は再帰的に展開されます。 つまり、グループのサブグループが展開され、そのサブグループのサブグループも同様に展開されます。以降についても同様です。 展開後、グループを表していたリスト項目には、リスト項目値としてグループとユーザーの両方が含まれます。 expanditems に false が設定されている場合、グループまたはグループ リストの展開は実行されません。

グループの除外

filteritems 属性には、excludegroups という値だけを割り当てることができます。 この属性が指定されると、すべてのリスト項目が評価され、グループは削除されます。 グループではなく、ユーザーのみを表示にするには、filteritems 属性を使用します。

例で使用されているリストおよびグループの内容

このトピックの例には、次の値が使用されています。

リストまたはグループの名前

リストまたはグループの内容

説明

[Project]\Business Analysts

JayHamlin

PilarAckerman

ReshmaPatel

3 人のビジネス アナリスト チーム メンバーの名前を含むチーム プロジェクト グループです。

メモメモ
チーム プロジェクトの実際の名前ではなく、リテラル プリフィックス [Project] を使用します。

Example1\MyTeam

Development

devuser

Test

Test user

Program Management

pmuser

juser

1 人のチーム メンバー (juser) と 3 つのサブグループを含むチーム プロジェクト グループです。各サブグループには、1 人のチーム メンバーの名前が含まれています。

Example1\MyReports

Userone

Usertwo

Userthree

MyRemotes

userfour

userfive

3 人のチーム メンバーの名前と、2 人のチーム メンバーの名前を含む 1 つのサブグループを含むチーム プロジェクト グループです。

BoolValues

true

false

2 つのエントリから成るグローバル リストです。

例: リストの展開とグループの除外を行う

この例では、フィールドには、文字列値、グループ、およびグローバル リストが含まれています。 実行時にリストが展開され、グループは除外されます。

例

ドロップダウン リストの値

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

string

true

false

JayHamlin

PilarAckerman

ReshmaPatel

例: リストとグループを展開し、フィルター処理を行わない

この例では、フィールドには、文字列値、2 つのグループ、およびグローバル リストが含まれています。 実行時にリストが展開され、グループは除外されません。

例

ドロップダウン リストの値

 
<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

Development

Test

Program Management

例: リストとグループの展開およびフィルター処理を行わない

この例では、フィールドには、文字列値、2 つのグループ、およびグローバル リストが含まれています。 実行時にリストは展開されず、グループはフィルター処理されません。 つまり、表示されるのはグループ名であり、そのグループ内のユーザーではありません。

注意

グローバル リスト名とその内容は表示されません。

例

ドロップダウン リストの値

 
<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> 

String

参照

概念

選択リストの定義

グローバル リストの定義

その他の技術情報

リスト、選択リスト、およびグローバル リストの定義と使用