SXA Searchサービス
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
SXA Searchサービスは検索コンポーネントで使用されるエンドポイントです。SXAツールボックスから利用可能なほとんどの検索コンポーネントはエンドポイントのデータを利用します。このトピックでは、SXA検索APIパラメータとその目的について説明します。
サービスURL
各定義されたサイトに対して、SXA Searchサービスは以下のエンドポイントURLでルートを登録します。これらのエンドポイントはSitecore.XA.Feature.Search.Controllers.SearchControllerクラスの公開メソッドに対応します。
結果
結果エンドポイントは検索を実行し、結果を返します。以下のパラメータを使用できます:
クエリパラメータ
概要
例の値
q
クエリ - 指定された単語で結果を返します。
レンダリング
v
バリアント - 結果をレンダリングするために使用されたバリアント定義項目のID。
{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
s
スコープ - あらかじめ定義されたフィルタリングを提供するスコープ定義項目のID。
{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
l
言語 - 検索結果に含まれる言語バージョン。
英語|PL
英語、プル語
o
順序付け - 指定されたファセットに基づいて結果をソートします。
タイトル、下降
e
オフセット - リターン結果から指定された数の要素を除外します。
30
p
ページサイズ - 指定されたページ数を返します。デフォルト値は20です。
20
g
ジオロケーション - 空間探索に使われるジオロケーションの緯度と経度。
55.676098|12.568337
sc_site
Sitecoreサイト - コンテキストサイトの名称です。
ショーケース
項目
item ID - 現在のコンテキスト中のアイテムID。
{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
シグ
署名 - 検索結果の署名。
my_signature_search
例えば:
https://sxa94\_003432/playground/sxa/search/results/?s={BAFF04C0-7332-4B72-A108-EE9814C62F16}&itemid={81003E8D-4232-433D-849E-6CA9574B5BD1}&v={2CA6BDE6-69BC-4D2A-AC6B-6DD88E300CF9}&p=20&o=Title,Ascending
ファセット
ファセットサービスは名前に基づいてファセットを検索します。以下のパラメータを使用できます:
クエリパラメータ
概要
例の値
q
クエリ - 検索用のユーザー文字列入力。
レンダリング
s
スコープ - あらかじめ定義されたフィルタリングを提供するスコープ定義項目のID。
{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
f
ファセット - ファセットアイテム名を返す予定です。
更新日、タグ
l
言語 - 検索結果に含まれる言語バージョン。
英語|PL
g
ジオロケーション - 空間探索に使用されるジオロケーションの緯度と経度
55.676098|12.568337
シグ
シグネチャー - 検索結果のシグネチャ
my_signature_search
例えば:
https://sxa94\_003432/playground/sxa/search/facets/?f=movie%20type,movie%20rated,movie%20genre&s={BAFF04C0-7332-4B72-A108-EE9814C62F16}&itemid={81003E8D-4232-433D-849E-6CA9574B5BD1}
提案
提案エンドポイントは検索提案を返します。このオプションを設定するには、Experience EditorのSearch Boxレンダリングでコントロール プロパティ を開き、Suggestionsモード のフィールドで 「予測を表示」 オプションを選択してください。
!注この機能はsxaSuggesterを使う際にSolr検索プロバイダーでのみ利用可能です。詳細は「Solrの自動提案を使いましょう」をご覧ください。
クエリパラメータ
概要
例の値
q
クエリ - 指定された単語で結果を返します。
レンダリング。
v
バリアント - 結果をレンダリングするために使用されたバリアント定義項目のID。
{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
p
ページサイズ - 指定されたページ数を返します。デフォルト値は5です。
5
項目
item ID - 現在のコンテキスト中のアイテムID。
{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
キャッシュ
デフォルトでは、検索およびファセットリクエストのキャッシュは無効化されています。 Sitecore.XA.Feature.Search.configファイル内の設定を更新できます:
