コマースの検索範囲

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

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

スコープはSXAの概念であり、検索レンダリングで使用されます。これは、検索の開始場所と範囲を指定するクエリで構成され、検索結果を絞り込んでより意味のあるものにすることができます。サイト ページ、プロモーション製品、関連製品、現在のカテゴリの製品、またはページとカタログ アイテムの両方を含むサイト全体を対象とするスコープ クエリを定義できます。また、検索スコープでクエリ トークンを使用すると、トークンが実行時および特定の項目のコンテキストで評価される動的クエリを作成できます。さらに、検索範囲を使用する場合は、ブースティング ルールを構成できます。

メモ

検索範囲は、サイトごとに /sitecore/Content/<tenant>/<site>/Settings/Scopesフォルダに格納されます。

Storefrontサイト テンプレートには、次の既定のCommerce検索範囲が含まれています。

大事な

ストアフロント サイト テンプレートを使用しているが、Habitatカタログを使用していない場合は、独自のカタログを参照するように既定のスコープを更新する必要があります。

検索構文を使用して、独自のCommerce検索範囲を作成できます。新しいスコープを作成するには、複数の クエリ トークンを追加できる検索クエリを作成します。

手記

次の表では、クエリ トークンのパラメータはトークン名の後に指定され、パイプ ('|') で区切られています。

トークン

Commerce検索スコープでCommerceクエリ トークンを使用する場合に使用する特定の構文があります。

  • 垂直スラッシュ (パイプ) は、条件の値を定義するときに使用されます。例: ItemsWithTheSameValueInField|Field NameはItemsWithTheSameValueInField: Field Nameと表示され、検索結果のフィールド内で指定された名前のフィールドに同じ値が含まれている必要があることを示します (たとえば、インデックス フィールドの値は現在のアイテムの同じフィールドの値と一致する必要があります)。

  • 先頭のアンダースコアは、システムの状態を示します。たとえば、_workflow_state、承認済みなどの特定のワークフロー状態にある製品を含むクエリを作成できます。

  • ItemsWithTheSameValueInParentChildFields|ItemFieldName|IndexFieldNameクエリ トークンの場合、二重アンダースコア __ で始まる親フィールド名は、フィールドではなくアイテムの属性に変換されます。たとえば、フィールド名 "__id" を受け入れて、ContextItem.Fields"__id" の代わりにContextItem.ID ContextItem.Fields"" に変換することができます。これは、Item.IDアイテムのプロパティ/属性であり、通常のフィールドではないため便利です。これはカテゴリナビゲーションの場合で、条件sxa:ItemsWithTheSameValueInParentChildFields|__id|_parentは、インデックスフィールド _parentのthe_valueが現在のアイテムのIDプロパティの値と一致する必要があることを指定します。これは、インデックス フィールドの値がコンテンツ アイテムIDを参照する_parentわかっているため、理にかなっています。

条件

次の表に、使用可能なすべての条件を示します。

条件

形容

_LatestVersion

この条件は、製品の最新バージョンのみが検索結果に表示されるようにするために使用されます。可能な値はtrueと blank です。

Commercesearchitemtype

この条件は、検索を特定のタイプのアイテムに制限します。可能な値は、category、sellableitem、catalogです。

Categoryスコープの目的上、値はsellableitem (製品) に設定され、他のSitecoreアイテムが検索結果に表示されないようにするために使用されます。

Excludefromwebsitesearchresults

これは、商品が検索結果に 一度だけ表示される ようにするために使用されるオプションの条件です。

Commerce Control Panelでは、 Exclude Duplicate Search Resultsの値を構成でき、trueに設定すると、重複するインスタンスに対してインデックス フィールドの値をtrueに設定するようにインデクサーに指示します。デフォルトでは、すべてのインスタンスの値がfalseに設定されています。

たとえば、Excludefromwebsitesearchresults|falseは、重複しないインスタンス (たとえば、すべての一意の製品の1つのインスタンス) のみを返すように結果を制限するために、顧客の検索で使用されます。

Parentcataloglist

この条件は、ターゲットとするカタログを指定するために使用されます。複数のカタログがある場合、1つのカタログ内の製品のみが返されるようにすると便利です。

たとえば、ParentCataloglist|{59DDADC1-9B88-727E-9E14-3F6CF321AE0F} は、カテゴリ ナビゲーションや、Habitatカタログのみをターゲットにする検索に使用されます。

カテゴリの範囲

カテゴリ範囲は、検索結果を特定の製品カテゴリに制限します。

Build a search query.

コマース検索トークンには、次のものが含まれます。

条件

形容

Commercesearchitemtype

この条件は、検索を特定のタイプのアイテムに制限します。可能な値は、category、sellableitem、catalogです。

Categoryスコープの目的上、値はsellableitem (製品) に設定され、他のSitecoreアイテムが検索結果に表示されないようにするために使用されます。

_LatestVersion

この条件は、製品の最新バージョンのみが検索結果に表示されるようにするために使用されます。可能な値はtrueと blank です。

Excludefromwebsitesearchresults

これは、商品が検索結果に 一度だけ表示される ようにするために使用されるオプションの条件です。

Parentcataloglist

この条件は、複数のカタログがある場合に、1つのカタログ内の製品のみが表示されるようにするために使用されます。

想定される値は、カタログ項目のID (GUID) です。

SXA検索トークンには次のものが含まれます。

トークン

形容

Sxa: UnderCurrentPage

これは、検索結果を現在のページまたはカテゴリに制限するSXA検索条件です。

Sxa: ItemsWithTheSameValueInParentChildField| ItemFIeldName|IndexFieldName

このSXA検索条件は、入力として2つのフィールド名を受け入れます。

例えば sxa:ItemsWithTheSameValueInParentChildFields|__id|_parent

ハビタット カタログの範囲

Habitatカタログのスコープは、検索を特定のカタログに制限します。

Habitat scope

コマース条件とトークンには、次のものが含まれます。

条件

形容

Commercesearchitemtype

この条件は、検索を特定のタイプのアイテムに制限します。可能な値は、category、sellableitem、catalogです。

_LatestVersion

この条件は、製品の最新バージョンのみが検索結果に表示されるようにするために使用されます。可能な値はtrueと blank です。

Excludefromwebsitesearchresults

これは、商品が検索結果に 一度だけ表示される ようにするために使用されるオプションの条件です。

Parentcataloglist

この条件は、複数のカタログがある場合に、1つのカタログ内の製品のみが表示されるようにするために使用されます。

想定される値は、カタログ項目のID (GUID) です。

推奨製品の範囲

推奨製品スコープは、最後に行われた注文 の注文IDに基づいて製品の一覧を返し 、カタログで定義されている関連製品のリレーションシップを使用します。

Recommended products scope

コマース条件とトークンには、次のものが含まれます。

条件

形容

Commercesearchitemtype

この条件は、検索を特定のタイプのアイテムに制限します。可能な値は、category、sellableitem、catalogです。

Excludefromwebsitesearchresults

これは、商品が検索結果に 一度だけ表示される ようにするために使用されるオプションの条件です。

Sxa: RecommendedProducts|NumberOfProducts| RelationshipField|Scope

このSXA検索条件は、最後の注文に基づいて関連商品を取得し、商品IDをクエリに挿入して、定義された数の関連商品が返されるようにします。製品数 フィールドは返品される製品の最大数で、RelationshipFieldはカタログで定義されている 関連付け定義 です。

スコープはフォールバックスコープです。最後の注文情報がない場合は、フォールバックスコープが使用されます。次の例では、64817E77-2253-48D8-8838-E44EBBB601C7は、フォールバックスコープである On sale television スコープのアイテムIDです。

例えば sxa:RecommendedProducts|12|RelatedSellableItemToSellableItem|{64817E77-2253-48D8-8838-E44EBBB601C7} 64817E77-2253-48D8-8838-E44EBBB601C7

Miraラップトップの範囲

Miraラップトップの範囲は、検索をMiraブランドのラップトップに制限します。

The Mira laptops scope.

このスコープでは、2つのインデックス フィルター (ブランドと場所) に加えて、次のCommerceトークンが使用されます。

トークン

形容

Commercesearchitemtype

この条件は、検索を製品に制限し、他のSitecoreアイテムが結果に表示されないようにするために使用されます。

Excludefromwebsitesearchresults

これは、商品が検索結果に 一度だけ表示される ようにするために使用されるオプションの条件です。

発売中のテレビの範囲

販売中のテレビ スコープは、検索を 販売中のテレビ (/sitecore/Content/Sitecore/Storefront/Data/Commerce/Product Lists/Promoted Products List) の定義済み製品リストに限定します。

The On sale televisions scope.

1つのインデックス フィルター (場所) に加えて、このスコープでは次のCommerceトークンが使用されます。

畑

形容

Commercesearchitemtype

この条件は、検索を製品に制限し、他のSitecoreアイテムが結果に表示されないようにするために使用されます。

Excludefromwebsitesearchresults

これは、商品が検索結果に 一度だけ表示される ようにするために使用されるオプションの条件です。

PDPスコープに関する関連製品

PDPの関連製品 スコープは、カタログで関連製品として定義されている製品に検索を制限します。

The Related products on PDP scope.

このスコープでは、1つのSXA条件Sxa: ProductRelationship|RelatedSellableItemtoSellableItemに加えて、次のCommerceトークンが使用されます。

トークン

形容

Excludefromwebsitesearchresults

これは、商品が検索結果に 一度だけ表示される ようにするために使用されるオプションの条件です。

Commercesearchitemtype

この条件は、検索を製品に制限し、他のSitecoreアイテムが結果に表示されないようにするために使用されます。

ProductRelationship|RelationshipField

このクエリ トークンは、指定されたリレーションシップから現在の製品の関連製品を読み取り、製品のIDをクエリに挿入して、関連製品のみが返されるようにするために使用されます。

たとえば、ProductRelationship|RelatedSellableItemToSellableItemは、関連製品のリストを表示するために、製品詳細ページで使用されます。

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、