--- title: "商取引検索範囲" slug: "commerce-search-scopes" abstract: "SXA Storefrontサイトテンプレートに含まれるCommerce検索範囲の概要。" --- # 商取引検索範囲 [スコープ](https://doc.sitecore.com/xp/en/users/sxa/100/sitecore-experience-accelerator/en/sxa-search-facets,-scopes,-and-tokens.html)はSXAの概念であり、検索レンダリングで使われます。これは開始場所と検索範囲を指定するクエリで構成され、検索結果をより意味のあるものに絞り込む機能を提供します。サイトページ、プロモーション商品、関連商品、現在のカテゴリの製品、またはページとカタログアイテムの両方を含むサイト全体をターゲットにするスコープクエリを定義できます。また、検索スコープ内のクエリトークンを用いて、実行時やアイテムの文脈でトークンを評価する動的クエリを作成できます。さらに、検索スコープを使う際に[はブースティングルール](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/boost-products-in-search-results-for-commerce.html "Boost products in search results for Commerce")の設定も可能です。 > !注Searchスコープは */sitecore/Content///Settings/Scopes*フォルダにサイトごとに格納されています。 ストアフロントサイトテンプレートには、以下のデフォルトのCommerce検索範囲が含まれています: - [カテゴリスコープ](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-search-scopes.html#UUID-146cc2b2-bf46-48fb-150f-30687207befb_section-5dbc90f6c2bb9-idm44771266193776 "Category scope") - 特定のカテゴリ内の商品を表示すること。 - [ハビタットカタログの範囲](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-search-scopes.html#UUID-146cc2b2-bf46-48fb-150f-30687207befb_section-5dbc91291b541-idm46038614350112 "Habitat catalog scope") - ハビタットカタログ全体内で製品を検索するためのものです。 - [おすすめ商品](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-search-scopes.html#UUID-146cc2b2-bf46-48fb-150f-30687207befb_section-idm273169950772708 "Recommended products scope") - (SXA Storefrontのサイトテンプレート [ホームページ](https://doc.sitecore.com/xp/en/users/100/sitecore-experience-commerce/en/commerce-home-page.html)で使用)は、直近の注文に基づいて推奨商品リストを検索するためのものです。 - [Miraノートパソコンのスコープ](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-search-scopes.html#UUID-146cc2b2-bf46-48fb-150f-30687207befb_section-5dbc9135955b4-idm44771265402848 "Mira laptops scope") - (SXAストアフロントサイトのテンプレート [ホームページ](https://doc.sitecore.com/xp/en/users/100/sitecore-experience-commerce/en/commerce-home-page.html)で使用)サンプルHabitatカタログからMiraブランドのノートパソコンのみをプロモーション製品として表示できます。 - [セール中のテレビは](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-search-scopes.html#UUID-146cc2b2-bf46-48fb-150f-30687207befb_section-5dbc91455b986-idm44771266196240 "On sale televisions scope") (SXAストアフロントサイトのテンプレートホームページで使用)サンプルHabitatカタログから販売中のテレビのみを宣伝商品として表示します。 - [PDPスコープ上の関連製品](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-search-scopes.html#UUID-146cc2b2-bf46-48fb-150f-30687207befb_section-5dbc9157d1bdc-idm45252097874448 "Related products on PDP scope") - (SXAストアフロントサイトテンプレートの [製品詳細ページで](https://doc.sitecore.com/xp/en/users/100/sitecore-experience-commerce/en/commerce-product-detail-page.html)使用)は、カタログで定義された関連商品を表示するためのものです。 > !重要ストアフロントサイトのテンプレートを使っていてHabitatカタログを使っていない場合は、デフォルトのスコープを自分のカタログを参照するように更新する必要があります。 検索構文を使えば、[独自のCommerce検索スコープを作成できます](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/define-a-commerce-search-scope.html "Define a Commerce search scope")。新しいスコープを作成するには、複数の [クエリトークン](https://doc.sitecore.com/xp/en/users/sxa/100/sitecore-experience-accelerator/en/sxa-search-facets,-scopes,-and-tokens.html)を追加できる検索クエリを作成します。 > !注以下の表では、クエリトークンのパラメータはトークン名の後に指定され、パイプ('|')で区切られています。 ## トークン Commerce検索範囲で[Commerceクエリトークン](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-search-scopes.html#UUID-146cc2b2-bf46-48fb-150f-30687207befb_informaltable-idm273145569911956)を使う場合、特定の[構文](https://doc.sitecore.com/xp/en/users/100/sitecore-experience-platform/en/build-a-search-query.html)があります: - 条件の値を定義する際に縦スラッシュ(パイプ)が使われます。例えば: ItemsWithTheSameValueInField|Field Name は ItemsWithTheSameValueInField: Field Name として表示され、検索結果が指定された名前のフィールドで同じ値でなければならないことを示します。例えば、インデックスフィールドの値は現在の項目の同じフィールドの値と一致していなければなりません。 - 先頭の下線はシステムの状態を示します。例えば、特定のワークフロー状態にある製品を含むクエリを作成できる\_workflow\_state、例えば「承認済み」などです。 - ItemsWithTheSameValueInParentChildFields|ItemFieldName|IndexFieldNameクエリトークンの場合、ダブルアンダースコアで始まる親フィールド名は、フィールドではなくアイテム上の属性に変換されます。例えば、フィールド名「\_\_id」を受け取り、それをContextItemに変換することができます。ContextItemの代わりにID。Fields\["\_\_id"\]はItemのために有用です。IDは通常のフィールドではなく、アイテム上のプロパティ/属性です。これはカテゴリナビゲーションの場合で、条件sxa:ItemsWithTheSameValueInParentChildFields|\_\_id|\_parentはインデックスフィールド\_parentのthe\_valueが現在のアイテムのIDプロパティの値と一致しなければならないことを指定しています。これは、インデックスフィールドの価値がコンテンツアイテムIDを参照\_parentことを知っている上で理にかなっています。 ## 条件 以下の表は利用可能なすべての条件を示しています。 状態 概要 \_LatestVersion この条件は、検索結果に製品の最新バージョンのみを表示するようにするために使われます。可能な値はtrueと\[blank\]です。 Commercesearchitemtype この条件により、検索は特定の種類のアイテムに限定されます。可能な値は、カテゴリ、販売可能なアイテム、カタログです。 カテゴリスコープの目的上、値はsellableitem(製品)に設定され、他のSitecoreアイテムが検索結果に表示されないようにするために使われます。 Excludefromwebsitesearchresults これは、商品が検索結果に [一度だけ表示される](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/configuring-site-searches-in-sxa-storefront.html#UUID-22097a20-862e-3b85-55e1-68cd3d47b7c1_para-idm273151795096982) ようにするためのオプション条件です。 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:UnderCurrentPage がカテゴリナビゲーションに使われ、現在のカテゴリのカタログ商品に限定されます。結果にはサブカテゴリや商品が深く含まれており、 *Audio* カテゴリではヘッドホンなどのサブカテゴリも含まれます。 Sxa: ItemsWithTheSameValueInParentChildField| ItemFIeldName|IndexFieldName この条件は、特定のインデックスフィールドで同じ値を持つアイテムに検索結果を限定するSXAクエリトークン ItemsWithTheSameValueInField|FieldName に似ています。2つのフィールド名を受け付け、現在の項目から親フィールドの値を読み込み、インデックスフィールド内のその値を持つ文書を検索します。 例えば、sxa:ItemsWithTheSameValueInParentChildFields|\_\_id|\_parentはカテゴリナビゲーションに使われ、現在のカテゴリの直下にある製品アイテムのみを選び、サブカテゴリに格納された商品は含まれません。Habitatカタログでは、製品が両方のレベルで関連付けられているため、 *Kickbuds Wireless Headphones* のような製品はオーディオとヘッドホンの両方に表示されます。 ## カテゴリーの範囲 カテゴリの範囲は、検索結果を特定の製品カテゴリに限定します。 ![Build a search query.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/Scope_Category.png) 商業検索トークンには以下が含まれます: 状態 概要 Commercesearchitemtype この条件により、検索は特定の種類のアイテムに限定されます。可能な値は、カテゴリ、販売可能なアイテム、カタログです。 カテゴリスコープの目的上、値はsellableitem(製品)に設定され、他のSitecoreアイテムが検索結果に表示されないようにするために使われます。 \_LatestVersion この条件は、検索結果に製品の最新バージョンのみを表示するようにするために使われます。可能な値はtrueと\[blank\]です。 Excludefromwebsitesearchresults これは、商品が検索結果に [一度だけ表示される](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/configuring-site-searches-in-sxa-storefront.html#UUID-22097a20-862e-3b85-55e1-68cd3d47b7c1_para-idm273151795096982) ようにするためのオプション条件です。 Parentcataloglist この条件は、複数のカタログが存在する場合に用いられ、1つのカタログ内の製品のみが表示されるようにします。 期待値はカタログ項目(GUID)のIDです。 SXAの検索トークンには以下が含まれます: トークン 概要 Sxa: UnderCurrentPage これはSXAの検索条件で、検索結果を現在のページまたはカテゴリに限定します。 Sxa: ItemsWithTheSameValueInParentChildField| ItemFIeldName|IndexFieldName このSXA検索条件は、2つのフィールド名を入力として受け入れます。 例えば、 sxa:ItemsWithTheSameValueInParentChildFields|\_\_id|\_parent ## 生息地カタログの範囲 ハビタットのカタログ範囲では、検索は特定のカタログに限定されています。 ![Habitat scope](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/Scope_Habitat.png) 取引条件とトークンには以下が含まれます: 状態 概要 Commercesearchitemtype この条件は、検索を特定の種類のアイテムに限定します。可能な値は、カテゴリ、販売可能なアイテム、カタログです。 \_LatestVersion この条件は、検索結果に製品の最新バージョンのみを表示するようにするために使われます。可能な値はtrueと\[blank\]です。 Excludefromwebsitesearchresults これは、商品が検索結果に [一度だけ表示される](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/configuring-site-searches-in-sxa-storefront.html#UUID-22097a20-862e-3b85-55e1-68cd3d47b7c1_para-idm273151795096982) ようにするためのオプション条件です。 Parentcataloglist この条件は、複数のカタログが存在する場合に用いられ、1つのカタログ内の製品のみが表示されるようにします。 期待値はカタログ項目(GUID)のIDです。 ## 推奨製品の範囲 推薦製品スコープは、最後の注文の [注文IDに基づく商品リストを返し](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/the-recommended-products-pipeline.html "The Recommended products pipeline") 、カタログで定義された関連商品関係を使用します。 ![Recommended products scope](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/Scope_RecommendedProducts.png) 取引条件とトークンには以下が含まれます: 状態 概要 Commercesearchitemtype この条件は、検索を特定の種類のアイテムに限定します。可能な値は、カテゴリ、販売可能なアイテム、カタログです。 Excludefromwebsitesearchresults これは、商品が検索結果に [一度だけ表示される](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/configuring-site-searches-in-sxa-storefront.html#UUID-22097a20-862e-3b85-55e1-68cd3d47b7c1_para-idm273151795096982) ようにするためのオプション条件です。 Sxa: RecommendedProducts|NumberOfProducts| RelationshipField|Scope このSXA検索条件は、直近の注文に基づいて関連商品を取得し、定義された関連商品数を返すために商品IDをクエリに注入します。「製品数」フィールドは返品商品の最大数であり、RelationshipFieldはカタログで定義された [「関係性」定義](https://doc.sitecore.com/xp/en/users/100/sitecore-experience-commerce/en/relationship-definitions.html) です。 スコープはフォールバックスコープです。最終注文の情報がない場合は、フォールバックスコープが使用されます。以下の例では、64817E77-2253-48D8-8838-E44EBBB601C7はセール中のテレビスコープのアイテムIDであり、これがフォールバックスコープです。 例えば sxa:RecommendedProducts|12|RelatedSellableItemToSellableItem|{64817E77-2253-48D8-8838-E44EBBB601C7} 64817E77-2253-48D8-8838-E44EBBB601C7 ## Miraノートパソコンのスコープ Miraノートパソコンの範囲では、検索はMiraブランドのノートパソコンに限定されています。 ![The Mira laptops scope.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/Scope_Mira.png) 2つのインデックスフィルター(ブランドとロケーション)に加え、以下のCommerceトークンがこの範囲で使用されます。 トークン 概要 Commercesearchitemtype この条件は検索を商品に限定し、他のSitecore商品が結果に表示されないようにするために使われます。 Excludefromwebsitesearchresults これは、商品が検索結果に [一度だけ表示される](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/configuring-site-searches-in-sxa-storefront.html#UUID-22097a20-862e-3b85-55e1-68cd3d47b7c1_para-idm273151795096982) ようにするためのオプション条件です。 ## 販売中のテレビのスコープ セール中のテレビの範囲は、セール中のテレビの定義された製品リストに検索を制限しています(*/sitecore/Content/Sitecore/Storefront/Data/Commerce/Product Lists/Promoted Products List*)。 ![The On sale televisions scope.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/Scope_OnSaleTVs.png) このスコープでは、1つのインデックスフィルター(ロケーション)に加え、以下のCommerceトークンが使用されています。 フィールド 概要 Commercesearchitemtype この条件は検索を商品に限定し、他のSitecore商品が結果に表示されないようにするために使われます。 Excludefromwebsitesearchresults これは、商品が検索結果に [一度だけ表示される](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/configuring-site-searches-in-sxa-storefront.html#UUID-22097a20-862e-3b85-55e1-68cd3d47b7c1_para-idm273151795096982) ようにするためのオプション条件です。 ## PDPスコープに関する関連製品 PDPの関連商品の範囲では、カタログで関連商品として定義されている製品に検索が制限されています。 ![The Related products on PDP scope.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/Scope_RelatedProducts.png) SXA条件Sxa: ProductRelationship|RelatedSellableItemtoSellableItemに加え、以下のCommerceトークンがこの範囲で使用されています。 トークン 概要 Excludefromwebsitesearchresults これは、商品が検索結果に [一度だけ表示される](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/configuring-site-searches-in-sxa-storefront.html#UUID-22097a20-862e-3b85-55e1-68cd3d47b7c1_para-idm273151795096982) ようにするためのオプション条件です。 Commercesearchitemtype この条件は検索を商品に限定し、他のSitecore商品が結果に表示されないようにするために使われます。 ProductRelationship|RelationshipField このクエリトークンは、指定された関係から現在の製品の関連商品を読み取り、それらの製品のIDをクエリに注入して、関連する商品だけを返すために使用されます。 例えば、 ProductRelationship|RelatedSellableItemToSellableItem は製品詳細ページで関連商品のリストをレンダリングするために使われます。