HomeDev guideRecipesAPI Reference
Dev guideUser GuidesLegal TermsNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev guide

Commerce Connect + Search & Navigation

Describes the integration of Optimizely Search & Navigation with Optimizely Commerce Connect. The integration ensures that, after you implement search features, Search & Navigation treats Optimizely Commerce Connect catalog content like regular content.

📘

Note

This integration requires Optimizely Commerce Connect version 8.8 or higher.

Integration packages

  • EPiServer.Commerce.FindSearchProvider – Integration with Optimizely Commerce Connect back-end parts using the Find (Search & Navigation) search provider.
  • EPiServer.Find.Commerce – Optimizely Commerce Connect integration based on the Find (Search & Navigation) API.

You can use EPiServer.Commerce.FindSearchProvider, EPiServer.Find.Commerce, or both. The Commerce.FindSearchProvider package uses Optimizely Search & Navigation (Find) as a search provider in Commerce Manager and the ECF search APIs. The Find.Commerce package uses Optimizely Search & Navigation to search catalog items using the Find API. See Configure Optimizely Search & Navigation search provider in the Commerce Connect developer guide.

Integration components

The EPiServer.Commerce.FindSearchProvider provides the following functionality:

  • Catalog items included in Unified Search results – Projections are configured for Url, ImageUri, and object getter for inheritors of EntryContentBase.
  • Catalog items available when creating best bets – The Search & Navigation Best Bets UI lets you select catalog items.
  • Enhanced indexing of catalog items – Indexing includes catalog languages.
  • Search provider for catalog items – Catalog items can be searched using Search & Navigation in Optimizely edit view.

Install

  1. Add the Optimizely.Commerce.FindSearchProvider package to the Commerce Manager project using the Package Manager Console (Tools > NuGet Package Manager > Package Manager Console).

    Command: Install-package Optimizely.Commerce.FindSearchProvider

  2. Add the EPiServer.Find.Commerce, EPiServer.Find.Cms, and EPiServer.Find.Framework packages to the CMS project. Run the following command on the CMS project.

    Command: Install-package EPiServer.Find.Commerce

    🚧

    Important

    Ensure that you do not install the EPiServer.Find.Cms package on the Commerce Manager project by mistake.

  3. Run the Find content indexing scheduled job. EPiServer.Find.Commerce adds data to indexed documents, so indexed documents only match expected search results after reindexing content.