FirstSpirit Connect (Headless) for SAP

FirstSpirit Connect (Headless): For SAP Commerce Cloud stellt die folgenden Möglichkeiten zur Verfügung:

Die dafür notwendigen Funktionalitäten werden mit der Installation und Konfiguration des Moduls innerhalb des WYSIWYG-Clients bereitgestellt.

Die Pflege der Inhalte findet über die gewohnten FirstSpirit-Mittel statt. Mit FirstSpirit vertraute Personen benötigen daher keine darüber hinausgehenden Kenntnisse - insbesondere keine über das E-Commerce-Shopsystem. Die Inhalte werden der Storefront mithilfe des CaaS verfügbar gemacht und in Kombination mit den Inhalten aus der Commerce Cloud von der Storefront ausgeliefert.

Innerhalb des neu geschaffenen Gesamtsystems ergibt sich somit keinerlei Unterschied für die Auslieferung redaktioneller Inhalte. Sie erfolgt weiterhin durch die Storefront. Auch eine Wartung FirstSpirits beeinflusst weder die Storefront noch die Commerce Cloud.

Die SAP-Shop-Architektur setzt sich standardmäßig aus der Commerce Cloud und der Spartacus Storefront zusammen. Während die Commerce Cloud in diesem System sämtliche Shopfunktionalitäten bereitstellt und alle Shopinhalte persistiert, dient die Spartacus Storefront der Auslieferung dieser Inhalte.

Mit der FirstSpirit Connect (Headless): For SAP Commerce Cloud (Headless) for SAP Commerce Cloud-Lösung integrieren sich FirstSpirit und der CaaS in diese Architektur und erweitern die Shopfunktionalitäten der Commerce Cloud. Die Integration schafft dadurch ein Gesamtsystem, das die funktionalen Stärken der einzelnen Systeme kombiniert. Innerhalb dieses Gesamtsystems repräsentieren FirstSpirit und die Commerce Cloud das Backend, während der CaaS die Middleware und die Storefront das Frontend bilden.

Die folgende Grafik zeigt die Highlevel-Architektur dieses Gesamtsystems:

Innerhalb des neu geschaffenen Gesamtsystems übernimmt die Storefront weiterhin die Auslieferung der Inhalte, die sie standardmäßig aus der Commerce Cloud bezieht. Zusätzlich fragt sie jedoch die Inhalte der jeweiligen CaaS-Instanz ab und verknüpft sie mit denen der Commerce Cloud. Zu diesem Zweck wird sie durch die fs-spartacus-bridge-Bibliothek erweitert.

Im Gegensatz zur Auslieferung der Inhalte verlagert sich deren Erstellung und Pflege von der Commerce Cloud nach FirstSpirit. FirstSpirit stellt dafür mit dem ContentCreator einen intuitiv zu bedienenden WYSIWYG-Client zur Verfügung. In diesen ist der sogenannte Omnichannel Manager (OCM) eingebunden, der die Vorschau und Bearbeitung externer Inhalte im ContentCreator erlaubt (vgl. Abbildung Lowlevel-Architektur).

Durch die Einbettung der Staged Storefront in den Omnichannel Manager wird eine kombinierte Vorschau der Inhalte bereitgestellt, die in diesem Fall aus dem Preview CaaS und der Commerce Cloud stammen. Die Redakteurinnen und Redakteure erhalten auf diesem Weg die Möglichkeit, bereits existierende Shopseiten im ContentCreator zu bearbeiten. Dafür stehen ihnen eine Vielzahl unterschiedlicher Komponenten, wie z.B. Shoppable-Videos, zur Verfügung.

Die Bereitstellung der Produkt- und Kategorieinformationen erfolgt über einen Report im ContentCreator. Dieser greift dafür über die CMS WebServices-Schnittstelle der Commerce Cloud auf den Product Catalog zu und ermittelt so die notwendigen Daten.

Die Übertragung der erstellten bzw. veränderten Inhalte in den Online CaaS erfolgt mit jeder Freigabe. Der CaaS persistiert die Inhalte im JSON-Format in Form von Inhaltsfragmenten und macht sie für die Storefront verfügbar, die sie zusammen mit den Commerce Cloud-Inhalten in den Shop integriert. Für die Darstellung der aus dem Referenzprojekt stammenden Inhalte muss die Storefront neben der Bridge die fs-spartacus-view-components-Bibliothek einbinden.

Das Gesamtsystem aus FirstSpirit, Spartacus und der Commerce Cloud besitzt damit eine Architektur, in der das redaktionelle Backend FirstSpirits klar von der Storefront getrennt ist. Eine Wartung FirstSpirits beeinflusst weder die Storefront noch die Commerce Cloud.

Für die Bereitstellung der Funktionen des FirstSpirit Connect (Headless): For SAP Commerce Cloud-Moduls werden zusätzlich die Module CaaS Connect und Omnichannel Manager benötigt, die ebenfalls auf dem FirstSpirit-Server zu installieren sind. Beim Einsatz des mitgelieferten Referenzprojekts FirstSpirit Connect Reference Project ist darüber hinaus die Installation der BasicWorkflows, der CXT ContentCreator Extension und optional TranslationStudios erforderlich.

Öffnen Sie für die Installation der Module den ServerManager und wählen Sie den Bereich Server-Eigenschaften  Module.

Im Hauptpanel ist eine Liste aller auf dem FirstSpirit-Server installierten Module zu sehen. Wählen Sie nach dem Klicken auf Installieren nacheinander die folgenden Dateien aus und bestätigen Sie die Auswahl jeweils mit Öffnen:

Nach der erfolgreichen Installation wurden der Liste die Ordner FirstSpirit Connect (Headless): For SAP Commerce Cloud for SAP Commerce Cloud, CaaS Connect, FirstSpirit ThirdPartyPreview und optional die Ordner BasicWorkflows CXT ContentCreator Extension und FirstSpirit TranslationStudio hinzugefügt. Alle diese Ordner müssen jeweils Alle Rechte erhalten.

Beim Aufruf der Commerce Cloud API wird ein Application Interface Key benötigt, der abhängig von der genutzten Anwendungsumgebung ist. Diese ist dem Modul über die Konfiguration des AIR Key Configuration Services anzugeben.

Zur Auswahl stehen die beiden folgenden Optionen:

Ein Bestandteil der Auslieferung ist das Referenzprojekt FirstSpirit Connect Reference Project, das auf dem FirstSpirit-Server zu installieren ist. Öffnen Sie dafür im ServerManager den Import-Dialog über den Menüpunkt Projekt  Importieren und wählen Sie über den Button Lokal die Datei spartacus-reference-project-<VERSION>.tar.gz aus ihrem lokalen Dateisystem aus. Vergeben Sie anschließend einen Projektnamen sowie eine Beschreibung und bestätigen Sie den Import mit Ja. Nach der erfolgreichen Installation wurde das Projekt der Liste im Hauptpanel hinzugefügt.

Die FirstSpirit Connect (Headless): For SAP Commerce Cloud-Integration erfordert verschiedene Web-Komponenten, die dem verwendeten Projekt hinzuzufügen sind. Öffnen Sie hierfür den Bereich Server-Eigenschaften  Web-Applikationen im ServerManager.

Innerhalb des Hauptpanels sind verschiedene Registerkarten zu sehen, die jeweils eine Liste der bereits vorhandenen Web-Komponenten enthalten. Selektieren Sie die Registerkarte ContentCreator und fügen Sie ihr die folgenden Web-Komponenten hinzu:

Wählen Sie die Web-Komponenten dafür mithilfe des Buttons Hinzufügen nacheinander aus und bestätigen Sie die Auswahl jeweils mit OK.

Selektieren Sie in der Registerkarte abschließend einen aktiven Webserver über die gleichnamige Auswahlbox und starten Sie die Installation über den Button Installieren. Nach der erfolgreichen Installation öffnet sich ein Dialog, in welchem die Aktivierung des Webservers zu bestätigen ist.

Detaillierte Informationen zur Konfiguration von Web-Komponenten finden Sie in der FirstSpirit Dokumentation für Administratoren.

FirstSpirit verfolgt konsequent das Konzept der Mehrsprachigkeit und erlaubt die Ausgabe unterschiedlicher Sprachvarianten. In dem durch die FirstSpirit Connect (Headless): For SAP Commerce Cloud-Integration geschaffenen Gesamtsystem übernimmt die Storefront die Auslieferung der Inhalte und bestimmt somit die Sprache, in der diese dargestellt werden. Aus diesem Grund müssen alle in der Storefront verfügbaren Sprachen im FirstSpirit-Projekt konfiguriert sein.

Damit Sprachen in einem FirstSpirit-Projekt verwendbar sind, müssen auf dem FirstSpirit-Server die entsprechenden Sprach-Vorlagen existieren. Öffnen Sie den Bereich Server-Eigenschaften  Sprach-Vorlagen im ServerManager, um diese hinzuzufügen.

Im Hauptpanel ist eine Liste aller bereits verfügbaren Sprach-Vorlagen zu sehen. Vergeben Sie nach dem Klicken auf Hinzufügen in dem sich öffnenden Bearbeitungsdialog einen Namen, eine Abkürzung und ein Sprachkürzel sowie optional einen Anzeigenamen für die neue Sprach-Vorlage. Bestätigen Sie die Eingabe mit dem Button OK, um die Erzeugung der Sprach-Vorlage abzuschließen. Nach der erfolgreichen Konfiguration ist die neue Sprach-Vorlage ebenfalls in der Liste im Hauptpanel sichtbar.

Detaillierte Informationen zur Erzeugung von Sprach-Vorlagen sind in der Online Dokumentation für FirstSpirit enthalten.