SXA検索

SXA検索サービス

Version:

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

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

SXA Search Serviceは、検索コンポーネントによって使用されるエンドポイントです。SXAツールボックスから入手できるほとんどの検索コンポーネントは、エンドポイントからのデータを消費します。このトピックでは、SXA検索APIのパラメーターとその目的について説明します。

サービスURL

定義されたサイトごとに、SXA Searchサービスはルートを次のエンドポイントURLに登録します。これらのエンドポイントは、Sitecore.XA.Feature.Search.Controllers.SearchControllerクラスのパブリックメソッドに対応します。

site/sxa/search/results - 検索結果を取得します。
site/sxa/search/facets - ファセットされたデータを提供します。
site/sxa/search/suggestions- 提案データを提供します。

業績

結果エンドポイントは検索を実行し、結果を返します。次のパラメータを使用できます。

クエリパラメーター	形容	値の例
q	query - 指定した単語で結果を返します。	レンダリング
v	variant - 結果のレンダリングに使用されたバリアント定義アイテムのID。	{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
s	scope - 定義済みのフィルタリングを提供するスコープ定義アイテムのID。	{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
l	language - 検索結果に含める言語バージョン。	日本語\|PL 英語,英語
o	ordering - 指定したファセットに基づいて結果をソートします。	タイトル、降順
e	offset - 指定された量の要素を返された結果から除外します。	30
p	page size - 指定したページ数を返します。デフォルト値は20です。	20
g	geolocation - 空間検索に使用されるジオロケーションの緯度と経度。	55.676098\|12.568337
sc_site	sitecore site - コンテキストサイトの名前。	ショーケース
アイテムID	item ID - 現在のコンテキストアイテムID。	{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
シグ	signature - 検索結果の署名。	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	query - 検索するユーザー文字列入力。	レンダリング
s	scope - 定義済みのフィルタリングを提供するスコープ定義アイテムのID。	{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
f	facets - 返すファセット項目名。	更新日、タグ
l	language - 検索結果に含める言語バージョン。	日本語\|PL
g	geolocation - 空間検索に使用されるジオロケーションの緯度と経度	55.676098\|12.568337
シグ	signature - 検索結果の署名	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}

提案

suggestionsエンドポイントは検索候補を返します。このオプションを設定するには、エクスペリエンスエディターの検索ボックスレンダリングでControl Propertiesを開き、Suggestions modeフィールドでShow predictionsオプションを選択します。

メモ

この機能は、Solr検索プロバイダーがsxaSuggester.詳細については、「???.

クエリパラメーター	形容	値の例
q	query - 指定した単語を含む結果を返します。	レンダリング。
v	variant - 結果のレンダリングに使用されたバリアント定義アイテムのID。	{A907975A-8C25-4433-A8ED-02B5FC1EBA29}
p	page size - 指定したページ数を返します。デフォルト値は5です。	5
アイテムID	item ID - 現在のコンテキストアイテムID。	{A907975A-8C25-4433-A8ED-02B5FC1EBA29}

キャッシング

デフォルトでは、検索要求とファセット要求のキャッシングは無効になっています。 Sitecore.XA.Feature.Search.configファイルで設定を更新できます。

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