Bloomreach Commerce Accelerator 14.1.0 Upgrade Notes

Here are some important notes on upgrading to Bloomreach Commerce Accelerator 14.1.0.

For details on the new features and improvements in this release, see the Bloomreach Commerce Accelerator Release Notes.

Bloomreach Discovery Commerce Connector document updates

Replace Bloomreach Discovery Commerce Connector document(s)

Replace the Bloomreach Discovery Commerce Connector document(s) (e.g, administration/commerce-connectors/bloomreach) in CMS by those in the latest StarterStore Boot project as there are updates and improvements in configurations.

For example, you can export the new Commerce Connector document(s) of the latest StarterStore Boot project to YAML files through CMS Console, and replace the old document with the new one by importing it through CMS Console.

Make sure Bloomreach Discovery Commerce Connector document(s) marked as Search and Merchandising Connector

Since v14.1.0, a Commerce Connector document needs to be specified explicitly whether it is for Bloomreach Discovery or not. So, after upgrade, make sure that Bloomreach Discovery Commerce Connector document(s) in CMS are marked in the Search and Merchandising Connector? fields. If not, please mark the field and publish the document(s).

commercetools configuration updates

Since v14.1.0, commercetools configurations do not require to set username and password properties any more. So, please remove the following lines in the  commercetools configurations.

commercetools.username = <commercetools_username>
commercetools.password = <commercetools_password>

Also, its CRISP ResourceResolver configuration needs to be updated. Open CMS Console and update the crisp:beandefinition property of the node at /hippo:configuration/hippo:modules/crispregistry/hippo:moduleconfig/crisp:resourceresolvercontainer/commercetools like the following:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.1.xsd">

  <bean parent="abstractCrispSimpleJacksonRestTemplateResourceResolver"
        class="org.onehippo.cms7.crisp.core.resource.jackson.SimpleJacksonRestTemplateResourceResolver">
    <property name="cacheEnabled" value="${cache.enabled}" />
    <property name="baseUri" value="${api.base.url}" />
    <property name="restTemplate">
      <bean class="org.springframework.security.oauth2.client.OAuth2RestTemplate">
        <constructor-arg>
          <bean class="org.springframework.security.oauth2.client.token.grant.client.ClientCredentialsResourceDetails">
            <property name="accessTokenUri" value="${accessTokenUri}" />
            <property name="clientId" value="${clientId}" />
            <property name="clientSecret" value="${clientSecret}" />
            <property name="grantType" value="client_credentials" />
          </bean>
        </constructor-arg>
        <constructor-arg>
          <bean class="org.springframework.security.oauth2.client.DefaultOAuth2ClientContext">
            <constructor-arg>
              <bean class="org.springframework.security.oauth2.client.token.DefaultAccessTokenRequest">
              </bean>
            </constructor-arg>
          </bean> 
        </constructor-arg>
        <property name="requestFactory" ref="org.springframework.http.client.ClientHttpRequestFactory" />
        <property name="authenticator">
          <bean class="org.onehippo.cms7.crisp.core.security.oauth2.client.CaseSensitiveBearerDelegatingOAuth2RequestAuthenticator">
            <constructor-arg>
              <bean class="org.springframework.security.oauth2.client.DefaultOAuth2RequestAuthenticator">
              </bean>
            </constructor-arg>
          </bean> 
        </property>
        <property name="uriTemplateHandler">
          <bean class="org.springframework.web.util.DefaultUriBuilderFactory">
            <property name="encodingMode" value="VALUES_ONLY" />
          </bean>
        </property>
      </bean>
    </property>
    <property name="resourceLinkResolver">
      <bean class="org.onehippo.cms7.crisp.core.resource.FreemarkerTemplateResourceLinkResolver">
        <property name="templateSource">
          <value>http://www.example.com/products/current/sku/unknown/overview.html</value>
        </property>
      </bean>
    </property>
    <property name="resourceDataCache">
      <bean class="org.onehippo.cms7.crisp.core.resource.SpringResourceDataCache">
        <constructor-arg>
          <bean class="org.springframework.cache.ehcache.EhCacheCache">
            <constructor-arg>
              <bean parent="abstractCrispResourceEhCache">
                <property name="cacheName" value="demoProductCatalogsCache" />
                <property name="maxEntriesLocalHeap" value="1000" />
                <property name="maxEntriesLocalDisk" value="0" />
                <property name="timeToLiveSeconds" value="60" />
                <property name="timeToIdleSeconds" value="60" />
              </bean>
            </constructor-arg>
          </bean>
        </constructor-arg>
      </bean>
    </property>
  </bean>
</beans>

.