1. Einleitung

Die Erwartungen von Kundinnen und Kunden an moderne E-Commerce-Shop-Systeme werden immer vielfältiger: Neben der reinen Darstellung von Produktkatalogen müssen sie einzigartige und personalisierte Shopping-Erlebnisse vermitteln. Kundinnen und Kunden wollen dabei über alle von ihnen genutzten Kanäle und Endgeräte angesprochen werden. Die Anzahl eingesetzter Touchpoints ist daher beliebig groß.

FirstSpirit Connect for Commerce ermöglicht die Verknüpfung der Digital Experience Platform FirstSpirit mit einem beliebigen E-Commerce-Shop-System. Sie schafft dadurch ein leistungsstarkes Gesamtsystem, das die funktionalen Vorteile dieser Systeme kombiniert und die Bereitstellung moderner und personalisierter Inhalte ermöglicht.

Das vorliegende Dokument richtet sich an Serveradmins und beschreibt daher lediglich die Installation und Konfiguration des Moduls sowie den Import des Referenzprojekts auf dem FirstSpirit-Server. Alle im Projekt durchzuführenden Schritte sowie die mit Connect for Commerce zur Verfügung gestellten Funktionalitäten sind in der FirstSpirit Connect for Commerce Dokumentation beschrieben.

Wird im restlichen Dokument die Formulierung "Connect for Commerce" verwendet, ist damit innerhalb dieser Dokumentation grundsätzlich FirstSpirit Connect for Commerce gemeint.

2. Installation und Konfiguration

Für die Verwendung der Funktionalitäten des FirstSpirit Connect for Commerce-Moduls ist FirstSpirit-seitig die Installation und Konfiguration unterschiedlicher Komponenten erforderlich. Die folgenden Unterkapitel erläutern die dafür notwendigen Schritte.

2.1. Installation der Module

Die Bereitstellung der Funktionen des FirstSpirit Connect for Commerce-Moduls benötigt zusätzlich die Module Caas Connect und Omnichannel Manager, die ebenfalls auf dem FirstSpirit-Server zu installieren sind.

Beim Einsatz des mitgelieferten Referenzprojekts FirstSpirit Connect for Commerce Reference Project ist darüber hinaus die Installation der BasicWorkflows erforderlich. Der Einsatz des Interactive Videos setzt ergänzend die Module YouTube-DAP-Integration und Interactive Video voraus.

Die Auslieferung enthält nur das FirstSpirit Connect for Commerce-Modul. Alle anderen genannten Module sind über den Technical Support zu beziehen.

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

Bildschirmaufnahme, welche den Bereich 'Module' mit der Schaltfläche 'Installieren' im ServerManager zeigt
Abbildung 1. Server-Eigenschaften - Modulinstallation

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:

  • connect-for-commerce-module-<VERSION>.fsm

  • caas-connect-<VERSION>.fsm

  • fs-tpp-api-<VERSION>.fsm

  • basicworkflows-fsm-<VERSION>.fsm (nur bei der Verwendung der BasicWorkflows erforderlich)

  • youtube-dap-integration-<VERSION>.fsm (nur bei der Verwendung des Interactive Videos erforderlich)

  • interactive-video-<VERSION>.fsm (nur bei der Verwendung des Interactive Videos erforderlich)

  • navigation-service-fsm-<VERSION>.fsm (nur erforderlich, wenn dieser verwendet werden soll)

Nach der erfolgreichen Installation wurden der Liste die folgenden Ordner hinzugefügt:

  • FirstSpirit Connect for Commerce

  • Caas Connect

  • FirstSpirit ThirdPartyPreview

  • BasicWorkflows (nur bei der Verwendung der BasicWorkflows)

  • YouTube-DAP-Integration (nur bei der Verwendung des Interactive Videos)

  • Interactive Video (nur bei der Verwendung des Interactive Videos)

  • Navigation Service (nur wenn dieser verwendet werden soll)

Alle diese Ordner müssen jeweils Alle Rechte erhalten.

Die Module FirstSpirit Connect for Commerce, Caas Connect, Navigation Service und YouTube-DAP-Integration erfordern eine Konfiguration. Die dafür notwendigen Schritte sind in der FirstSpirit Connect for Commerce Dokumentation, in der Dokumentation des Navigation Services, in der Caas Connect Dokumentation und in der Readme-Datei der YouTube-DAP-Integration beschrieben.

Nach der Installation aller benötigten Module ist ein einmaliger Neustart des FirstSpirit-Servers erforderlich. Ebenso ist ein Neustart nach jeder Aktualisierung oder einer Installation weiterer Module notwendig.

2.2. Projekt-Import

Ein Bestandteil der Auslieferung ist das Referenzprojekt FirstSpirit Connect for Commerce 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 fs-connect-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.

Bildschirmaufnahme der Projektübersicht des ServerManagers, welche das importierte FirstSpirit Connect for Commerce Reference Project zeigt
Abbildung 2. Importiertes Projekt im ServerManager

Neben den Standardgruppen Everyone und Administrators existieren im Referenzprojekt drei weitere externe Gruppen: Editors, ChiefEditors und ProjectAdmins. Diese Gruppen besitzen verschiedene Rechte, die auf Basis ihrer Aufgaben gewählt und für die verschiedenen Verwaltungen definiert wurden. Personen außerhalb dieser Gruppen sind standardmäßig nicht berechtigt das Referenzprojekt zu verwenden.

Die Verwendung der externen Gruppen setzt eine LDAP-Anbindung voraus. Andernfalls sind sie nicht nutzbar und die für sie gesetzten Rechte greifen nicht.

2.3. Hinzufügen der Web-Komponenten

Connect for Commerce erfordert verschiedene Web-Komponenten, die dem FirstSpirit-Server 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:

  • BasicWorkflows_ContentCreator_Library (nur bei der Verwendung der BasicWorkflows erforderlich)

  • FirstSpirit Connect for Commerce - Web Application Component

  • FirstSpirit ThirdPartyPreview WebApp

  • YouTube-DAP-Integration (nur bei der Verwendung des Interactive Videos)

  • Interactive Video (nur bei der Verwendung des Interactive Videos)

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

Bildschirmaufnahme, welche den Bereich 'Web-Applikationen' im ServerManager zeigt
Abbildung 3. Web-Komponenten in den Server-Eigenschaften

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.

3. Referenzen

Nachfolgend finden Sie eine Übersicht aller Referenzen, die Sie bei der Einrichtung von FirstSpirit Connect for Commerce unterstützen:

Dokumentationen:

Referenzimplementierungen auf GitHub:

Module:

4. Rechtliche Hinweise

FirstSpirit Connect for Commerce ist ein Produkt der Crownpeak Technology GmbH, Dortmund, Germany.
Für die Verwendung des Moduls gilt nur die mit der Crownpeak Technology GmbH vereinbarte Lizenz.

5. Hilfe

Der Technical Support der Crownpeak Technology GmbH bietet qualifizierte technische Unterstützung zu allen Themen, die FirstSpirit™ als Produkt betreffen. Weitere Hilfe zu vielen relevanten Themen erhalten und finden Sie in auch in unserer Community.