ファセット探索の利用

最大限界を超える面の値を返す

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

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

Sitecore Searchでは、返されるfacetsのデフォルト数は10です。APIリクエストのmaxパラメータを使って返されるファセット値の数を設定できます。ただし、リクエストあたりの絶対最大100個までです。パフォーマンスと安定性を確保しつつ、100以上のファセット値を返す必要がある場合もあります。

最初の100以降の結果は、以下のいずれかのオプションで返すことができます:

afterパラメータ - ページ化
keyphraseパラメータ

!警告ページ分けとkeyphraseフィルタリングを同時に使うことはできません。

ページ付けの使用

ファセット値内にページを割り当てることで、すべての結果を返すことができます。 afterパラメータはファセットIDで定義されたものの後に続くすべての結果を返します。

!注これは、あなたのファセットが用語ファセットであり、テキストごとにソートされ、並べascまたはdescソートが適用される必要があります。

例えば、最初のリクエストで100件の結果が返された場合、最後に受け取った項目をafterの値を設定して別のリクエストを実行することができます。これにより、101以降の結果が返されます。以下の2つのサンプルリクエストとレスポンスは、その方法を示しています。

このサンプルリクエストは、以下のサンプルリクエストを用いて、すべてのcategory_breadcrumbs facetsをアルファベット順(テキスト、昇順)で最大100まで要求する方法を示しています:

{ "widget": { "items": { "rfk_id": "product_services", "search": { "content": {}, "facet": { "all": false, "types": { "name": "category_breadcrumbs", "sort": { "name": "text", "order": "asc" } } , "max": 100 }, "offset": 0, "limit": 15 }, "entity": "content" }

} }

応答は最初の100個の面の価値をアルファベット順に表示します。スペースを保つため、このサンプル応答は最初の値のみを表示します。

} , "content": … , "total_item": 2113, "limit": 15, "offset": 0 } , "dt": 12, "ts": 1734517554835 }

このサンプルリクエストは、上記の結果から最後のfacetidを加え、afterパラメータに置く方法を示しています。

{ "widget": { "items": { "rfk_id": "product_services", "search": { "content": {}, "facet": { "all": false, "types": { "name": "category_breadcrumbs", "after": "facetid_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6Ii9FbiBVc2RpZ2l0YWwgU29sdXRpb25zL09wdGltaXphdGlvbiJ9", "sort": { "name": "text", "order": "asc" } } , "max": 100 }, "offset": 0, "limit": 15 }, "entity": "content" }

} }

このサンプル回答は、Sitecore Searchがアルファベット順に最大100個の面値を返す方法を示しています。 Digital Solutions/Optimizationの後の結果から始まります(この例では2つのみ含めています):

} , "content": … , "total_item": 2113, "limit": 15, "offset": 0 } , "dt": 21, "ts": 1734518180187 }

keyphraseパラメータを使いましょう

widget.items.search.facet.types.keyphraseのkeyphraseパラメータを使ってファセット値を検索できます。次の例では、Drilling。

これがサンプルリクエストです:

{ "widget": { "items": { "rfk_id": "product_services", "search": { "content": {}, "facet": { "all": false, "types": { "name": "category_breadcrumbs", "keyphrase": "Drilling" }

}, "offset": 0, "limit": 15 }, "entity": "content" }

} }

これがサンプル応答です:

{ "widgets": { "rfk_id": "product_services", "type": "preview_search", "used_in": "common_across_pages", "entity": "content", "facet": { "name": "category_breadcrumbs", "label": "Category Breadcrumbs", "value": { "id": "facetid_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nIn0=", "text": "Drilling", "count": 309 }, { "id": "facetid_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nL0Rvd25ob2xlIERyaWxsaW5nIFRlY2hub2xvZ2llcyJ9", "text": "Drilling/Downhole Drilling Technologies", "count": 74 }, { "id": "facetid_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nL0Zpc2hpbmcgVG9vbHMifQ==", "text": "Drilling/Fishing Tools", "count": 26 }, { "id": "facetid_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nL0N1dHRpbmdzIGFuZCBXYXN0ZSBNYW5hZ2VtZW50In0=", "text": "Drilling/Cuttings and Waste Management", "count": 23 }, { "id": "facetid_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6IkRyaWxsaW5nL0Rvd25ob2xlIERyaWxsaW5nIFRlY2hub2xvZ2llcy9EaXJlY3Rpb25hbCBTeXN0ZW1zIn0=", "text": "Drilling/Downhole Drilling Technologies/Directional Systems", "count": 23 }

} , "content": … , "total_item": 2113, "limit": 15, "offset": 0 } , "dt": 15, "ts": 1734519150250 }

詳細については、Search and Recommendation API参照ドキュメントをご覧ください。

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