店舗検索

商取引検索範囲

Version:

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

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

スコープはSXAの概念であり、検索レンダリングで使われます。これは開始場所と検索範囲を指定するクエリで構成され、検索結果をより意味のあるものに絞り込む機能を提供します。サイトページ、プロモーション商品、関連商品、現在のカテゴリの製品、またはページとカタログアイテムの両方を含むサイト全体をターゲットにするスコープクエリを定義できます。また、検索スコープ内のクエリトークンを用いて、実行時やアイテムの文脈でトークンを評価する動的クエリを作成できます。さらに、検索スコープを使う際にはブースティングルールの設定も可能です。

!注Searchスコープは /sitecore/Content///Settings/Scopesフォルダにサイトごとに格納されています。

ストアフロントサイトテンプレートには、以下のデフォルトのCommerce検索範囲が含まれています:

カテゴリスコープ - 特定のカテゴリ内の商品を表示すること。
ハビタットカタログの範囲 - ハビタットカタログ全体内で製品を検索するためのものです。
おすすめ商品 - (SXA Storefrontのサイトテンプレートホームページで使用)は、直近の注文に基づいて推奨商品リストを検索するためのものです。
Miraノートパソコンのスコープ - (SXAストアフロントサイトのテンプレートホームページで使用)サンプルHabitatカタログからMiraブランドのノートパソコンのみをプロモーション製品として表示できます。
セール中のテレビは (SXAストアフロントサイトのテンプレートホームページで使用)サンプルHabitatカタログから販売中のテレビのみを宣伝商品として表示します。
PDPスコープ上の関連製品 - (SXAストアフロントサイトテンプレートの製品詳細ページで使用)は、カタログで定義された関連商品を表示するためのものです。

!重要ストアフロントサイトのテンプレートを使っていてHabitatカタログを使っていない場合は、デフォルトのスコープを自分のカタログを参照するように更新する必要があります。

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

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

トークン

Commerce検索範囲でCommerceクエリトークンを使う場合、特定の構文があります:

条件の値を定義する際に縦スラッシュ(パイプ)が使われます。例えば: ItemsWithTheSameValueInField|Field Name は ItemsWithTheSameValueInField: Field Name として表示され、検索結果が指定された名前のフィールドで同じ値でなければならないことを示します。例えば、インデックスフィールドの値は現在の項目の同じフィールドの値と一致していなければなりません。
先頭の下線はシステムの状態を示します。例えば、特定のワークフロー状態にある製品を含むクエリを作成できる_workflow_state、例えば「承認済み」などです。
ItemsWithTheSameValueInParentChildFields|ItemFieldName|IndexFieldNameクエリトークンの場合、ダブルアンダースコアで始まる親フィールド名は、フィールドではなくアイテム上の属性に変換されます。例えば、フィールド名「__id」を受け取り、それをContextItemに変換することができます。ContextItemの代わりにID。Fields["__id"]はItemのために有用です。IDは通常のフィールドではなく、アイテム上のプロパティ/属性です。これはカテゴリナビゲーションの場合で、条件sxa
|__id|_parentはインデックスフィールド_parentのthe_valueが現在のアイテムのIDプロパティの値と一致しなければならないことを指定しています。これは、インデックスフィールドの価値がコンテンツアイテムIDを参照_parentことを知っている上で理にかなっています。

条件

以下の表は利用可能なすべての条件を示しています。

状態

概要

_LatestVersion

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

Commercesearchitemtype

この条件により、検索は特定の種類のアイテムに限定されます。可能な値は、カテゴリ、販売可能なアイテム、カタログです。

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

Excludefromwebsitesearchresults

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

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

例えば、顧客検索では Excludefromwebsitesearchresults|false が使われ、結果が重複しないインスタンスのみを返すように制限されます。すべてのユニークな製品のインスタンスを1つ。

Parentcataloglist

この条件はターゲットとなるカタログを指定するために使われます。複数のカタログが存在する場合、1つのカタログ内の製品のみが返送されるようにするのに役立ちます。

例えば、 ParentCataloglist|{59DDADC1-9B88-727E-9E14-3F6CF321AE0F} はカテゴリナビゲーションや検索に使われ、ハビタットカタログのみを対象としています。

ProductRelationship

このクエリトークンは、指定された関係から現在の製品の関連商品を読み取り、それらの製品のIDをクエリに注入して、関連する商品だけを返すために使用されます。

例えば、 ProductRelationship|RelatedSellableItemToSellableItem は製品詳細ページで関連商品のリストをレンダリングするために使われます。

Sxa: UnderCurrentPage

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

ストアフロントのサイトテンプレートでは、 sxa

がカテゴリナビゲーションに使われ、現在のカテゴリのカタログ商品に限定されます。結果にはサブカテゴリや商品が深く含まれており、 Audio カテゴリではヘッドホンなどのサブカテゴリも含まれます。

Sxa: ItemsWithTheSameValueInParentChildField| ItemFIeldName|IndexFieldName

この条件は、特定のインデックスフィールドで同じ値を持つアイテムに検索結果を限定するSXAクエリトークン ItemsWithTheSameValueInField|FieldName に似ています。2つのフィールド名を受け付け、現在の項目から親フィールドの値を読み込み、インデックスフィールド内のその値を持つ文書を検索します。

例えば、sxa

|__id|_parentはカテゴリナビゲーションに使われ、現在のカテゴリの直下にある製品アイテムのみを選び、サブカテゴリに格納された商品は含まれません。Habitatカタログでは、製品が両方のレベルで関連付けられているため、 Kickbuds Wireless Headphones のような製品はオーディオとヘッドホンの両方に表示されます。

カテゴリーの範囲

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

商業検索トークンには以下が含まれます:

状態

概要

Commercesearchitemtype

この条件により、検索は特定の種類のアイテムに限定されます。可能な値は、カテゴリ、販売可能なアイテム、カタログです。

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

_LatestVersion

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

Excludefromwebsitesearchresults

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

Parentcataloglist

この条件は、複数のカタログが存在する場合に用いられ、1つのカタログ内の製品のみが表示されるようにします。

期待値はカタログ項目(GUID)のIDです。

SXAの検索トークンには以下が含まれます:

トークン

概要

Sxa: UnderCurrentPage

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

Sxa: ItemsWithTheSameValueInParentChildField| ItemFIeldName|IndexFieldName

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

例えば、 sxa

|__id|_parent

生息地カタログの範囲

ハビタットのカタログ範囲では、検索は特定のカタログに限定されています。

取引条件とトークンには以下が含まれます:

状態

概要

Commercesearchitemtype

この条件は、検索を特定の種類のアイテムに限定します。可能な値は、カテゴリ、販売可能なアイテム、カタログです。

_LatestVersion

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

Excludefromwebsitesearchresults

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

Parentcataloglist

この条件は、複数のカタログが存在する場合に用いられ、1つのカタログ内の製品のみが表示されるようにします。

期待値はカタログ項目(GUID)のIDです。

推奨製品の範囲

推薦製品スコープは、最後の注文の注文IDに基づく商品リストを返し、カタログで定義された関連商品関係を使用します。

取引条件とトークンには以下が含まれます:

状態

概要

Commercesearchitemtype

この条件は、検索を特定の種類のアイテムに限定します。可能な値は、カテゴリ、販売可能なアイテム、カタログです。

Excludefromwebsitesearchresults

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

Sxa: RecommendedProducts|NumberOfProducts| RelationshipField|Scope

このSXA検索条件は、直近の注文に基づいて関連商品を取得し、定義された関連商品数を返すために商品IDをクエリに注入します。「製品数」フィールドは返品商品の最大数であり、RelationshipFieldはカタログで定義された「関係性」定義です。

スコープはフォールバックスコープです。最終注文の情報がない場合は、フォールバックスコープが使用されます。以下の例では、64817E77-2253-48D8-8838-E44EBBB601C7はセール中のテレビスコープのアイテムIDであり、これがフォールバックスコープです。

例えば sxa

|12|RelatedSellableItemToSellableItem|{64817E77-2253-48D8-8838-E44EBBB601C7} 64817E77-2253-48D8-8838-E44EBBB601C7

Miraノートパソコンのスコープ

Miraノートパソコンの範囲では、検索はMiraブランドのノートパソコンに限定されています。

2つのインデックスフィルター(ブランドとロケーション)に加え、以下のCommerceトークンがこの範囲で使用されます。

トークン

概要

Commercesearchitemtype

この条件は検索を商品に限定し、他のSitecore商品が結果に表示されないようにするために使われます。

Excludefromwebsitesearchresults

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

販売中のテレビのスコープ

セール中のテレビの範囲は、セール中のテレビの定義された製品リストに検索を制限しています(/sitecore/Content/Sitecore/Storefront/Data/Commerce/Product Lists/Promoted Products List)。

このスコープでは、1つのインデックスフィルター(ロケーション)に加え、以下のCommerceトークンが使用されています。

フィールド

概要

Commercesearchitemtype

この条件は検索を商品に限定し、他のSitecore商品が結果に表示されないようにするために使われます。

Excludefromwebsitesearchresults

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

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

PDPの関連商品の範囲では、カタログで関連商品として定義されている製品に検索が制限されています。

SXA条件Sxa: ProductRelationship|RelatedSellableItemtoSellableItemに加え、以下のCommerceトークンがこの範囲で使用されています。

トークン

概要

Excludefromwebsitesearchresults

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

Commercesearchitemtype

この条件は検索を商品に限定し、他のSitecore商品が結果に表示されないようにするために使われます。

ProductRelationship|RelationshipField

例えば、 ProductRelationship|RelatedSellableItemToSellableItem は製品詳細ページで関連商品のリストをレンダリングするために使われます。

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