1. 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.8

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

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

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

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

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

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

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

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

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

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

11. Version 21.4.0

New features

ID Description

SPART-162

Revision of the documentation for the web components

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

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

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

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

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

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

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

19. Version 20.11.0

New features

ID Description

SPART-129

Revision of the documentation after an external review and test

20. Version 20.10.0

Highlights

The documentation is now publicly available.

New features

ID Description

SPART-132

Documentation is made publicly available.

21. Help

The Technical Support of the e-Spirit AG 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.

22. Disclaimer

This document is provided for information purposes only. e-Spirit 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. e-Spirit 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.