FirstSpirit Connect (Headless) for SAP

FirstSpirit Connect allows to:

The corresponding functions are made available when the module is installed and configured within the WYSIWYG client.

Familiar FirstSpirit tools are used to maintain the content, meaning that editors who are already familiar with FirstSpirit do not require any additional knowledge - especially not about the e-commerce shop system. The content is made available to the Storefront using the CaaS and is delivered by the Storefront in combination with the content from the Commerce Cloud.

This means that within the newly created overall system there is no difference for the delivery of editorial content. It is still carried out by the storefront. Even if the FirstSpirit server is maintained, this affects neither the Storefront nor the Commerce Cloud.

By default, the SAP shop architecture consists of the Commerce Cloud and the Spartacus Storefront. While, in this system, the Commerce Cloud provides all shop functionalities and persists all shop contents, the Spartacus Storefront delivers these contents.

With the FirstSpirit Connect (Headless) for SAP Commerce Cloud solution, FirstSpirit and the CaaS integrate into this architecture and extend the shop functionalities of the Commerce Cloud. The integration thus creates an overall system that combines the functional strengths of the individual systems. Within this overall system FirstSpirit and the Commerce Cloud represent the backend, while the CaaS forms the middleware and the storefront is the front end.

The following graphic shows the high-level architecture of this overall system:

Within the newly created overall system, the Storefront continues to deliver the content, which it by default obtains from the Commerce Cloud. In addition, it queries the contents of the respective CaaS instance and links them with those of the Commerce Cloud. For this purpose it is extended by the fs-spartacus-bridge library.

In contrast to the delivery of the contents, their creation and maintenance shifts from the Commerce Cloud to FirstSpirit. With the ContentCreator, FirstSpirit provides an intuitive WYSIWYG client for this purpose. The so-called Omnichannel Manager (OCM) is integrated into this client, which allows the preview and editing of external content in the ContentCreator (see figure Low-level architecture).

By embedding the Staged Storefront in the Omnichannel Manager, the editors are provided with a combined preview of the contents, which in this case originate from the preview CaaS and the Commerce Cloud. This way, the editors get the possibility to edit already existing shop pages in the ContentCreator. For this purpose, a variety of different components, such as shoppable videos, are available for them.

Product and category information is provided via a report in the ContentCreator. This report accesses the Product Catalog via the Commerce Cloud’s CMS WebServices interface and thus determines the necessary data.

The transfer of the created or modified content to the online CaaS is done with each release. The CaaS persists the content in JSON format in the form of content fragments and makes them available to the Storefront, which integrates them into the shop together with the Commerce Cloud contents. In order to display content originating from the reference project, the Storefront must include the fs-spartacus-view-components library in addition to the bridge.

The overall system of FirstSpirit, Spartacus and the Commerce Cloud thus has an architecture in which the editorial backend of FirstSpirit is clearly separated from the Storefront. A maintenance of FirstSpirit affects neither the Storefront nor the Commerce Cloud.

In order to provide the functions of the FirstSpirit Connect module, the module CaaS Connect is additionally required, which must also be installed on the FirstSpirit server. Furthermore, when using the supplied FirstSpirit Connect Reference Project, the BasicWorkflows and optionally TranslationStudio must also be installed.

To install the modules, open ServerManager and select Server properties  Modules.

The main panel displays a list of all modules installed on the FirstSpirit server. After clicking Install, select the following files one after the other and confirm your selection with Open:

After the successful installation, the folders FirstSpirit Connect for SAP Commerce Cloud, CaaS Connect and optionally the folders BasicWorkflows and FirstSpirit TranslationStudio were added to the list. Each of which must have All rights.

When calling the Commerce Cloud API, an application interface key is required, which depends on the application environment used. This must be specified to the module via the configuration of the AIR Key Configuration Service.