FirstSpirit Connect for Commerce

Innerhalb des mit Connect for Commerce geschaffenen Gesamtsystems verlagert sich die Erstellung und Pflege redaktioneller Inhalte nach FirstSpirit. Durch den vollständigen Zugriff auf den Produktkatalog des angebundenen Shops ist dabei auch eine Einbindung der Shopinhalte möglich.

Mit der Freigabe der redaktionellen Inhalte erfolgt eine automatische Übertragung in den CaaS. Dieser stellt sie wiederum der Storefront des angebundenen Shops bereit.

Die Storefront fragt die Informationen ab und verknüpft sie mit denen des Shops, um sie in einer kombinierten Ansicht auszuliefern. Für die Vorschau ermittelt FirstSpirit die dargestellte Seite wiederum aus der Storefront und stellt sie mit den gepflegten Inhalten im ContentCreator dar.

Die Bridge ist ein Microservice, der als Bindeglied zwischen einem beliebigen Shop-Backend und dem FirstSpirit-Server fungiert. Sie dient dazu, die Kommunikation und den Datenaustausch zwischen den beiden Systemen zu erleichtern.

Die Bridge implementiert die REST-Schnittstellen der Bridge API und überträgt die verfügbaren Produkt-, Kategorie- und Inhaltsseiten-Informationen aus dem Shop-Backend an den FirstSpirit-Server. Sie ist ebenfalls für das Mapping zwischen FirstSpirit-Seiten und Shop-Seiten verantwortlich.

Referenzimplementierungen verschiedener Bridges sind auf Github verfügbar.

Der CaaS entspricht einem zentralen Repository. Er persistiert die FirstSpirit-Inhalte in Form von Inhaltsfragmenten und stellt sie in einem einheitlichen JSON-Format beliebigen Endpunkten bereit.
Im Gegensatz zu vorherigen CaaS-Versionen entfällt mit CaaS Connect das Templating in FirstSpirit und verlagert sich in das Frontend. Durch die kontinuierliche Übertragung der Inhalte ist darüber hinaus jederzeit ein aktueller Datenbestand im CaaS sichergestellt.

Weitere Informationen sind in der CaaS Connect-Dokumentation enthalten.

Die Frontend API erweitert FirstSpirit Connect for Commerce, um die Funktionalität, Produkt-, Kategorie-, und Inhaltsseiten als Shop Driven Pages zu erzeugen, Daten aus dem CaaS abzurufen und markierte Slots für die Inhaltsbearbeitung vorzubereiten.

Sie besteht aus zwei npm-Paketen:

Die Referenzimplementierung eines Backend-Service ist auf Github verfügbar.

Weitere Informationen und Beispiele sind in der Frontend API-Dokumentation enthalten.

Ähnlich wie in FirstSpirit basieren Seiten innerhalb eines Shops auf einer Struktur unterschiedlicher Komponenten. Um redaktionelle Inhalte zwischen den beiden Systemen austauschen zu können, müssen diese Komponenten aufeinander abgestimmt sein.

Innerhalb des in der Auslieferung enthaltenen Referenzprojekts FirstSpirit Connect for Commerce Reference Project werden die editierbaren Bereiche einer Shopseite durch die Inhaltsbereiche einer FirstSpirit-Seitenvorlage repräsentiert. Ihnen können Absätze hinzugefügt werden, die jeweils der äquivalenten Komponente einer Shopseite entsprechen (vgl. Abbildung Page Rendering).

Mit FirstSpirit lassen sich somit Komponenten generieren, die innerhalb der editierbaren Bereiche einer Shopseite dargestellt werden.

Wie im vorhergehenden Kapitel beschrieben, erfolgt die Pflege redaktioneller Inhalte sowohl in FirstSpirit als auch im Shopsystem auf Basis einer Seite. Connect for Commerce unterscheidet dabei zwischen Shop Driven Pages und den FirstSpirit Driven Pages.

Die mit dem FirstSpirit Connect for Commerce-Modul realisierte Integration sieht FirstSpirit-seitig lediglich die Erzeugung und Pflege der redaktionellen Inhalte sowie ihre Publizierung in Form von JSON-Dokumenten vor. Die Storefront des angebundenen Shops bestimmt jedoch weiterhin das Rahmenwerk einer Seite, deren editierbare Bereiche die generierten Komponenten einbinden.

Um eine Seite in der Vorschau darzustellen, ermittelt FirstSpirit ihre aktuelle Ansicht in der Storefront. In diesem Fall fragt diese ihrerseits die redaktionellen Inhalte aus dem Preview CaaS ab und ersetzt die entsprechenden Komponenten in der Shopseite. FirstSpirit stellt anschließend das Resultat mithilfe des Omnichannel Managers im ContentCreator dar.

Mit Connect for Commerce erhalten Redakteurinnen und Redakteure vollständigen Zugriff auf den Produktkatalog des angebundenen Shops und können diesen durch redaktionelle Inhalte ergänzen. Die Ermittlung der dafür notwendigen Informationen aus dem Shop-Backend erfolgt mithilfe einer Bridge. Sie übergibt die Daten an den FirstSpirit-Server, der sie über Reports im ContentCreator bereitstellt.

Um stets eine fehlerfreie Zuordnung zwischen den realen Shopdaten und den in FirstSpirit verwendeten Produkt- und Kategorieinformationen zu gewährleisten, ist ein Mapping erforderlich. Dieses muss auf eindeutigen IDs basieren und kann beispielsweise der Abbildung einer SKU auf eine URL entsprechen. Das Mapping ist sowohl für die Bridge als auch für die Datenübertragung im Frontend relevant. Die nachfolgende Grafik stellt das Mapping einer Product ID oder Category ID auf eine Resource ID dar.

Die im Mapping definierten IDs werden ihrerseits in den Formulardaten des jeweiligen FirstSpirit-Elements gespeichert und bei jeder Freigabe per Deployment in den CaaS übertragen. Bei einem solchen FirstSpirit-Element kann es sich sowohl um eine Seite als auch um beispielsweise einen einzelnen Teaser, der ein bestimmtes Produkt referenziert, handeln. Der CaaS persistiert die in FirstSpirit erstellten Inhalte in Form von Inhaltsfragmenten und stellt diese der Storefront des angebundenen Shops bereit.

Die Storefront übernimmt weiterhin die Auslieferung der Inhalte, die sie standardmäßig aus dem Backend des Shops bezieht. Mit Connect for Commerce greift sie zusätzlich auf den CaaS zu und fragt von ihm die redaktionellen Daten ab. Die Abfrage erfolgt auf Basis des von der Bridge vorgegebenen Mappings, das auch im Frontend bekannt sein muss. Auf diesem Weg ist sichergestellt, dass der CaaS die richtigen Daten zurückgibt. Die Storefront verknüpft die Informationen mit denen des Shops und liefert sie in einer kombinierten Ansicht aus.