Elastic Path Commerce Development

Faceted Search Architecture

Faceted Search Architecture

Overview

This section provides details of the faceted search architecture and describes the end-to-end workflow of a search query, showing where facets are configured and processed.

Faceted Search Workflow and Architecture

Business users can configure facets in Commerce Manager and shoppers can use these facets to refine the search results. The following diagram illustrates the faceted search workflow for:
  • The business users who configure facets (shown in red).
  • The shoppers initiating search and the end-to-end data flow of the search query processing (shown in green).
Figure 1. Faceted Search Architecture Diagram

Facet Configuration Workflow

Business users and merchandisers configure facets in Commerce Manager.

The following workflow lists the steps for facet configuration:
  1. Business users identify and configure facets in the Facet Configuration tab using the product attributes, SKU attributes, SKU options, or other attributes for the store.
  2. Commerce Manager sends the facet configurations through Elastic Path Core to save in the database.

For more information on configuring facets, see the Store Configuration > Facet Search section in the Commerce Manager guide.

Faceted Offer Search Retrieval Workflow

This section provides an overview of the end-to-end data flow and sequence of events for a search query initiated by a shopper, shown in the Figure 1.

The following data flow lists the steps for facet search retrieval:

  1. Shopper enters shirt in the storefront's search field.

    The offersearchAPI receives the request call to Cortex.

  2. Cortex sends the API call to Elastic Path Core.
  3. Elastic Path Core queries the database for facet configuration.
  4. The database returns all enabled faceted attributes to Elastic Path Core.
  5. Elastic Path Core creates the search request and sends it to the Search Server.
  6. The Search Server returns offers with the relevant facets and facet values to Elastic Path Core.
  7. Elastic Path Core filters the facets with zero facet value and sends the list of relevant facets and facet values to the Cortex API.
  8. The offersearchAPI returns offers with the relevant facets to the shopper.

    The shopper can use the facets and facet values to filter the search results further.

Faceted Navigation Workflow

This section provides an overview of the end-to-end data flow and sequence of events for a faceted navigation. Business users and merchandisers configure category facets in Elastic Path Commerce Manager. For more information on configuring facets see the Store Configuration > Facet Search section in the Elastic Path Commerce Manager guide.

The following data flow lists the steps for facet retrieval and display:

  1. Shopper enters accessories in the search field or navigates to the category.
  2. Storefront gets the offers and shows the products in the accessories category.
  3. Storefront creates a faceted navigation menu with offers grouped by:
    • Category
    • Price
    • Brand
    • Attributes
  4. Shopper selects a facet, such as, Price: $50-$100, in the category.
  5. Storefront displays the list of offers from faceted navigation in the $50-$100 price range.
  6. Storefront updates the browser URL to include the filter, such as, https://reference.elasticpath.com.
  7. Storefront updates the faceted navigation menu to show the facets as selected.

Related Information: