最大制限を超えるファセット値を返す

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

このページの翻訳は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個のファセット値がアルファベット順に表示されます。スペースを節約するために、このサンプル応答には最初の値のみが表示されます。

{
    "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_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6Ii9FbiBVc2RpZ2l0YWwgU29sdXRpb25zL09wdGltaXphdGlvbiJ9",
                            "text": “Digital Solutions/Optimization",
                            "count": 13
                        }
                    ]
                }
            ],
            "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"
            }
        ]
    }
}

このサンプル応答は、Digital Solutions/OptimizationSitecore Searchがアルファベット順に別の (最大) 100個のファセット値をアルファベット順に返す方法を示しています (この例では2つしか含めていません)。

{
    "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_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6Ii9FbiBVc2RpZ2l0YWwgU29sdXRpb25zL090aGVyIEluZHVzdHJpZXMifQ==",
                            "text": “Digital Solutions/Other Industries",
                            "count": 2
                        },
                        {
                            "id": "facetid_eyJ0eXBlIjoiZXEiLCJuYW1lIjoiY2F0ZWdvcnlfYnJlYWRjcnVtYnMiLCJ2YWx1ZSI6Ii9FbiBVc2RpZ2l0YWwgU29sdXRpb25zL1Byb2R1Y3Rpb24ifQ==",
                            "text": “Digital Solutions/Production",
                            "count": 17
                        },
                        …
                    ]
                }
            ],
            "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リファレンスのドキュメントを参照してください。

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