Skip to main content

Behavior change in Here Core UI Components 4.0

17-Nov-2021

An upcoming behavior change to Here Core UI Components will require necessary changes for customers to upgrade to 4.0. These behavior changes will impact how the Home component retrieves its views, applications, and workspaces.

With the release of Here Core UI Components 4.0, Here™ is enhancing the mechanics for how customers retrieve their content via Home. Today, this is accomplished via the Content Discovery Service, which will no longer be used directly by Home in 4.0. Instead of Home calling the Content Discovery Service, content will instead be supplied programmatically by a Home search provider. We will be providing more details on the Home search provider as part of our developer documentation with this release.

The intention of this notice is to ensure our customers are not negatively impacted by automatically consuming the 4.0 release. Customers can ensure they remain on a Here Core UI Components version < 4.0 by setting their desktop owner settings file to a specific Here Core UI Components version.

Why is Here™ making this change?​

Previously, the Home component made direct calls to the Content Discovery Service to retrieve app definitions. This approach has three limitations:

  • Significant complexity to share session cookies for the authenticated user

  • Some customers had difficulty configuring for CORS

  • Many customers want to provide app definitions for each end user and to apply other business rules not supported by the Content Discovery Service.

The new approach solves these problems by delegating the search to your authenticated app via client-side APIs that are part of Workspace SDK. This eliminates the need to share session cookies as well as the need for CORS configuration. Additionally, your app can now apply all business rules as it performs the search for app definitions.

Who is impacted?​

Here Core UI Components customers not setting a specific version in their desktop owner settings file or any customer upgrading to Here Core UI Components 4.0+.

When is the Home search provider being implemented?​

Here Core UI Components 4.0: 24-Nov-2021

Will Here™ provide details on how to migrate to Home search provider?​

Yes. Here™ will provide developer documentation on how to migrate to the Home search provider. Additionally, Here™ intends to pair these developer docs with a reference implementation to assist with the transition. This reference will include a change to how a Here Core UI platform is initiated.

Table of Contents