---
title: "選択フィールド内のアイテムリストの制御"
slug: "controlling-the-list-of-items-in-a-selection-field"
abstract: "ユーザーが選択できるフィールドの選択リストに表示されるアイテムの制御方法。"
---
# 選択フィールド内のアイテムリストの制御

データテンプレートフィールドのSourceプロパティは、ユーザーが0つ以上の項目を選択できるフィールドの選択リストに表示される項目を制御するための3つの技術をサポートしています。

> !noteデータテンプレートフィールドのSourceプロパティを、以下のセクションで説明するようにSitecoreクエリまたはTreelistパラメータに設定すると、データテンプレートフィールド定義項目のSourceフィールドに1つ以上の壊れたリンクが含まれていることを示すプロンプトが表示されることがあります。この警告は無視して、変更をデータテンプレートフィールド定義項目に保存してください。

## ルート項目

Droplink、Droplist、Droptree、File、Grouped Droplink、Grouped Droplist、Image、Multilist、Treelist、またはTreelistExフィールドタイプのソースプロパティをルートアイテムに設定できます。Checklist、Droplink、Droplist、Multilistなどの単一レベルリストでは、ユーザーはルートアイテムの子を選択できます。Grouped DroplinkやGrouped Droplistのようなグループリストでは、ユーザーはルートアイテムの孫を選択できます。Droptree、File、Image、Treelist、TreelistExなどのツリーリストでは、ユーザーはルートアイテムの子孫を選択できます。

例えば、/Sitecore/Content/Home項目の下から選択できるようにするには、Sourceプロパティを次のように設定します。

/Sitecore/Content/Home
## Sitecoreクエリ

query:プレフィックスを使って、チェックリスト、ドロップリンク、ドロップリスト、グループドドロップリスト、マルチリストフィールドのソースプロパティをSitecoreクエリに設定できます。

例えば、Sectionという名前のデータテンプレートに基づくホームアイテムの子を選択できるようにする場合:

query:/sitecore/content/home/\*@@templatename='Section'

## ツリーリストパラメータ

TreelistやTreelistExフィールドタイプのSourceプロパティを、任意の数のkey=valueパラメータをアンパサンド文字(&)で区切って設定できます。

例えば、ユーザーがホームアイテムの子孫を選択できるようにするために、*Section*と名付けられたデータテンプレートまたはデータ*Page*テンプレートのどちらかを基にしています:

DataSource=/Sitecore/Content/Home&IncludeTemplatesForSelection=section,page

以下のパラメータを指定できます:

-   DataSource:ルートアイテム。
-   DatabaseNameデータソースを含むデータベース名。
-   IncludeTemplatesForSelection: ユーザーはこのカンマ区切られたデータテンプレート名のリストに基づいてのみ項目を選択できます。
-   ExcludeTemplatesForSelection: ユーザーはこのカンマ区切られたデータテンプレート名のリストに基づいて項目を選択することはできません。
-   IncludeTemplatesForDisplay: ユーザーはこのカンマ区切られたデータテンプレート名とIDのリストに基づいてのみアイテムをナビゲートできます。
-   ExcludeTemplatesForDisplay: ユーザーはこのカンマ区切られたデータテンプレート名とIDのリストに基づいてアイテムをナビゲートできません。
-   IncludeItemsForDisplay: ユーザーはこのカンマ区切られたアイテム名とIDのリストに基づいてのみアイテムをナビゲートできます。
-   ExcludeItemsForDisplay: ユーザーはこのカンマ区切られたアイテム名とIDのリストに基づいてアイテムをナビゲートできません。
-   AllowMultipleSelection: もしそうなら、ユーザーは同じアイテムを複数回選択できます。