SearchDataSource (検索データソース)

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

SearchDataSourceコンポーネントを使用して、指定したルートアイテムからSitecoreアイテムを取得します。コンポーネントが取得する項目は、検索クエリで制限できます。ListControlなどの別のコンポーネントを使用して、SearchDataSourceコンポーネントが取得する項目を表示します。

デフォルトでは、SearchDataSourceコンポーネントは検索クエリに一致するすべてのアイテムを取得します。 PageSizeプロパティを0 >値に設定すると、SearchDataSourceコンポーネントは一度に指定した数の項目を取得します。 SearchDataSourceコンポーネントにアイテムの次の "ページ" を取得するように指示するには、nextイベントを発生させます。たとえば、ページにボタンを追加し、このボタンのClickプロパティを設定してnextイベントを呼び出すことができます。

初期検索を指定するには、検索構成項目を定義し、この構成項目のSearchフィールドに初期検索を指定します。次に、SearchConfigItemIdプロパティから構成アイテムを参照します。このアイテムを作成するときは、SearchPanel Configテンプレートを使用します。

ファセットは検索にも使用できます。ファセットは、グループ化に使用できるアイテムの明確な特性です。アイテムは複数のファセットを持つことができますが、各ファセットに対して1つの個別の値しか持つことができません。ファセットの例としては、ディメンション (画像のサイズ)、ファイルの種類、言語などがあります。

FilterControlコントロールを使用してファセットを表示します。ユーザーはファセットを選択および選択解除でき、検索はすぐに更新されます。

最初に、ユーザーに提示するファセットを作成する必要があります。 Facetテンプレートを使用して、各ファセットの項目を作成します。

検索クエリの構文

特定のフィールド値は、次の構文で検索できます。

<modifier><field name>:<search string>

どこ：

<modifier> は、複数のフィールド名を入力するときにSitecoreがこのフィールドの検索条件をどのように解釈するかを定義します。次の修飾子を使用できます。
- no修飾子はSHOULDに変換され、論理ORに対応します
- + はMUSTに変換され、論理ANDに対応します。
- – はMUST NOTに変換され、論理AND NOTに対応します
<field name> は、テンプレートフィールド名を指定します。フィールド名にスペースが埋め込まれている場合は、引用符で囲む必要があります。
<search string>単純なテキスト条件です。ワイルドカードとして * (アスタリスク) を使用できます。検索文字列にスペースが埋め込まれている場合は、引用符で囲む必要があります。

複数のフィールドの検索文字列をスペースで区切って含めることができます。

分別

Searchフィールドでは、次の構文を使用した並べ替えがサポートされています。

<field name><sort direction>

どこ：

<field name> は、テンプレートフィールド名を指定します。フィールド名にスペースが埋め込まれている場合は、引用符で囲みます。
<sort direction> オプションで、昇順または降順のソートを指定します。

指定できる値は次のとおりです。
- |ASC昇順の値を示します。
- |DESC降順の値を示します。

複数のソートフィールドを含めることができます。

プロパティ

Name	形容	デフォルト
Appearance
フォーマッティング	書式設定トークンを指定します。 $convert_date_to_friendly_format: 内部日付形式をローカライズ形式に変換する $send_localized_dates: すべての日付のローカライズ版を送信 $convert_id_to_display_name: アイテムIDをアイテムの表示名に変換します複数の形式をパイプで区切られた ("\|") リストとして入力できます。
分別	コンポーネントがアイテムをソートする方法を指定します。別のコントロールにバインドして、並べ替えを対話型にすることができます。たとえば、SearchDataSourceコンポーネントが取得する項目を表示するために、ListControlをよく使用します。SearchDataSourceコンポーネントのSortingプロパティをListControlのSortingプロパティにバインドでき、ユーザーがListControlの並べ替え「矢印」ボタンをクリックすると、SPEAKはSearchDataSourceコンポーネントに通知します。
Data
データベース	Sitecoreが検索するデータベースを指定します。データベースの正確な名前 ( coreやmasterなど)。 $context_database: コンテキストデータベース。 $context_contentdatabase: コンテンツデータベース。	コンテキストデータベース
ファセット	SearchDataSourceコンポーネントが使用するファセットを指定します。
ファセットルートアイテムID	子項目として検索ファセットを含む構成項目を指します。ファセット構成アイテムは、各ファセットのFacetテンプレートに基づいて作成します。
田畑	Sitecoreが検索するフィールドのパイプ区切り ("\|") リストを提供できます。アスタリスク "*" を入力すると、Sitecoreはすべてのフィールドを検索します。パフォーマンスを向上させるために、検索するフィールドをできるだけ少なくします。	何も入力しない場合は、すべてのフィールドが検索されます。
項目	取得したアイテムが格納されます。通常、このプロパティにバインドするのは、項目を表示できるコントロール ( ListControlコントロールなど) から行います。
言語	検索するアイテムの言語バージョンを指定します。空:すべての言語で検索します。 $context_language:CMSから現在の言語で検索正確な言語: 例: "ja-jp" や "en-us"	すべての言語
ルートアイテムID	検索を開始するコンテンツツリー内のアイテムをポイントします。	Sitecoreコンテンツツリーのルート。
SearchConfigItemId (検索構成項目ID)	検索構成を含む構成アイテムを指します。 SearchPanel Configテンプレートに基づいて構成アイテムをPageSettingsアイテムの子として作成し、このアイテムのフィールドを使用して検索を構成します。
選択済みファセット	コンポーネントが使用する使用可能なファセットを指定します。通常、このプロパティはFilterControlコントロールのSelectedFacetsプロパティにバインドします。これを行うと、ユーザーはFilterControlコントロールでファセットを選択でき、SearchDataSourceコンポーネントによって検索結果が更新されます。
テキスト	検索するテキスト。通常、この値は別のコンポーネントのテキストプロパティ(たとえば、ユーザーが検索語句を入力できるテキストボックス)にデータバインドします。ドロップダウンリストを使用して、ページ上の他のコンポーネントのプロパティを選択できます。
Paging
ページインデックス	SearchDataSourceコンポーネントは、PageSizeプロパティがページの合計数よりも小さい場合に、現在のページのインデックス (番号) でこのプロパティを更新します。
ページサイズ	コンポーネントがSitecoreから取得するアイテムの数を設定します。
ハスアイテム	検索でアイテムが見つかった場合はTrue(読み取り専用)。
ハズモアアイテム	データソースがまだクライアントに送信していないアイテムが検索結果に含まれている場合はTrue(読み取り専用)。
HasNoItems (アイテムなし)	データソースが検索結果のすべてのアイテムをクライアントに送信した場合はTrue(読み取り専用)。
ビジー	コンポーネントがサーバーからデータを取得している最中 (読み取り専用) の場合はTrue。

構成

SearchDataSource Parametersテンプレートに基づいて項目を作成することで、SearchDataSourceコンポーネントの構成項目を作成できます。

構成アイテムには、次の特定のフィールドがあります。

フォーマッティング
分別
テキスト
ファセットルートアイテムID
ファセット
SearchConfigItemId (検索構成項目ID)
項目
ルートアイテムID
選択済みファセット
ビジー
ハスアイテム
HasNoItems (アイテムなし)
ハズモアアイテム

次のフィールドを継承します。

データベース
田畑
ページサイズ
ページインデックス
言語
動作
身分証明書

この記事を改善するための提案がある場合は、お知らせください!