1. SXA検索

SXA検索サービス

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

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

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

サービスURL

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

業績

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

クエリ パラメーター

形容

値の例

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.詳細については、Solr自動提案の使用を参照してください。

クエリ パラメーター

形容

値の例

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ファイルで設定を更新できます。

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