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

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

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

## ルート項目

以下のフィールドタイプの*Source*プロパティをルートアイテムに設定できます:

-   ドロップリンク
-   ドロップリスト
-   ドロップツリー
-   ファイル
-   グループ化されたドロップリンク
-   グループド・ドロップリスト
-   画像
-   マルチリスト
-   ツリーリスト
-   TreelistEx

Checklist、Droplink、Droplist、Multilistなどの単一レベルリストでは、ユーザーはルートアイテムの子リストを選択できます。

Grouped DroplinkやGrouped Droplistのようなグループリストでは、ユーザーはルートアイテムの孫を選択できます。

Droptree、File、Image、Treelist、TreelistExなどのツリーリストでは、ユーザーはルートアイテムの子孫を選択できます。

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

/Sitecore/Content/Home

## Sitecoreクエリ

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

例えば、データテンプレートに基づくホームアイテムの子を選択したい場合は、*Section*:

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

以下の例のように、クエリ内で $siteや $homeなどの組み込みトークンを使うことができます。特にマルチサイトでレンダリングを共有する場合に便利です。トークンは現在のサイトのコンテキストに基づいて動的に解決されます。

![Example of a token used in a query](https://doc.sitecore.com/api/markdown-image/sai/ja/developers/sitecoreai/images/TokensScreenshot.png)

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

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

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

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

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

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