Version 24.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.
| Components | Version |
|---|---|
FirstSpirit Connect for SAP Commerce Cloud (fsm) |
4.0.0 |
fscontentconnect (SAP Commerce Cloud addon) |
3.1.181 |
Reference project |
3.1.97 |
General information
This release was tested with the following versions:
| Product | Version |
|---|---|
FirstSpirit server |
2024-07 (5.2.240712) |
Java |
17 |
Content as a Service (FSM) |
2.24.4 |
Omnichannel Manager |
2.4.8 |
Basic Workflows |
1.4.0 |
New features
| ID | Description |
|---|---|
SAPCC-453 |
Corrected outdated information in the documentation. |
Version 24.5.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.
| Components | Version |
|---|---|
FirstSpirit Connect for SAP Commerce Cloud (fsm) |
4.0.0 ⬆ |
fscontentconnect (SAP Commerce Cloud addon) |
3.1.181 |
Reference project |
3.1.97 |
General information
This release was tested with the following versions:
| Product | Version |
|---|---|
FirstSpirit server |
2024-05 (5.2.240508) |
Java |
17 |
Content as a Service (FSM) |
2.24.0 |
Omnichannel Manager |
2.4.8 |
Basic Workflows |
1.4.0 |
SAPCC-514 - Upgraded dependencies
All dependencies were upgraded to a current version. In addition, a migration from javax to jakarta was carried out. Due to this change, the module now requires at least Java 17 for operation.
New features
| ID | Description |
|---|---|
SAPCC-514 |
Upgraded dependencies |
Version 24.1.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.
| Components | Version |
|---|---|
FirstSpirit Connect for SAP Commerce Cloud (fsm) |
3.2.5 |
fscontentconnect (SAP Commerce Cloud addon) |
3.1.181 |
Reference project |
3.1.97 |
General information
This release was tested with the following versions:
| Product | Version |
|---|---|
FirstSpirit server |
2024-01 (5.2.240111) |
Java |
11 |
Content as a Service (FSM) |
2.23.4 |
Omnichannel Manager |
2.4.7 |
Basic Workflows |
1.3.6 |
New features
| ID | Description |
|---|---|
SAPCC-490 |
The restriction of the search was documented. |
Version 23.3.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.
| Components | Version |
|---|---|
FirstSpirit Connect for SAP Commerce Cloud (fsm) |
3.2.5 ⬆ |
fscontentconnect (SAP Commerce Cloud addon) |
3.1.181 |
Reference project |
3.1.97 |
General information
This release was tested with the following versions:
| Product | Version |
|---|---|
FirstSpirit server |
2023-04 (5.2.230409) |
Java |
17 |
Content as a Service (FSM) |
2.22.4 |
Omnichannel Manager |
2.4.7 |
Basic Workflows |
1.3.4.972 |
SAPCC-493 - The Spring Framework version has been updated.
A security vulnerability was discovered in the Spring Framework used (CVE-2023-20860). Although this vulnerability could not be exploited in the context of use in the module, the Spring Framework version was nevertheless raised to a non-affected version.
Fixed issues
| ID | Description |
|---|---|
SAPCC-493 |
The Spring Framework version has been updated. |
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.
| Components | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Component | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Component | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Component | Version |
|---|---|
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:
| Product | Version |
|---|---|
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.jsandfscontentconnect-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
| ID | Description |
|---|---|
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.
| Components | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Components | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-438 |
Fixed group definition in the reference project |
New features
| ID | Description |
|---|---|
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.
| Component | Version |
|---|---|
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:
| Product | Version |
|---|---|
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.jsandfscontentconnect-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
| ID | Description |
|---|---|
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.
| Components | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-346 |
Fixed permissions for groups in cloud environment |
New features
| ID | Description |
|---|---|
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.
| Components | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Components | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Component | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Component | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Component | Version |
|---|---|
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:
| Product | Version |
|---|---|
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 |
In detail, the following changes have been made to the add-on:
-
Definition of new database fields
in thefscontentconnect-items.xmlfile infscontentconnect/resources -
Adding the caaSConfiguration bean and
injecting the caaSConfiguration bean and the cmsSiteServices bean into the defaultCaaSService bean
in the filefscontentconnect-spring.xmlinfscontentconnect/resources -
Definition of various language-dependent labels for the new input fields
in the directoryfscontentconnect/resources/localization -
Various adjustments for reading the new configuration fields
in the filesDefaultCaaSService.javaandCaaSConfiguration.java
infscontentconnect/src/com/espirit/moddev/contentconnect/sap/service
New features
| ID | Description |
|---|---|
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.
| Components | Version |
|---|---|
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:
| Product | Version |
|---|---|
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 filespring-filter-config.xmlinyb2bacceleratorstorefront/web/webroot/WEB-INF/config
to the filefscontentconnect-spring.xmlinfscontentconnect/resources/fscontentconnect-spring.xml -
Moving the file
FirstSpiritPreviewFilter.javafrom
fscontentconnect/acceleratoraddon/web/testsrc/com/espirit/moddev/contentconnect/sap/filters
tofscontentconnect/src/com/espirit/moddev/contentconnect/sap/filters -
Moving the file
FirstSpiritPreviewFilterTest.javafrom
fscontentconnect/acceleratoraddon/web/testsrc/com/espirit/moddev/contentconnect/sap/filters
tofscontentconnect/testsrc/com/espirit/moddev/contentconnect/sap/filters -
Remove the unused files
FscontentconnectControllerConstants.javaandFscontentconnectWebConstants.javafrom
fscontentconnect/acceleratoraddon/web/src/com/espirit/moddev/contentconnect/sap/controllers
New features
| ID | Description |
|---|---|
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.
| Components | Version |
|---|---|
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:
| Product | Version |
|---|---|
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
| ID | Description |
|---|---|
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.
| Components | Version |
|---|---|
ContentConnect for SAP Commerce Cloud (fsm) |
3.1.73 ⬆ |
fscontentconnect (SAP Commerce Cloud addon) |
3.1.101 |
Reference project |
3.1.71 |
New features
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-387 |
Removed automatic SAP Commmerce availability check |
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-368 |
The workflow status is now correctly updated after releasing a page |
New features
| ID | Description |
|---|---|
SAPCC-364 |
Snippet content of the Product DAP is now configurable |
Version 3.3.1
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-351 |
Improved API-call for requesting a single category |
SAPCC-350 |
Support for special characters and uppercase letters in hybris pageids |
New features
| ID | Description |
|---|---|
SAPCC-354 |
Introducing the NPM tags |
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:
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-149 |
Improved error logging for API calls |
Version 3.2.5
New features
| ID | Description |
|---|---|
SAPCC-289 |
Added support of multiple Commerce Cloud page templates per Commerce Cloud page type |
Version 3.2.3
Fixed issues
| ID | Description |
|---|---|
SAPCC-285 |
Fix empty product report if a product has no thumbnail |
Version 3.2.2
New features
| ID | Description |
|---|---|
SAPCC-60 |
Added thumbnails to product report, replaced report icons |
Version 3.2.1
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-227 |
Added confirmation dialog when a section gets deleted |
Version 3.1.56
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-254 |
Added preview images to page and section templates |
Version 3.1.54
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-253 |
Enabled image upload for every image input component |
Version 3.1.51
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-258 |
Target catalog version for bulk update configurable at task level |
Version 3.1.48
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-230 |
Support Internet Explorer 11 |
Version 3.1.36
Fixed issues
| ID | Description |
|---|---|
SAPCC-224 |
Fixed preview session initialization in Firefox |
Version 3.1.35
Fixed issues
| ID | Description |
|---|---|
SAPCC-217 |
Fixed possible race condition in JavaScript execution |
SAPCC-205 |
Fixed problem handling special characters |
New features
| ID | Description |
|---|---|
SAPCC-213 |
Initial translation of the documentation |
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
| ID | Description |
|---|---|
SAPCC-187 |
Documentation Update |
SAPCC-134 |
Reference Project |
Version 3.1.28
Fixed issues
| ID | Description |
|---|---|
SAPCC-196 |
Fixed bug that prevented language switching on the storefront |
Version 3.1.26
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-111 |
Updated documentation |
Version 3.1.23
Fixed issues
| ID | Description |
|---|---|
SAPCC-181 |
Fixed a bug that caused the CaaS Availability Check to fail in some situations |
Version 3.1.17
Fixed issues
| ID | Description |
|---|---|
SAPCC-129 |
Fixed a bug that caused an incorrect page context after navigating to a different FirstSpirit page |
New features
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-36 |
Added button to test OAuth Settings in project app configuration |
Version 3.1.11
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-65 |
New Category Data Access Plugin |
Version 3.1.5-5
Fixed issues
| ID | Description |
|---|---|
SAPCC-77 |
Product report now supports cross origin navigation |
Version 3.1.5-2
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-80 |
Adapted displayname of module |
Version 3.1.5-13
Fixed issues
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-59 |
Improved usability of OAuth configuration within project component |
Version 3.1.5
New features
| ID | Description |
|---|---|
SAPCC-53 |
Open product detail pages by clicking an item in the report |
Version 3.1.4-1
New features
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-49 |
Fixed automatic refresh of the OAuth-Token |
New features
| ID | Description |
|---|---|
SAPCC-27 |
Support for FirstSpirit Isolated Server and Java 11 |
Version 3.1.3-0
New features
| ID | Description |
|---|---|
SAPCC-35 |
Added search for content pages |
SAPCC-11 |
Added support for creating new content pages |
Version 3.1.2-2
New features
| ID | Description |
|---|---|
SAPCC-26 |
Added support for storefront protection via preview sessions |
Version 3.1.2
New features
| ID | Description |
|---|---|
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
| ID | Description |
|---|---|
SAPCC-21 |
Updated fscontentconnect addon |
New features
| ID | Description |
|---|---|
SAPCC-22 |
Addon clean up |
SAPCC-20 |
Documentation improvements |
SAPCC-19 |
Updated storefront manipulations chapter |
Version 3.1.1
New features
| ID | Description |
|---|---|
SAPCC-18 |
Initial documentation |
SAPCC-9 |
Project scoped module configuration and bug fixes in the cache mechanisms of the product report |
69. Help
The Technical Support of the Crownpeak Technology GmbH provides expert technical support covering any topic related to the FirstSpirit™ product. You can get and find more help concerning relevant topics in our community.
70. Disclaimer
This document is provided for information purposes only. Crownpeak Technology GmbH may change the contents hereof without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. Crownpeak Technology GmbH specifically disclaims any liability with respect to this document and no contractual obligations are formed either directly or indirectly by this document. The technologies, functionality, services, and processes described herein are subject to change without notice.