検索結果ウィジェットのfacetsのカスタマイズ

JS SDKとUI Componentsの操作

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

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

ファセットコンテンツがある場合は、facetsに初期値を追加するか、検索で既定の動作をオーバーライドすることが必要になる場合があります。

たとえば、以前に設定したartifact_typeファセットをファセットIDで照合するには、ファセットの処理方法をオーバーライドし、文字列を指定して、それを初期値として設定する必要があります。

メモ

ファセット検索は、ファセットのSearchResultsStoreSelectedFacetとSearchResultsFacetConfigItemの間に一致がある場合に正常に実行されます。

次の手順は、facetsをカスタマイズするときに発生する一般的なユースケースに適用できます。これらは互いに独立しており、一度に1つずつ使用できます。

検索でfacetsを使用する場合、デフォルトでは、一致はfacetIdに基づきます。この手順は、このデフォルトの動作を上書きする場合に使用できます。

facetsの処理方法をオーバーライドするには:

useSearchResultsクエリフックのconfigオブジェクトで、次のコードブロックに示すように、facetsをSearchResultsStoreSelectedFacetオブジェクトとして追加します。

useSearchResults<EntityModel, InitialState>({
    state: {
      sortType: defaultSortType,
      page: defaultPage,
      itemsPerPage: defaultItemsPerPage,
      keyphrase: defaultKeyphrase,
    // Lists the facets and they behave and match with the CEC.
    // All facets default to valueId or match by comparing valueIds.
    // Selected facet value types in the inital state must match this model.
    config: {
      facets: {
        word_count: { type: 'range' },
        museum: { type: 'valueId' },
        artifact_type: { type: 'text' }
      },
    },
  })

手記

ファセット検索は、Customer Engagement Console (CEC) のFacetsセクションで構成された属性に対してのみ実行されます。

facetsの初期値を追加するには、次のようにします。

useSearchResultsクエリフックのstateオブジェクトのselectedFacetsに、次のコードブロックに示すように、必要なfacetsを追加します。

useSearchResults<EntityModel, InitialState>({
    state: {
      sortType: defaultSortType,
      page: defaultPage,
      itemsPerPage: defaultItemsPerPage,
      keyphrase: defaultKeyphrase,
      // Use selected facets property to set initial values for facets
      // Unless specified otherwise in the config object, a facet matches by facetId.
      // In case of conflict, the config or default behavior is applied.
      selectedFacets: [
        {
          facetId: 'museum',
          facetValueId: 'facetid_eyJ0eXBlIjoiZXEiLCJuYZXIgV29uZGVyIExhbmUifQ==',
        },
        {
          facetId: 'word_count', // => should be handled as a range
          min: 200,
          max: 800,
        },
      ],
    }
  })

手記

ファセット検索は、Customer Engagement Console (CEC) のFacetsセクションで構成された属性に対してのみ実行されます。

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