Version 24.9.0

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

7.1.0 ⬆

fs-spartacus-view-components (node module)

7.1.0 ⬆

fs-spartacus-common (node module)

7.1.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-09 (5.2.240907)

Java

17

CaaS Connect (FSM)

3.64.5

Omnichannel Manager

2.4.8

Basic Workflows

1.4.0

New features

ID Description

SPART-389

Updated SAP Composable Storefront to Version 2211.27.0.

Version 24.5.1

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

7.0.1 ⬆

fs-spartacus-view-components (node module)

7.0.1 ⬆

fs-spartacus-common (node module)

7.0.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-05 (5.2.240508)

Java

17

CaaS Connect (FSM)

3.58.0

Omnichannel Manager

2.4.8

Basic Workflows

1.4.0

Fixed issues

ID Description

SPART-395

Fixed peer dependencies of fs-spartacus-bridge and fs-spartacus-view-components.

Version 24.5.0

Update Notice

The FirstSpirit Connect (Headless) 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 ⬆

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

7.0.0 ⬆

fs-spartacus-view-components (node module)

7.0.0 ⬆

fs-spartacus-common (node module)

7.0.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-05 (5.2.240508)

Java

17

CaaS Connect (FSM)

3.58.0

Omnichannel Manager

2.4.8

Basic Workflows

1.4.0

SPART-392 - Upgraded dependencies
All dependencies of the FirstSpirit module 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.

SPART-385 - Update to SAP Composable Storefront 2211.21
Starting with this release, the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration only supports Composable Storefront version 2211.21 and above.

Starting with this release of the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration, support for older SAP Composable Storefront versions is no longer available. After updating the libraries (fs-spartacus-bridge, fs-spartacus-common and fs-spartacus-view-components), manual rework may be required.

For detailed update instructions, please refer to the Composable Storefront documentation.

New features

ID Description

SPART-392

Upgraded dependencies.

SPART-385

Update to SAP Composable Storefront 2211.21.

Version 24.4.0

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

6.1.0 ⬆

fs-spartacus-view-components (node module)

6.1.0 ⬆

fs-spartacus-common (node module)

6.1.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-04 (5.2.240408)

Java

11

CaaS Connect (FSM)

3.55.0

Omnichannel Manager

2.4.8

Basic Workflows

1.3.6

SPART-387 - Fixed security vulnerabilities located in express (CVE-2024-29041) by updating the relevant dependencies

Please update the fs-spartacus-common, fs-spartacus-bridge and fs-spartacus-view-components npm modules in your storefront to the latest version.

Fixed issues

ID Description

SPART-387

Fixed security vulnerabilities located in express (CVE-2024-29041) by updating the relevant dependencies.

Version 24.2.0

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

6.0.4 ⬆

fs-spartacus-view-components (node module)

6.0.3 ⬆

fs-spartacus-common (node module)

6.0.2 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-01 (5.2.240111)

Java

11

CaaS Connect (FSM)

3.44.0

Omnichannel Manager

2.4.7

Basic Workflows

1.3.6

New features

ID Description

SPART-306

Updated company name in documentation, readmes, etc.

Version 23.6.1

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

6.0.3 ⬆

fs-spartacus-view-components (node module)

6.0.2 ⬆

fs-spartacus-common (node module)

6.0.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-06 (5.2.230607)

Java

11

CaaS Connect (FSM)

3.29.3

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-362

The correct version of fs-spartacus-common was set in fs-spartacus-bridge and fs-spartacus-view-components.

Version 23.6.0

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

6.0.2 ⬆

fs-spartacus-view-components (node module)

6.0.1 ⬆

fs-spartacus-common (node module)

6.0.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-06 (5.2.230607)

Java

11

CaaS Connect (FSM)

3.29.3

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

SPART-354 Added possibility to configure separate preview CaaS API key.
If no preview API key is defined, the release API key will be used.

SPART-347 - Support Spartacus Composable Storefront (6.x)
Starting with this release, the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration only supports Composable Storefront version 6.x.

Starting with this release of the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration, support for older Spartacus versions is no longer available. After updating the libraries (fs-spartacus-bridge, fs-spartacus-common and fs-spartacus-view-components), manual rework may be required.

For detailed update instructions on how to update the Spartacus installation used, please refer to the Composable Storefront documentation.

New features

ID Description

SPART-354

Added possibility to configure separate preview CaaS API key.

SPART-347

Update to SAP Composable Storefront 6.

Version 23.3.1

Update Notice

The FirstSpirit Connect (Headless) 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 ⬆

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

4.0.19

fs-spartacus-view-components (node module)

4.0.4

fs-spartacus-common (node module)

4.0.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-04 (5.2.230410)

Java

17

CaaS Connect (FSM)

3.28.6

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

SPART-353 - The Spring Framework version has been updated.
A security vulnerability was discovered in the used Spring Framework (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

SPART-353

The Spring Framework version has been updated.

Version 23.3.0

Update Notice

The FirstSpirit Connect (Headless) 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 ⬆

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

4.0.19 ⬆

fs-spartacus-view-components (node module)

4.0.4

fs-spartacus-common (node module)

4.0.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-03 (5.2.230314)

Java

11

CaaS Connect (FSM)

3.28.6

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

SPART-338 - Conversion of the authorization header for CaaS requests to the standardized Bearer format.
Since the CaaS will stop supporting the old authorization header after 06/2023, the new fs-spartacus-bridge version must be installed until then.

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

Fixed issues

ID Description

SPART-348

The language fallback now uses the page identifier to fetch a page.

New features

ID Description

SPART-338

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

Version 22.11.0

Update Notice

The FirstSpirit Connect (Headless) 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.2

Headless Reference project

1.3.22

fs-spartacus-bridge (node module)

4.0.18 ⬆

fs-spartacus-view-components (node module)

4.0.4

fs-spartacus-common (node module)

4.0.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-12 (5.2.221209)

Java

11

CaaS Connect (FSM)

3.27.0

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-329

Move toLowerCase() function for the uid in page creation calls to the TPP wrapper service.

Version 22.4.1

Update Notice

The FirstSpirit Connect (Headless) 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.2

Headless Reference project

1.3.12

fs-spartacus-bridge (node module)

4.0.16

fs-spartacus-view-components (node module)

4.0.4

fs-spartacus-common (node module)

4.0.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-05 (5.2.220512)

Java

11

CaaS Connect (FSM)

3.20.3

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

New features

ID Description

SPART-183

Added subchapter about editing of page attributes to documentation

Version 22.4.0

Update Notice

The FirstSpirit Connect (Headless) 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.2 ⬆

Headless Reference project

1.3.12

fs-spartacus-bridge (node module)

4.0.16

fs-spartacus-view-components (node module)

4.0.4

fs-spartacus-common (node module)

4.0.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-04 (5.2.220406)

Java

11

CaaS Connect (FSM)

3.20.0

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

SPART-309 - Updated usage of Spring library

The FirstSpirit Connect (Headless) 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.

New features

ID Description

SPART-309

Updated usage of Spring library

Version 22.3.1

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.12

fs-spartacus-bridge (node module)

4.0.16 ⬆

fs-spartacus-view-components (node module)

4.0.4 ⬆

fs-spartacus-common (node module)

4.0.3 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-03 (5.2.220309)

Java

11

CaaS Connect (FSM)

3.19.14

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-303

Fixed an issue with the language change in the ContentCreator

Version 22.3.0

Highlights

SPART-106 - API documentation has been added

This ticket added documentation for each of the following libraries: *fs-spartacus-common *fs-spartacus-bridge *fs-spartacus-view-components

The API documentations are available here: Bridge API, Common API, View Components API

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.12 ⬆

fs-spartacus-bridge (node module)

4.0.14 ⬆

fs-spartacus-view-components (node module)

4.0.2 ⬆

fs-spartacus-common (node module)

4.0.2 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-02 (5.2.220210)

Java

11

CaaS Connect (FSM)

3.19.8

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

New features

ID Description

SPART-106

Added API documentation

Version 22.2.0

Highlights

SPART-227 - Changestream Support has been implemented to remove the need for polling

This ticket implemented Changestream support for the CaaS connection. Where polling was previously required within the bridge to know when newly created content was available in the CaaS, it is now notified by the CaaS when it is. This eliminates repeated requests to the CaaS to check for the presence of content.

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.12 ⬆

fs-spartacus-bridge (node module)

4.0.13 ⬆

fs-spartacus-view-components (node module)

4.0.1

fs-spartacus-common (node module)

4.0.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-02 (5.2.220210)

Java

11

CaaS Connect (FSM)

3.19.12

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

SPART-296 - Fixed an issue when navigating to the homepage in the ContentCreator

Under certain circumstances, incorrect content can be displayed within the ContentCreator when navigating to the homepage. This ticket fixes this error. If the correct content is still not displayed, the loadStrategy must be set to ALWAYS for the Spartacus storefront:

routing: {
    loadStrategy: RouteLoadStrategy.ALWAYS,
}

Fixed issues

ID Description

SPART-296

Fixed an issue when navigating to the homepage in the ContentCreator

SPART-294

Fixed issue with the ContentCreator navigation

New features

ID Description

SPART-288

Extension of the documentation by a chapter about server-side rendering

SPART-227

Changestream support has been implemented to remove the need for polling

Version 22.1.0

Highlights

SPART-240 - Recertification

FirstSpirit Connect (Headless) for SAP Commerce Cloud in version 21.11.0 is recertified by SAP in the SAP Commerce Cloud Store.

The version number 21.11.0 refers to the part of the integration available via the Marketplace. The versioning within the Marketplace differs from the versioning of the releases. In terms of content, the part of the integration available via the Marketplace corresponds to version 22.1.0

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.3.11 ⬆

fs-spartacus-bridge (node module)

4.0.9 ⬆

fs-spartacus-view-components (node module)

4.0.1

fs-spartacus-common (node module)

4.0.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-01 (5.2.220104)

Java

11

CaaS Connect (FSM)

3.19.8

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

New features

ID Description

SPART-269

Added Loading spinner when adjusting content

SPART-253

Added dynamic loading of the fs-tpp-api to remove it from the dependecies

SPART-240

Recertification by SAP in the SAP Commerce Cloud Store

Version 21.12.0

Update Notice

The FirstSpirit Connect (Headless) 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 ⬆

Headless Reference project

1.3.10 ⬆

fs-spartacus-bridge (node module)

4.0.6 ⬆

fs-spartacus-view-components (node module)

4.0.1 ⬆

fs-spartacus-common (node module)

4.0.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-11 (5.2.211108)

Java

11

CaaS Connect (FSM)

3.17.1

Omnichannel Manager

2.4.0

Basic Workflows

1.3.4.972

*SPART-286 - Support Server Side Rendering *
Starting with this release, the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration supports Server Side Rendering .

After updating the libraries (fs-spartacus-bridge and fs-spartacus-view-components), manual rework is required.

Follow the instructions described in the Spartacus documentation.

It is recommended to exclude the preview from SSR since this would cause the entire content to rerender after a pageload.

It is not possible to change the hostname of the production server thus a reverse proxy or similar is required to point to the Angular server on needed URL.

SPART-188 - Restructuring of the configuration for Multi-Site Support
For the implementation of different country or store pages Spartacus offers the so-called Multi-Site Configuration, which is used to connect different BaseSites. Starting with this ticket, the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration also allows the connection of any number of BaseSites.

For this purpose, the previous FsBridgeConfig has been converted into two objects: The first object is a wrapper for the entire configuration and ensures the namespace. The second object corresponds to the name of the BaseSite which should use this configuration.

Therefore, the existing configuration must be modified as follows:

Structure of the new configuration 
abstract class FsSpartacusBridgeConfig{
   bridge: {
      [baseSiteName]: OldFsSpartacusBridgeConfig
   }
}

Fixed issues

ID Description

SPART-282

Enabled deep nesting of components

SPART-233

Moved the Create Component Buttons for nested components, such that it is not hidden by the edit component buttons

New features

ID Description

SPART-286

Support Server Side Rendering

SPART-280

SAP Application Interface Register (AIR) key integrated

SPART-188

Restructuring of the configuration for Multi-Site Support

Version 21.11.0

Update Notice

The FirstSpirit Connect (Headless) 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.82

Headless Reference project

1.3.9 ⬆

fs-spartacus-bridge (node module)

4.0.0 ⬆

fs-spartacus-view-components (node module)

4.0.0 ⬆

fs-spartacus-common (node module)

4.0.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-11 (5.2.211108)

Java

11

CaaS Connect (FSM)

3.17.1

Omnichannel Manager

2.4.0

Basic Workflows

1.3.4.972

SPART-267 - Update to Spartacus 4
Starting with this release, the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration only supports Spartacus version 4.x.

Starting with this release of the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration, support for older Spartacus versions is no longer available. After updating the libraries (fs-spartacus-bridge, fs-spartacus-common and fs-spartacus-view-components), manual rework is required.

Move to the new reference structure described in the Spartacus documentation and replace every instance of b2cLayoutConfig with layoutConfig.

For detailed update instructions on how to update the Spartacus installation used, please refer to the Spartacus documentation.

Fixed issues

ID Description

SPART-268

Fix reload issue for nested angular components

New features

ID Description

SPART-267

Update to Spartacus 4

Version 21.10.0

Highlights

SPART-273 - Provisioning of fs-spartacus-common and fs-spartacus-bridge libraries on GitHub
This ticket is for making the fs-spartacus-common and fs-spartacus-bridge libraries available on GitHub.

They are available via the following links:

Update Notice

The FirstSpirit Connect (Headless) 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.82

Headless Reference project

1.3.4

fs-spartacus-bridge (node module)

2.1.8 ⬆

fs-spartacus-view-components (node module)

2.1.10

fs-spartacus-common (node module)

3.1.3 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-9 (5.2.210908)

Java

11

CaaS Connect (FSM)

3.14.4

Omnichannel Manager

2.4.0

Basic Workflows

1.3.4.972

New features

ID Description

SPART-258

Documentation on language fallbacks

Version 21.9.0

Highlights

The FirstSpirit Connect (Headless) 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.82

Headless Reference project

1.3.4 ⬆

fs-spartacus-bridge (node module)

2.1.5 ⬆

fs-spartacus-view-components (node module)

2.1.10 ⬆

fs-spartacus-common (node module)

3.1.2 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-09 ( 5.2.210908)

Java

11

CaaS Connect (FSM)

3.14.4

Omnichannel Manager

2.4.0

Basic Workflows

1.3.4.972

Update Notice

SPART-255 - Fallback strategy for languages
This release provides the ability to optionally define a fallback language for non-translated content. This allows you to quickly and easily present your content without having to rely on all translations.

To use this feature, the following npm modules must be installed in the specified version:

  • fs-spartacus-bridge 2.1.5

  • fs-spartacus-allgemein 3.1.2

  • fs-spartacus-view-Komponenten 2.1.10

In addition, the fallback language must be configured in the bridge. The fallback language must be specified in the CaaS locale format (e. g. en_GB).

Configuration of the fallback language in app.module.ts 
FsSpartacusBridgeModule.withConfig({
   fallbackLanguage: 'en_GB',
   [...]
})
[...]

Furthermore, add the following input component and the corresponding rule to your section templates. The check box in the form disables/enables the use of the specified fallback language for the section.

Input component 
<CMS_INPUT_TOGGLE name="st_languageFallbackEnabled" hFill="yes" preset="copy" singleLine="no" useLanguages="yes">
  <LANGINFOS>
    <LANGINFO lang="*" label="Enable language fallback" description="If enabled, sections which are not translated will display content from a predefined fallback language."/>
    <LANGINFO lang="DE" label="Ersetzung für nicht gepflegte Sprache einschalten" description="Ist diese Option aktiviert, werden für diesen Absatz Inhalte aus einer vordefinierten Sprache angezeigt."/>
  </LANGINFOS>
</CMS_INPUT_TOGGLE>
Rule 
<RULE>
  <WITH>
    <NOT>
      <EQUAL>
        <PROPERTYname="CONTAINERTYPE"source="#global"/>
        <TEXT>FS_CATALOG</TEXT>
      </EQUAL>
    </NOT>
  </WITH>
  <DO>
    <PROPERTY name="VISIBLE" source="st_languageFallbackEnabled"/>
  </DO>
</RULE>

New features

ID Description

SPART-255

Created a fallback language feature

Version 21.8.2

Update Notice

The FirstSpirit Connect (Headless) 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.82

Headless Reference project

1.3.2

fs-spartacus-bridge (node module)

2.1.3

fs-spartacus-view-components (node module)

2.1.9

fs-spartacus-common (node module)

3.1.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-08 (5.2.210809)

Java

8 and 11

CaaS Connect (FSM)

3.14.1

Omnichannel Manager

2.4.0

Basic Workflows

1.3.4.972

New features

ID Description

SPART-155

Added reference names of sections within the documentation

Version 21.8.1

Update Notice

The FirstSpirit Connect (Headless) 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.82

Headless Reference project

1.3.2 ⬆

fs-spartacus-bridge (node module)

2.1.3

fs-spartacus-view-components (node module)

2.1.9 ⬆

fs-spartacus-common (node module)

3.1.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-07 (5.2.210710)

Java

8 and 11

CaaS Connect (FSM)

3.10.3

Omnichannel Manager

2.3.5

Basic Workflows

1.3.4.972

SPART-236 - Enabled use of databases
With this release, the usage of FirstSpirit datasets in templates is enabled.

The following changes must be made:

  • Update the fs-spartacus-bridge (node module) to the latest version

Instructions to create a section that uses data from a dataset, can be found in the documentation documentation As an example the reference project and the view components contain the templates for location-overview.

Fixed issues

ID Description

SPART-246

Fixed template issues

New features

ID Description

SPART-236

Enabled use of databases

Version 21.8.0

Update Notice

The FirstSpirit Connect (Headless) 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.82

Headless Reference project

1.3.1 ⬆

fs-spartacus-bridge (node module)

2.1.3 ⬆

fs-spartacus-view-components (node module)

2.1.7 ⬆

fs-spartacus-common (node module)

3.1.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-07 (5.2.210710)

Java

8 and 11

CaaS Connect (FSM)

3.10.3

Omnichannel Manager

2.3.5

Basic Workflows

1.3.4.972

SPART-250 - Mixed up name of the Multi Slot Container / N-Up-Teaser
With this release, the name of the n-up teaser was changed tp multi slot container.

The following changes must be made in the section templates of the FirstSpirit project if the reference project is used

  • change the reference name from n_up_teaser to multi_slot_container

  • change the reference name from n_up_teaser_category_item to msc_category_item

  • change the reference name from n_up_teaser_content_item to msc_content_item

  • change the reference name from n_up_teaser_product_item to msc_product_item

  • change the display names to Multi Slot Container , MSC Category Item, MSC Content Item and MSC Product Item

Finally, please approve all changes and update the fs-spartacus-view-components.

SPART-249 - Allow override for text
With this release, it is now possible to override the default product information from the Commerce Cloud and to use inline-editing for the headlines of each multi slot container item.

The following changes must be made to update the FirstSpirit project:

  • Adding the extended paragraph template msc_product_item which now contains additional headline, subline and text form fields.

Finally, please approve all changes.

In order to enable inline-editing for CMS_INPUT_TEXT components a custom data-preview-id needs to be provided as a data attribute on the related DOM node using the syntax #INPUT_COMPONENT_NAME.

Fixed issues

ID Description

SPART-250

Changed naming of "N-Up-Teaser" to "Multi Slot Container" "SPART-244

New features

ID Description

SPART-249

Enable inline-editing for headlines and text override of product information from the Commerce Cloud

SPART-232

Extension of the documentation by an explanation of the tenant ID and project ID

Version 21.7.0

Update Notice

The FirstSpirit Connect (Headless) 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.82

Headless Reference project

1.3.0 ⬆

fs-spartacus-bridge (node module)

2.1.0

fs-spartacus-view-components (node module)

2.1.4 ⬆

fs-spartacus-common (node module)

3.1.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-06 (5.2.210613)

Java

8 and 11

CaaS Connect (FSM)

3.9.2

Omnichannel Manager

2.3.4

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-199

Fixed scrolling of the DataVisualizer Component

SPART-58

Fixed permissions for groups in cloud environment

New features

ID Description

SPART-203

Documentation of the sections provided by the reference project

Version 21.6.0

Update Notice

The FirstSpirit Connect (Headless) 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.82

Headless Reference project

1.2.0 ⬆

fs-spartacus-bridge (node module)

2.1.0 ⬆

fs-spartacus-view-components (node module)

2.1.0 ⬆

fs-spartacus-common (node module)

3.1.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-05 (5.2.210507)

Java

8 and 11

CaaS Connect (FSM)

3.8.4

Omnichannel Manager

2.3.2

Basic Workflows

1.3.4.972

SPART-36 - Multi-Slot-Container
With this release, a new reference component has been added which allows a content, category or product element to be displayed in a multi-slot container.

The following changes must be made to update the FirstSpirit project:

  • Adding the paragraph templates n_up_teaser, n_up_teaser_content_item,n_up_teaser_category_item and n_up_teaser_product_item.

Finally, please approve all changes.

New features

ID Description

SPART-231

Updated dependecies

SPART-36

New reference component n-up teaser with content, category and product item

Version 21.5.0

Update Notice

The FirstSpirit Connect (Headless) 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.82 ⬆

Headless Reference project

1.1.8

fs-spartacus-bridge (node module)

2.0.0 ⬆

fs-spartacus-view-components (node module)

2.0.0 ⬆

fs-spartacus-common (node module)

3.0.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-05 (5.2.210507)

Java

8 and 11

CaaS Connect (FSM)

3.6.4

Omnichannel Manager

2.3.1

Basic Workflows

1.3.4.972

SPART-219 - Update to Spartacus 3
Starting with this release, the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration only supports Spartacus version 3.x. Older versions are no longer supported.

For detailed update instructions on how to update the Spartacus installation used, please refer to the Spartacus documentation.

Starting with this release of the FirstSpirit Connect (Headless) for SAP Commerce Cloud integration, support for older Spartacus versions is no longer available. After updating the libraries (fs-spartacus-bridge, fs-spartacus-common and fs-spartacus-view-components), manual rework is required in the FirstSpirit project.

After updating to version 3, Spartacus treats the Homepage differently: Before version 3, Homepage was used as the ID for this page, with version 3 this ID is now __HOMEPAGE__. Since the integration uses this ID for the mapping of the FirstSpirit page, the ID of the Homepage must be updated in the project. In addition, a hidden input component is maintained in the content pages (pt_cc_identifier), whose value also requires an adjustment.

You need to make the following changes to update the FirstSpirit project:

  • Change the reference name of the content page Homepage from homepage to __homepage__.

  • Additionally, adjust the reference name of the corresponding reference page Homepage from homepage to __homepage__ as well.

  • Set the pt_cc_identifier input component in the LandingPage2Template page template to hidden="no".

  • Subsequently, you need to adjust the Commerce cloud identifier input component that is now visible in the form of the content page Homepage: Update the previous value ContentPage:Homepage to the new value ContentPage:__HOMEPAGE__.

  • After that, set the pt_cc_identifier input component in the LandingPage2Template page template back to hidden="yes".

Finally, please release all changes.

New features

ID Description

SPART-219

Update to Spartacus 3

Version 21.4.1

Update Notice

The FirstSpirit Connect (Headless) 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.80

Headless Reference project

1.1.8

fs-spartacus-bridge (node module)

1.0.46 ⬆

fs-spartacus-view-components (node module)

1.0.23

fs-spartacus-common (node module)

2.0.4

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-04 (5.2.210410)

Java

8 and 11

CaaS Connect (FSM)

3.6.4

Omnichannel Manager

2.3.1

Basic Workflows

1.3.4.972

New features

ID Description

SPART-229

Updated dependecies

Version 21.4.0

New features

ID Description

SPART-162

Revision of the documentation for the web components

Version 21.3.3

Update Notice

The FirstSpirit Connect (Headless) 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.80

Headless Reference project

1.1.8

fs-spartacus-bridge (node module)

1.0.45 ⬆

fs-spartacus-view-components (node module)

1.0.23

fs-spartacus-common (node module)

2.0.4

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-03 (5.2.210309)

Java

8 and 11

CaaS Connect (FSM)

3.5.0

Omnichannel Manager

2.2.2

Basic Workflows

1.3.4.972

New features

ID Description

SPART-222

Upgrade to OCM 2.2.2

Version 21.3.0

Update Notice

The FirstSpirit Connect (Headless) 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.80

Headless Reference project

1.1.8

fs-spartacus-bridge (node module)

1.0.44 ⬆

fs-spartacus-view-components (node module)

1.0.23

fs-spartacus-common (node module)

2.0.4

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-02 (5.2.210210)

Java

8 and 11

CaaS Connect (FSM)

3.1.9

Omnichannel Manager

2.2.1

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-5

Fixed editing error occurring without intial deployment

Version 21.2.2

Update Notice

The FirstSpirit Connect (Headless) 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.80

Headless Reference project

1.1.8 ⬆

fs-spartacus-bridge (node module)

1.0.43 ⬆

fs-spartacus-view-components (node module)

1.0.23

fs-spartacus-common (node module)

2.0.4

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-02 (5.2.210210)

Java

8 and 11

CaaS Connect (FSM)

3.1.9

Omnichannel Manager

2.2.1

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-204

Fixed a bug where sections in the preview could not be moved within a body

Version 21.2.0

Update Notice

The FirstSpirit Connect (Headless) 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.80 ⬆

Headless Reference project

1.1.6 ⬆

fs-spartacus-bridge (node module)

1.0.42 ⬆

fs-spartacus-view-components (node module)

1.0.23 ⬆

fs-spartacus-common (node module)

2.0.4 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2021-01 (5.2.210108)

Java

8 and 11

CaaS Connect (FSM)

3.1.9

Omnichannel Manager

2.1.1

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-154

Removed bug in the DataVisualizer component that prevented it from updating after language change

SPART-148

Support for dashes in SEO Urls

New features

ID Description

SPART-150

Disabled unsupported ContentCreator features

SPART-147

Navigate to product / category detail pages by clicking on the item in the product / category report

Version 21.1.0

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.1.3 ⬆

fs-spartacus-bridge (node module)

1.0.39 ⬆

fs-spartacus-view-components (node module)

1.0.21

fs-spartacus-common (node module)

2.0.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2020-12 (5.2.201109)

Java

8 and 11

CaaS Connect (FSM)

3.1.9

Omnichannel Manager

1.2.29

Basic Workflows

1.3.4.972

New features

ID Description

SPART-180

Activate TranslationStudio if it is configured for the project

Version 20.12.1

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

1.1.0 ⬆

fs-spartacus-bridge (node module)

1.0.36 ⬆

fs-spartacus-view-components (node module)

1.0.21 ⬆

fs-spartacus-common (node module)

2.0.3 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2020-11 (5.2.201107)

Java

8 and 11

CaaS Connect (FSM)

3.1.9

Omnichannel Manager

1.2.29

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-149

Reduced the number of requests to the CaaS on sites without media

SPART-75

Product Link Template: Added product name to the generated url

New features

ID Description

SPART-182

Removed project specific web app

SPART-145

Examples for First Spirit Driven Pages

SPART-143

Snippets for teasers in the carousel catalog

SPART-128

Documentation of the Shop and FirstSpirit Driven Pages

SPART-91

Renamed image file names and removed language abbreviation in the reference project

Version 20.12.0

Update Notice

The FirstSpirit Connect (Headless) 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

Headless Reference project

0.1.44

fs-spartacus-bridge (node module)

1.0.35 ⬆

fs-spartacus-view-components (node module)

1.0.19

fs-spartacus-common (node module)

2.0.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2020-11 (5.2.201107)

Java

8 and 11

CaaS Connect (FSM)

3.1.9

Omnichannel Manager

1.2.29

Basic Workflows

1.3.4.972

Fixed issues

ID Description

SPART-157

Fixed a bug when using the language switch on FirstSpirit Driven Pages

Version 20.11.0

New features

ID Description

SPART-129

Revision of the documentation after an external review and test

Version 20.10.0

Highlights

The documentation is now publicly available.

New features

ID Description

SPART-132

Documentation is made publicly available.

38. 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.

39. 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.