May 9, 2023 release (5.0.1227.1)

This is for:

Developer System Administrator
In this article
Important

Per the Coveo Version Support Lifecycle policy, this Coveo for Sitecore 5 release has reached end of support. See available Coveo for Sitecore releases.

Even if this release is no longer supported, you must still perform some of its upgrade steps to upgrade to a more recent version of Coveo for Sitecore.

This release includes the 2.10107.0 version of the JavaScript Search Framework (see JavaScript Search Framework release notes).

When using a CDN with the Coveo for Sitecore Hive framework, this release includes the latest 2.10107 version of the JavaScript Search Framework (see Choosing between local and CDN Coveo JavaScript resource files).

Release notes

This section summarizes the new features and fixed support cases introduced in the Coveo for Sitecore May 9, 2023 release (5.0.1227.1).

Important

Coveo Hive search interfaces now perform front-end calls through the reverse proxy to generate search tokens, even when you disable the proxy. Caching reverse proxy endpoint responses may cause issues.

New features and enhancements

Issue number Description

WEB-5249

Eliminated no longer required security cache update calls.

WEB-5801

Improved the handling of exceptions during the execution of computed field code.

WEB-6208

Updated coveoua.js to version 2 in the Coveo Page View Analytics rendering.

WEB-6222

Added support for Coveo JavaScript Search Framework version 2.10107.

Bug fixes

Issue number Description

WEB-6222

Fixed vulnerabilities.

Maintenance cases

Issue number Case Description

WEB-6197

00095248

Fixed issue with SXA site non-English items being indexed with English content.

WEB-6233

00095257

Implemented a document push retry strategy to handle underlying connection was closed exceptions.

Upgrade steps

Important

Per the Coveo Version Support Lifecycle policy, this Coveo for Sitecore 5 release has reached end of support. See available Coveo for Sitecore releases.

Even if this release is no longer supported, you must still perform some of its upgrade steps to upgrade to a more recent version of Coveo for Sitecore.

This section describes how to upgrade Coveo for Sitecore from February 15, 2023 (5.0.1202.1) to May 9, 2023 (5.0.1227.1). If you’re upgrading over multiple versions, Coveo has a procedure to streamline the process.

Important

See Leading practices when upgrading Coveo for Sitecore and Upgrade Sitecore with Coveo for Sitecore to ensure successful upgrades.

Step 1: Upgrade Coveo for Sitecore

Important

Make sure the Microsoft MVC security update MS14-059 is installed on every Sitecore host in your environment.

  1. Log into the Sitecore Desktop.

  2. Access the Installation Wizard (Sitecore Start Menu > Development Tools > Installation Wizard).

  3. Upload and install the Coveo for Sitecore 5.0.1227.1 package built for the specific version of Sitecore you’re running (for example, Sitecore 10.2).

  4. When prompted to overwrite files, click Yes to all.

  5. When prompted to overwrite items, select Overwrite, then click Apply to all.

    Note

    You might be prompted twice with this question. Select the Overwrite option and click Apply to all both times.

  6. Once the installation is completed, make sure that you restart both the Sitecore client and server.

    Restart Server and Client dialog

Step 2: Manually update Coveo configuration files

Coveo for Sitecore packages contain some .config.example files. When you activated Coveo for Sitecore, the .config.example configuration files copied to your Sitecore instance were renamed (the .example was removed) making them enabled .config files. The name change also prevents the resulting .config files from being overwritten by .config.example files during a Coveo for Sitecore upgrade. In a nutshell, Coveo uses .config.example files for upgrade configuration changes that must be merged manually. Otherwise, Coveo uses standard .config files that get overwritten during step 1 of the upgrade process.

Tip

Use a tool like WinMerge to compare the new Coveo.*.config.example files with your existing Coveo.*.config files.

Here are the modifications to the .config.example files between the previous and current Coveo for Sitecore releases:

Coveo.SearchProvider.config

  1. All eight <handler type="Coveo.SearchProvider.Events.EntityEventHandler, …​> elements were removed from the configuration file. Apply these changes to your configuration.

  2. Under the retryGroups/throttlingAndTimeout/conditions element, the following element was added:

    <condition responseMatch="The underlying connection was closed" />

    Apply this change to your configuration.

⚠️ Step 3: Choose how to handle computed field exceptions

Prior to this release, Coveo for Sitecore wouldn’t index an item if an exception occurred during the execution of computed field code. This release introduces an exception handling option that lets you decide whether

  • To index the item without the computed field (default behavior).

    OR

  • Not to index the item.

If the new default behavior to index the item without the computed field suits you, no action on your part is required. If not, you can revert to the old indexing behavior.

To revert to the old indexing behavior and skip the item when a computed field exception occurs

  1. Open the <SITECORE_INSTANCE_ROOT>\App_Config\Include\Coveo\Coveo.SearchProvider.Custom.config file in a text editor.

  2. Add the <skipItemOnComputedFieldError> element below as an immediate child of the <defaultIndexConfiguration> element.

    <skipItemOnComputedFieldError>True</skipItemOnComputedFieldError>

  3. Save your changes.

Note

When a computed field exception occurs, Coveo logs the An error has occurred while evaluating the <COMPUTED_FIELD_NAME> computed field on item <ITEM_UNIQUE_ID> message in the Sitecore logs.

Step 4: Update custom renderings based on Coveo Page View Analytics

The Coveo Page View Analytics rendering now uses version 2 of the coveoua.js file.

If you’ve created custom renderings based on the Coveo Page View Analytics rendering, make sure you update the coveoua.js version number in your custom rendering .cshtml view files.

  1. Open the .cshtml file of your custom Coveo Page View Analytics rendering in a text editor.

  2. Locate the following line:

    })(window, document, 'script', 'https://static.cloud.coveo.com/coveo.analytics.js/1.0/coveoua.js');

  3. Replace the version number as follows:

    })(window, document, 'script', 'https://static.cloud.coveo.com/coveo.analytics.js/2/coveoua.js');

  4. Save your changes.

Step 5: Publish your site

In the Sitecore Content Editor, perform a publish site action. This ensures any changes related to Coveo components in the upgrade are published.

〈  Previous version upgrade steps

Next version upgrade steps  〉