FirstSpirit Connect for SAP Commerce Cloud

Release Notes for the version 23.3.0

e-Spirit AG

2023-03-06
Table of Contents

Version 23.3.0

Update Notice

The FirstSpirit Connect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components

This release contains the following components.

Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

FirstSpirit Connect for SAP Commerce Cloud (fsm)

3.2.4 ⬆

fscontentconnect (SAP Commerce Cloud addon)

3.1.181 ⬆

Reference project

3.1.97

General information

This release was tested with the following versions:

ProductVersion

FirstSpirit server

2023-03 (5.2.230314)

Java

17

Content as a Service (FSM)

2.22.2

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

SAPCC-488 - Conversion of the authorization header for CaaS requests to the standardized Bearer format

This change affects the module installed on the FirstSpirit side as well as the addon installed on the Hybris side. To make the adjustment in the addon, the following value must be specified in the DefaultCaaSService for the variable authorizationValue:

final String authorizationValue = "Bearer " + caaSConfigurationProvider.getCaaSAPIKey();

Information about the support of the old format can be taken from the CaaS Platform Releasenotes.

New features

IDDescription

SAPCC-488

Conversion of the authorization header for CaaS requests to the standardized Bearer format.

Version 22.4.1

Update Notice

The ContentConnect for SAP Commerce Cloud integration bundles several software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) have changed since the last release.

ComponentVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.2.2

fscontentconnect (SAP Commerce Cloud addon)

3.1.163

reference project

3.1.97

General Information
This release has been tested with the following versions:

ProductVersion

FirstSpirit server

2022-05 (5.2.220512)

Java

11

Content as a Service (FSM)

2.21.0

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

New features

IDDescription

SAPCC-400

Added subchapter about editing of page attributes to documentation

Version 22.4.0

Update Notice

The ContentConnect for SAP Commerce Cloud integration bundles several software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) have changed since the last release.

ComponentVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.2.2 ⬆

fscontentconnect (SAP Commerce Cloud addon)

3.1.163

reference project

3.1.97

General Information
This release has been tested with the following versions:

ProductVersion

FirstSpirit server

2022-04 (5.2.220406)

Java

11

Content as a Service (FSM)

2.20.6

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

SAPCC-457 - Updated usage of Spring library

The ContentConnect for SAP Commerce Cloud module is not affected by the recently discovered vulnerability in Spring. Nevertheless, the use of Spring has been updated with this release.

Fixed issues

IDDescription

SAPCC-457

Updated usage of Spring library

Version 22.3.0

Update Notice

The ContentConnect for SAP Commerce Cloud integration bundles several software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) have changed since the last release.

ComponentVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.2.0

fscontentconnect (SAP Commerce Cloud addon)

3.1.163 ⬆

reference project

3.1.97

General Information
This release has been tested with the following versions:

ProductVersion

FirstSpirit server

2022-03 (5.2.220309)

Java

11

Content as a Service (FSM)

2.20.4

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

SAPCC-451 - Fixed an issue with the language change in the ContentCreator

There have been changes to the following add-on files as part of this ticket:

  • fscontentconnect-tpp-impl.js and fscontentconnect-tpp-impl.ie11.js.

These files can be replaced by the current files provided in the download area. These are contained in the fscontentconnect-<version>.zip file in the fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js directory.

Fixed issues

IDDescription

SAPCC-451

Fixed an issue with the language change in the ContentCreator

Version 22.2.0

Update Notice

The FirstSpirit Connect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

FirstSpirit Connect for SAP Commerce Cloud (fsm)

3.2.0

fscontentconnect (SAP Commerce Cloud addon)

3.1.159 ⬆

Reference project

3.1.97 ⬆

General information
This release was tested with the following versions:

ProductVersion

FirstSpirit server

2022.2 (5.2.220210)

Java

11

Content as a Service (FSM)

2.20.3

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

Fixed issues

IDDescription

SAPCC-446

Fixed an error when using the language switch in the storefront in connection with SAP Commerce as of version 20.11

Version 21.12.0

Update Notice

The FirstSpirit Connect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

FirstSpirit Connect for SAP Commerce Cloud (fsm)

3.2.0 ⬆

fscontentconnect (SAP Commerce Cloud addon)

3.1.149

Reference project

3.1.94 ⬆

General information
This release was tested with the following versions:

ProductVersion

FirstSpirit server

2021-11 (5.2.211108)

Java

11

Content as a Service (FSM)

2.19.4

Omnichannel Manager

2.4.0

Basic Workflows

1.3.4.972

Fixed issues

IDDescription

SAPCC-438

Fixed group definition in the reference project

New features

IDDescription

SAPCC-442

SAP Application Interface Register (AIR) key integrated

Version 21.10.0

Highlights

SAPCC-424 - Compatibility with Commerce Cloud 20.11

With this release, the FirstSpirit Connect for SAP Commerce Cloud module supports SAP Commerce Cloud up to and including version 20.11. Compatibility with older versions is maintained.

Update Notice

The ContentConnect for SAP Commerce Cloud integration bundles several software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) have changed since the last release.

ComponentVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.1.84 ⬆

fscontentconnect (SAP Commerce Cloud addon)

3.1.149 ⬆

reference project

3.1.91 ⬆

General Information
This release has been tested with the following versions:

ProductVersion

FirstSpirit server

2021-10 (5.2.211007)

Java

11

Content as a Service (FSM)

2.19.3

Omnichannel Manager

2.4.0

Basic Workflows

1.3.4.972

SAPCC-424 - Compatibility with Commerce Cloud 20.11

There have been changes to the following add-on files as part of this ticket:

  • fscontentconnect-tpp-impl.js and fscontentconnect-tpp-impl.ie11.js.

These files can be replaced by the current files provided in the download area. These are contained in the fscontentconnect-<version>.zip file in the fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js directory.

Updating these files is mandatory for compatibility with Commerce Cloud version 20.11. If the compatibility is not required, the update is not necessary, but still useful.

In addition to the mentioned files, the configuration dialog of the project component of the module has been adapted. In the Preview area, the newly added Preview Servlet field can now be used to specify the preview servlet endpoint of the Commerce Cloud. By default, the field contains the value previewServlet, which applies to older versions of Commerce Cloud. For Commerce Cloud 20.11, the new endpoint cx-preview must be entered here. This field is only evaluated when the previously mentioned files are updated.

  • 'FscontentconnectConstants.java' and 'FirstSpiritPreviewFilter.java'.

These files can be replaced by the current files provided in the download area. These are contained in the fscontentconnect-<version>.zip file in the directories fscontentconnect/src/com/espirit/moddev/contentconnect/sap/constants/ and fscontentconnect/src/com/espirit/moddev/contentconnect/sap/filters/.

Updating these files is not mandatory for Commerce Cloud version 20.11 compatibility. Since it provides the following configuration option, an update is nevertheless useful.

The FirstSpiritPreviewFilter of the add-on reads the storefrontContextRoot variable of the Commerce Cloud by default and stores its value for further use in the session. Among other things, it is used to generate the preview URLs of content pages. If the value of the storefrontContextRoot variable and the value actually used by the store differ from each other, because the latter is stored in a different variable, for example, the add-on can be configured to use a different value. This value must be specified in the fscontentconnect.storefrontContextRoot field in project.properties. If this field is set, the add-on uses this value as storefrontContextRoot. If the field is empty or not present, the add-on reads the Commerce Cloud storefrontContextRoot variable as before.

  • javaScript.tag

This file should only be replaced by the current file provided in the download area in the event of an update to Commerce Cloud version 20.11. It is contained in the fscontentconnect-<version>.zip file in the yb2bacceleratorstorefront/web/webroot/WEB-INF/tags/responsive/template directory.

However, in the event of an update of the Commerce Cloud we do not recommend the 1:1 transfer of this file, but rather the extension of the original file as described in chapter 2.1.6 of the FirstSpirit Connect For SAP Commerce Cloud documentation.

New features

IDDescription

SAPCC-424

Compatibility with Commerce Cloud 20.11

Version 21.7.1

Update Notice

The FirstSpirit Connect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

FirstSpirit Connect for SAP Commerce Cloud (fsm)

3.1.74

fscontentconnect (SAP Commerce Cloud addon)

3.1.135

Reference project

3.1.86 ⬆

General information
This release was tested with the following versions:

ProductVersion

FirstSpirit server

2021-07 (5.2.210710)

Java

8 and 11

Content as a Service (FSM)

2.19.2

Omnichannel Manager

2.3.5

Basic Workflows

1.3.4.972

Fixed issues

IDDescription

SAPCC-346

Fixed permissions for groups in cloud environment

New features

IDDescription

SAPCC-198

Creation of a documentation for server administrators

Version 21.7.0

Update Notice

The FirstSpirit Connect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

FirstSpirit Connect for SAP Commerce Cloud (fsm)

3.1.74

fscontentconnect (SAP Commerce Cloud addon)

3.1.135

Reference project

3.1.79

General information
This release was tested with the following versions:

ProductVersion

FirstSpirit server

2021-06 (5.2.210613)

Java

8 and 11

Content as a Service (FSM)

2.19.2

Omnichannel Manager

2.3.4

Basic Workflows

1.3.3.871

New features

IDDescription

SAPCC-386

Fixed wrong description in the documentation.

Version 21.6.0

Update Notice

The FirstSpirit Connect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

FirstSpirit Connect for SAP Commerce Cloud (fsm)

3.1.74

fscontentconnect (SAP Commerce Cloud addon)

3.1.135 ⬆

Reference project

3.1.79

General information
This release was tested with the following versions:

ProductVersion

FirstSpirit server

2021-06 (5.2.210613)

Java

8 and 11

Content as a Service (FSM)

2.19.2

Omnichannel Manager

2.3.4

Basic Workflows

1.3.3.871

There have been changes to the fscontentconnect-tpp-impl.js file and the fscontentconnect-tpp-impl.ie11.js file as part of this ticket.

These can be replaced by the actual files provided in the download area.

They are contained in the fscontentconnect-<version>.zip file in the fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js directory.

New features

IDDescription

SAPCC-29

Accelerated saving of section changes

Version 21.4.0

Update Notice

The ContentConnect for SAP Commerce Cloud integration bundles several software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) have changed since the last release.

ComponentVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.1.74

fscontentconnect (SAP Commerce Cloud addon)

3.1.120

reference project

3.1.79

General Information
This release has been tested with the following versions:

ProductVersion

FirstSpirit server

2021-03 (5.2.210309)

Java

8 and 11

Content as a Service (FSM)

2.14.0

Omnichannel Manager

2.2.2

Basic Workflows

1.3.4.972

New features

IDDescription

SAPCC-399

Revision of the installation chapter for the web component

Version 21.2.0

Update Notice

The ContentConnect for SAP Commerce Cloud integration bundles several software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) have changed since the last release.

ComponentVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.1.74

fscontentconnect (SAP Commerce Cloud addon)

3.1.120

reference project

3.1.79 ⬆

General Information
This release has been tested with the following versions:

ProductVersion

FirstSpirit server

2021-01 (5.2.210108)

Java

8 and 11

Content as a Service (FSM)

2.13.18

Omnichannel Manager

1.2.27

Basic Workflows

1.3.4.972

Fixed issues

IDDescription

SAPCC-408

Extension of the documentation with required groups of the OAuth user

SAPCC-397

Label of input component pt_cc_identifier corrected

Version 21.1.0

Highlights

SAPCC-393 - Support for multiple sites on one SAP Commerce Cloud instance

This release supports the connection of multiple Commerce Cloud sites to FirstSpirit and the CaaS.

Whereas the configuration of the CaaS access data previously took place exclusively centrally in the add-on FsContentConnect, it can now alternatively also be maintained via the website settings in the Commerce Cloud backoffice (see documentation). This makes it possible to specify different CaaS configuration parameters per website and thus to connect different websites to FirstSpirit at the same time.

If the configuration option in the backoffice is not used for a site, the central configuration in the add-on FsContentConnect is read out as before. Mixed operation of both configuration options is also supported. For example, it is possible to configure the API key, protocol, URL and port for accessing the CaaS identically for all sites centrally and only specify the value for the name of the database site-specifically via the backoffice. Filled configuration parameters in the backoffice overwrite the configuration parameters from the add-on for the corresponding website.

Update Notice

The ContentConnect for SAP Commerce Cloud integration bundles several software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) have changed since the last release.

ComponentVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.1.74

fscontentconnect (SAP Commerce Cloud addon)

3.1.120 ⬆

reference project

3.1.71

General Information
This release has been tested with the following versions:

ProductVersion

FirstSpirit server

2021-01 (5.2.210108)

Java

8 and 11

Content as a Service (FSM)

2.13.18

Omnichannel Manager

1.2.27

Basic Workflows

1.3.4.972

SAPCC-393 - Support for multiple sites on one SAP Commerce Cloud instance

To configure CaaS credentials via the Commerce Cloud backoffice, an update to the add-on FsContentConnect is required. This update is optional as long as this configuration option can be dispensed with. Nevertheless, we recommend to perform it in order to keep the add-on up to date and thus to facilitate future updates.

After installing the add-on on the Commerce Cloud server, a one-time update via the hybris administration console is required. This can be done via the Update button in the PlatformUpdate area.

In detail, the following changes have been made to the add-on:

  • Definition of new database fields
    in the fscontentconnect-items.xml file in fscontentconnect/resources
  • Adding the caaSConfiguration bean and
    injecting the caaSConfiguration bean and the cmsSiteServices bean into the defaultCaaSService bean
    in the file fscontentconnect-spring.xml in fscontentconnect/resources
  • Definition of various language-dependent labels for the new input fields
    in the directory fscontentconnect/resources/localization
  • Various adjustments for reading the new configuration fields
    in the files DefaultCaaSService.java and CaaSConfiguration.java
    in fscontentconnect/src/com/espirit/moddev/contentconnect/sap/service

New features

IDDescription

SAPCC-393

Support for multiple sites on one SAP Commerce Cloud instance

Version 20.12.0

Update Notice

The ContentConnect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.1.74

fscontentconnect (SAP Commerce Cloud addon)

3.1.114 ⬆

Reference project

3.1.71

General information
This release was tested with the following versions:

ProductVersion

FirstSpirit server

2020-11 (5.2.201107)

Java

8 and 11

Content as a Service (FSM)

2.13.15

Omnichannel Manager

1.2.27

Basic Workflows

1.3.3.871

SAPCC-394 - Definition of the FirstSpiritPreviewFilter bean moved from the storefront to the add-on

The integration into the SAP Commerce Cloud requires the reference of the FirstSpiritPreviewFilter in the form of a bean in the storefront. Both the reference in the FilterChain and the declaration of the bean were previously carried out exemplarily in the spring-filter-config.xml of the storefront delivered with the integration.

With this release the declaration of the bean was integrated into the file fscontentconnect-spring.xml of the addon. Thus the declaration of the bean in the storefront is no longer necessary. However, the bean must still be referenced in the FilterChain of the storefront.

In detail the following changes were made to the addon:

  • Moving the FirstSpiritPreviewFilter bean
    from the file spring-filter-config.xml in yb2bacceleratorstorefront/web/webroot/WEB-INF/config
    to the file fscontentconnect-spring.xml in fscontentconnect/resources/fscontentconnect-spring.xml
  • Moving the file FirstSpiritPreviewFilter.java from
    fscontentconnect/acceleratoraddon/web/testsrc/com/espirit/moddev/contentconnect/sap/filters
    to fscontentconnect/src/com/espirit/moddev/contentconnect/sap/filters
  • Moving the file FirstSpiritPreviewFilterTest.java from
    fscontentconnect/acceleratoraddon/web/testsrc/com/espirit/moddev/contentconnect/sap/filters
    to fscontentconnect/testsrc/com/espirit/moddev/contentconnect/sap/filters
  • Remove the unused files
    FscontentconnectControllerConstants.java and FscontentconnectWebConstants.java from
    fscontentconnect/acceleratoraddon/web/src/com/espirit/moddev/contentconnect/sap/controllers

New features

IDDescription

SAPCC-394

Definition of the FirstSpiritPreviewFilter bean moved from the storefront to the add-on

Version 20.11.0

Update Notice

The ContentConnect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.1.74 ⬆

fscontentconnect (SAP Commerce Cloud addon)

3.1.101

Reference project

3.1.71

General information
This release was tested with the following versions:

ProductVersion

FirstSpirit server

2020-11 (5.2.201107)

Java

8 and 11

Content as a Service (FSM)

2.13.15

Omnichannel Manager

1.2.27

Basic Workflows

1.3.3.871

Fixed issues

IDDescription

SAPCC-402

Fix a possible REST response processing error

Version 20.10.3

Highlights

SAPCC-385 - Renaming of the integration to FirstSpirit Connect for SAP Commerce Cloud

As part of the standardization of module names, the integration, previously published under the name ContentConnect for SAP Commerce Cloud, has been renamed to FirstSpirit Connect for SAP Commerce Cloud.

SAPCC-175 - Added plugin that allows to edit page settings in the ContentCreator

In the ContentCreator, editors now have the option of opening a dialog for editing the page settings through the element status and workflow section.

Update Notice

The FirstSpirit Connect for SAP Commerce Cloud integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

ComponentsVersion

ContentConnect for SAP Commerce Cloud (fsm)

3.1.73 ⬆

fscontentconnect (SAP Commerce Cloud addon)

3.1.101

Reference project

3.1.71

New features

IDDescription

SAPCC-385

Renaming of the integration to FirstSpirit Connect for SAP Commerce Cloud

SAPCC-175

Added plugin that allows to edit page settings in the ContentCreator

Version 20.10.2

Fixed issues

IDDescription

SAPCC-387

Removed automatic SAP Commmerce availability check

Version 20.10.1

New features

IDDescription

SAPCC-388

Minor documentation changes in chapter 1.3

Version 20.10.0

Highlights

SAPCC-300 - Introduction of a new version scheme
This release introduces a new version scheme for the complete integration package. The new version scheme consists of the two-digit year, the month number and the number of the release within a month.

Example for the second release in October 2020: 20.10.1
Example for the first release in April 2021: 21.4.0

The version scheme of the individual components of the complete package remains unchanged. This makes it easier to see whether a given version number is the version number of the complete package or of one of its components.

New features

IDDescription

SAPCC-380

Added note on installing global web applications to the documentation

SAPCC-373

Minor adaptions within the documentation

SAPCC-300

Introduction of a new version scheme

SAPCC-287

Addition of a chapter for the configuration of the external preview URL

Version 3.3.2

Fixed issues

IDDescription

SAPCC-368

The workflow status is now correctly updated after releasing a page

New features

IDDescription

SAPCC-364

Snippet content of the Product DAP is now configurable

Version 3.3.1

Fixed issues

IDDescription

SAPCC-358

Fixed broken links in the documentation

SAPCC-356

Error in the handling of products with special characters in a FS_INDEX fixed

Version 3.3.0

Highlights

SAPCC-354 - Introducing the NPM tags cloud-sap-acc and cloud-sap-acc-dev as version for fs-tpp-api
When a new version of the fs-tpp-api library was released, this version had to be manually adjusted each time in the fscontentconnect addon. By using the NPM tags cloud-sap-acc and cloud-sap-acc-dev the version of the fs-tpp-api library does not need to be adapted manually anymore. The cloud-sap-acc-dev tag is upgraded by e-Spirit to the latest compatible version of the fs-tpp-api library on every DEV/QA patchday. The cloud-sap-acc tag on every PROD patchday. To use the correct tag, a switch was built in, which uses one of the two tags depending on the configuration of the Hybris system.

SAPCC-350 - Support for special characters and uppercase letters in hybris pageids
With this release, content maintenance is supported on all pages, even if the page id contains special characters or capital letters. This applies to maintenance on catalog-driven pages (product and category pages) as well as on pure content pages.

SAPCC-324 - Support for content maintenance on non-standard content pages
With this release, SAP Integration also supports content maintenance on content pages whose URL differs from SAP standard formats.

To use this functionality it is necessary to define the mapping of the page URL to the corresponding FirstSpirit template in the "Contents" tab in the SAP module configuration in the project properties, as described in Section 3.3. of the documentation.

Update Notice

SAPCC-354 - Introducing the NPM tags cloud-sap-acc and cloud-sap-acc-dev as version for fs-tpp-api
In order to use the new NPM tags, the fscontentconnect add-on in the SAP Commerce Cloud must be updated. In particular, the following changes must be applied:

  • fscontentconnect/acceleratoraddon/web/src/com/espirit/moddev/contentconnect /sap/filters/FirstSpiritPreviewFilter.java

In this file, before calling filterChain.doFilter(request, response); the call session.setAttribute(FscontentconnectConstants.DEV_ENVIRONMENT, isDevEnvironment()); must be added.

In addition, the class has to be extended by this method:

private boolean isDevEnvironment() {
   final String property = Optional.ofNullable((String) configurationService.getConfiguration()
   .getProperty(FscontentconnectConstants.DEV_ENVIRONMENT)).orElse("");
   return StringUtils.isNotBlank(property) && Boolean.valueOf(property);
}
  • fscontentconnect/src/com/espirit/moddev/contentconnect/sap/constants /FscontentconnectConstants.java

In this class the new constant public static final string DEV_ENVIRONMENT = "fscontentconnect.dev"; is to be added.

  • fscontentconnect/acceleratoraddon/web/webroot/WEB-INF/tags/responsive /caas/includeOcmScripts.tag

The line

<script type="text/javascript" src='https://unpkg.com/fs-tpp-
api@1.2.23/snap${sessionScope["com.espirit.ecom.fscontentconnect.scripts.suffix"]}.js'></script>

should be replaced by the following lines:

<c:set var="com.espirit.ecom.fscontentconnect.scripts.tag" scope="session"
value='${pageContext.session.getAttribute("fscontentconnect.dev") ? "cloud-sap-acc-dev" : "cloud-sap-acc"}'
/>

<script type="text/javascript" src='https://unpkg.com/fs-tpp-
api@${sessionScope["com.espirit.ecom.fscontentconnect.scripts.tag"]}/snap${sessionScope["com.espirit.ecom.fscontentconnect.scripts.suffix"]}.js'></script>

Furthermore, as described in chapter 2.1.2 of the documentation, the configuration of the Hybris system must be extended by the property fscontentconnect.dev. If this property receives the value true, the switch uses the tag cloud-sap-acc-dev. If the property receives the value false or is not specified at all, the switch uses the tag cloud-sap-acc instead. This property should therefore be set to true on DEV and QA systems. On PROD systems it should not be used or set to false.

SAPCC-350 - Support for special characters and uppercase letters in hybris pageids
To enable support for special characters and capital letters in hybris pageids, an update of the addon is necessary. Both JavaScript files are affected:

  • fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js/fscontentconnect-tpp-impl.js
  • fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js/fscontentconnect-tpp-impl.ie11.js

These must be updated on the Hybris server.

In addition, all page templates of the project must be extended by the following hidden input component, in which the original hybris page id or the hybris product or category code is persisted when a new FirstSpirit page is created:

<CMS_INPUT_TEXT name="pt_cc_identifier" hFill="yes" hidden="yes" useLanguages="no">
   <LANGINFO>
      <LANGINFO lang="*" label="ContentConnect Identifier"/>
   </LANGINFOS>
</CMS_INPUT_TEXT>

To ensure backwards compatibility, the integration continues to work as before without adding this input component, but then only supports page ids and product or category codes without special characters or capital letters.

Fixed issues

IDDescription

SAPCC-351

Improved API-call for requesting a single category

SAPCC-350

Support for special characters and uppercase letters in hybris pageids

New features

IDDescription

SAPCC-354

Introducing the NPM tags cloud-sap-acc and cloud-sap-acc-dev as version for fs-tpp-api

SAPCC-324

Support for content maintenance on non-standard content pages

Version 3.2.7

Highlights

SAPCC-207 - Improved handling of special characters in page, product and category IDs
If page, product or category IDs contain special characters, such as hyphens, the content stored in the CaaS could not be retrieved for these pages. Likewise communication with FirstSpirit did not run correctly in these cases, so that pages were created several times in FirstSpirit. This problem has been solved with this release.

Update Notice

SAPCC-342 - Fix an issue that causes an endless redirection loop in the ContentCreator
In order to apply this fix, the fscontentconnect addon needs to be updated in the SAP Commerce Cloud. Specifically, the following files need to be updated: * fscontentconnect/acceleratoraddon/web/webroot/WEB-INF/tags/responsive/caas/includeOcmScripts.tag * fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js/fscontentconnect-tpp-impl.js * fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js/fscontentconnect-tpp-impl.ie11.js

If you need to apply the changes in the includeOcmScripts.tag file manually, change the url of the fs-tpp-api library from https://unpkg.com/fs-tpp-api@1.2.17/ to https://unpkg.com/fs-tpp-api@1.2.23/.

SAPCC-207 - Improved handling of special characters in page, product and category IDs
To install this version, an update of the addon in the SAP Commerce Cloud is necessary.

The update adds a special character substitution to the file RequestTag.java:

RequestTag.java. 

if (caasService == null) {
    LOGGER.error("The CaaS Service has not been initialized.");
    return;
}

itemId = itemId.replaceAll("[^a-zA-Z0-9_.]", "_"); // special character substitution

if (session.getAttribute(FIRST_SPIRIT_PREVIEW_PARAM) != null && session.getAttribute(FIRST_SPIRIT_PREVIEW_PARAM) == Boolean.TRUE) {
    pageContext.setAttribute(var, caasService.getStagedCaaSData(collection, itemId));
} else  {
    pageContext.setAttribute(var, caasService.getOnlineCaaSData(collection, itemId));
}

Fixed issues

IDDescription

SAPCC-342

Fix an issue that causes an endless redirection loop in the ContentCreator

SAPCC-207

Improved handling of special characters in page, product and category IDs

Version 3.2.6

Highlights

SAPCC-149 - Improved error logging for API calls
Error messages caused by erroneous API calls now include the body of the API response for better and easier trouble-shooting. This applies to all calls regarding the cmswebservices, previewwebservices, and OAuth-API.

Furthermore API calls for creating or updating pages in SAP Commerce now will log the transmitted request body on a debug level.

New features

IDDescription

SAPCC-149

Improved error logging for API calls

Version 3.2.5

New features

IDDescription

SAPCC-289

Added support of multiple Commerce Cloud page templates per Commerce Cloud page type

Version 3.2.4

Fixed issues

IDDescription

SAPCC-286

Added PreviewTicket creation per project

Version 3.2.3

Fixed issues

IDDescription

SAPCC-285

Fix empty product report if a product has no thumbnail

Version 3.2.2

New features

IDDescription

SAPCC-60

Added thumbnails to product report, replaced report icons

Version 3.2.1

Fixed issues

IDDescription

SAPCC-272

Fixed error caused by missing language selector

SAPCC-269

Fixed page creation for newer Commerce Cloud versions

Version 3.2.0

New features

IDDescription

SAPCC-227

Added confirmation dialog when a section gets deleted

Version 3.1.56

Fixed issues

IDDescription

SAPCC-265

Improved handling of language dependent attributes

SAPCC-246

Fixed the display of the category teaser

SAPCC-242

Improved handling of invalid oauth tokens

New features

IDDescription

SAPCC-254

Added preview images to page and section templates

Version 3.1.54

Fixed issues

IDDescription

SAPCC-264

Fixed handling of page attributes

SAPCC-263

Base decision of used caas version on the used catalog version

SAPCC-256

Updated redirect script to detail pages

New features

IDDescription

SAPCC-253

Enabled image upload for every image input component

Version 3.1.51

Fixed issues

IDDescription

SAPCC-262

Fixed code issues

SAPCC-259

Fixed attribute mapping for non standard attributes

SAPCC-257

Reduced loading times of the product dap in FS_INDEX components

New features

IDDescription

SAPCC-258

Target catalog version for bulk update configurable at task level

Version 3.1.48

Fixed issues

IDDescription

SAPCC-260

Fixed problem where session attributes were lost

Version 3.1.45

Update Notice

If you use the FirstSpirit reference project of this version, you MUST also use the FirstSpirit module and SAP Commerce addon included in this version.

Fixed issues

IDDescription

SAPCC-243

By default the label of new content pages starts with a slash

SAPCC-232

Ensure new content pages can be opened in the FirstSpirit preview

New features

IDDescription

SAPCC-95

Rely on the Omnichannel manager to create a FirstSpirit pages for SAP Commerce pages

Version 3.1.43

Update Notice

This updated requires Omnichannel Manager 1.2.15 or higher.

Fixed issues

IDDescription

SAPCC-233

Fixed possible redirect issue in the CaaS communication

SAPCC-148

Removed workaround to trigger navigation to the homepage after page deletion

New features

IDDescription

SAPCC-230

Support Internet Explorer 11

Version 3.1.36

Fixed issues

IDDescription

SAPCC-224

Fixed preview session initialization in Firefox

Version 3.1.35

Fixed issues

IDDescription

SAPCC-217

Fixed possible race condition in JavaScript execution

SAPCC-205

Fixed problem handling special characters

New features

IDDescription

SAPCC-213

Initial translation of the documentation

Version 3.1.34

Fixed issues

IDDescription

SAPCC-40

Keep the preview session alive

Version 3.1.32

Highlights

This version comes with a new FirstSpirit reference project, that demonstrates the integration in conjunction with the B2B Accelerator. Included features are: Content management on existing content pages, utilization of dynamic product data, release and deployment processes, link and section templates, default users, groups and permissions, new ui.

Furthermore, this version includes a storefront, that includes all necessary adaptions.

Update Notice

This version requires some migration steps, that are explained in another document.

New features

IDDescription

SAPCC-187

Documentation Update

SAPCC-134

Reference Project

Version 3.1.30

Fixed issues

IDDescription

SAPCC-189

Removed dependency to internal CaaS API

Version 3.1.28

Fixed issues

IDDescription

SAPCC-196

Fixed bug that prevented language switching on the storefront

Version 3.1.26

Fixed issues

IDDescription

SAPCC-188

Fixed a bug that caused ContentCreator actions to be non-functional when viewing pages of page types that do not support content editing with FirstSpirit

New features

IDDescription

SAPCC-111

Updated documentation

Version 3.1.23

Fixed issues

IDDescription

SAPCC-181

Fixed a bug that caused the CaaS Availability Check to fail in some situations

Version 3.1.17

Fixed issues

IDDescription

SAPCC-129

Fixed a bug that caused an incorrect page context after navigating to a different FirstSpirit page

New features

IDDescription

SAPCC-142

TPP-JavaScript files now include a comment with a version number

Version 3.1.15

Update Notice

The update uses a dynamic resolution of the storefront context path which is needed within the TPP reference JavaScript. The reference implementation does now expect a storefrontContextRoot property which is provided by the PREVIEW_DATA object. For more information on how to define mentioned property in the PREVIEW_DATA object head to the chapter Storefront extensions → View of the documentation.

New features

IDDescription

SAPCC-112

Added support for dynamic content rendering and editing

SAPCC-107

Documentation of a release and deployment process

SAPCC-37

Removed static configuration of storefront context path from TPP reference JavaScript

Version 3.1.12

New features

IDDescription

SAPCC-36

Added button to test OAuth Settings in project app configuration

Version 3.1.11

Fixed issues

IDDescription

SAPCC-31

Updated TPP_SNAP version to 1.2.7 to resolve a possibly incorrect workflow status after releasing a page

Version 3.1.9

New features

IDDescription

SAPCC-106

Extended the module API by a catalog service which allows catalog synchronization

Version 3.1.8

Update Notice

The url pattern for content pages was hard coded before (within the reference implementation of the JavaScript which uses the TPP API). This module version introduces a ContentConnectSAPCommerceCloud_CMSPageUrlGenerator executable to generate page url paths. When using the new executable to generate url paths make sure to configure the new content page url pattern in the project app component to retain previous behaviour when it comes to navigating to content pages.

Fixed issues

IDDescription

SAPCC-103

Preventing deployment of non-released pages in full generation

SAPCC-100

Added support for navigation to CDP or PDP when clicking search results

Version 3.1.6

Fixed issues

IDDescription

SAPCC-102

Added chapter for FlexibleSearch restriction configuration regarding products to documentation

SAPCC-73

Added chapter about installation of web-component

SAPCC-43

Enhanced behaviour in case of network errors

SAPCC-33

Added language switching capability to TPP reference implementation

New features

IDDescription

SAPCC-65

New Category Data Access Plugin

Version 3.1.5-9

New features

IDDescription

SAPCC-58

API redesign

Version 3.1.5-8

Fixed issues

IDDescription

SAPCC-96

Fixed referencing of web.xml

Version 3.1.5-5

Fixed issues

IDDescription

SAPCC-77

Product report now supports cross origin navigation

Version 3.1.5-2

Fixed issues

IDDescription

SAPCC-57

Enhanced handling of access tokens

SAPCC-52

Fixed initial approval status of newly created CMSContentPages and added inheritance of CMSContentPage data when creating FS Contentpages based on existing CMSContentPages

New features

IDDescription

SAPCC-80

Adapted displayname of module

Version 3.1.5-13

Fixed issues

IDDescription

SAPCC-97

Fixed connection leak within CaaS request tag

SAPCC-94

Improved parameter validation and error handling of FSContentPageCreator executable

SAPCC-70

Fixed invalid configuration property within spring configuration of addon

SAPCC-64

Fixed deprecated reference within documentation

SAPCC-63

Fixed filename reference within documentation

New features

IDDescription

SAPCC-59

Improved usability of OAuth configuration within project component

Version 3.1.5

New features

IDDescription

SAPCC-53

Open product detail pages by clicking an item in the report

Version 3.1.4-1

New features

IDDescription

SAPCC-46

Added bulk update functionality

SAPCC-44

Added support for publishing the navigation structure into the CaaS

Version 3.1.3-4

Fixed issues

IDDescription

SAPCC-49

Fixed automatic refresh of the OAuth-Token

New features

IDDescription

SAPCC-27

Support for FirstSpirit Isolated Server and Java 11

Version 3.1.3-0

New features

IDDescription

SAPCC-35

Added search for content pages

SAPCC-11

Added support for creating new content pages

Version 3.1.2-2

New features

IDDescription

SAPCC-26

Added support for storefront protection via preview sessions

Version 3.1.2

New features

IDDescription

SAPCC-25

Implemented TPP JavaScript reference and added release mechanisms

SAPCC-24

Extended the functionality of our taglib to make custom calls possible

Version 3.1.1-1

Fixed issues

IDDescription

SAPCC-21

Updated fscontentconnect addon

New features

IDDescription

SAPCC-22

Addon clean up

SAPCC-20

Documentation improvements

SAPCC-19

Updated storefront manipulations chapter

Version 3.1.1

New features

IDDescription

SAPCC-18

Initial documentation

SAPCC-9

Project scoped module configuration and bug fixes in the cache mechanisms of the product report

Help

The Technical Support of the e-Spirit AG provides expert technical support to customers and partners covering any topic related to the FirstSpirit™ product. You can get and find more help concerning relevant topics in our community.