FirstSpirit Connect for SAP Commerce Cloud

Aktualisierungshinweis

Komponenten
Dieses Release enthält die folgenden Komponenten.
Versionen, die mit einem Pfeil (⬆) markiert sind, haben sich seit dem letzten Release geändert.

Allgemeine Informationen
Dieses Release wurde mit folgenden Versionen getestet:

Behobene Fehler

Highlights

SAPCC-385 - Umbenennung der Integration zu FirstSpirit Connect for SAP Commerce Cloud

Im Zuge der Vereinheitlichung von Modulnamen wurde die bisher unter dem Namen ContentConnect for SAP Commerce Cloud veröffentlichte Integration in FirstSpirit Connect for SAP Commerce Cloud umbenannt.

SAPCC-175 - Plugin hinzugefügt, das das Editieren der Seiteneinstellungen im ContentCreator erlaubt

Redakteure haben nun im ContentCreator die Möglichkeit, über den Elementstatus- und Arbeitsablaufsbereich einen Dialog zum Editieren der Seiteneinstellungen zu öffnen.

Aktualisierungshinweis

Komponenten
Dieses Release enthält die folgenden Komponenten.
Versionen, die mit einem Pfeil (⬆) markiert sind, haben sich seit dem letzten Release geändert.

Neue Features

Behobene Fehler

Neue Features

Highlights

SAPCC-300 - Einführung eines neuen Versionsschemas
Mit diesem Release wird ein neues Versionsschema für das Komplettpaket der Integration eingeführt. Das neue Versionsschema setzt sich zusammen aus der zweistelligen Jahreszahl, der Monatszahl und der Nummer des Releases innerhalb eines Monats.

Beispiel für das zweite Release im Oktober 2020: 20.10.1
Beispiel für das erste Release im April 2021: 21.4.0

Das Versionsschema der einzelnen Bestandteile des Gesamtpakets bleibt unverändert. Somit ist leichter ersichtlich, ob es sich bei einer gegebenen Versionsnummer um die Versionsnummer des Gesamtpakets oder eines Bestandteils handelt.

Neue Features

Behobene Fehler

Neue Features

Behobene Fehler

Highlights

SAPCC-354 - Einführung der NPM-Tags cloud-sap-acc und cloud-sap-acc-dev als Version für fs-tpp-api
Bei der Veröffentlichung einer neuen Version der fs-tpp-api Bibliothek, musste diese Version jedes Mal manuell im fscontentconnect Addon angepasst werden. Durch Nutzung der NPM-Tags cloud-sap-acc und cloud-sap-acc-dev braucht die Version der fs-tpp-api Bibliothek nicht mehr manuell angepasst zu werden. Das Tag cloud-sap-acc-dev wird durch e-Spirit an jedem DEV/QA-Patchday auf die aktuellste kompatible Version der fs-tpp-api Bibliothek gehoben. Das Tag cloud-sap-acc respektive an jedem PROD-Patchday. Zur Nutzung des korrekten Tags wurde eine Weiche eingebaut, die je nach Konfiguration des Hybris-Systems eines der beiden Tags verwendet.

SAPCC-350 - Unterstützung von Sonderzeichen und Großbuchstaben in Hybris-Seitenids
Mit diesem Release wird die Inhaltspflege auf allen Seiten unterstützt, auch wenn die Seitenid Sonderzeichen oder Großbuchstaben enthält. Dies betrifft die Pflege auf kataloggetriebenen Seiten (Produkt- und Kategorieseiten) wie auch auf reinen Inhaltsseiten.

SAPCC-324 - Unterstützung von Inhaltspflege auf nicht-standardisierten Inhaltsseiten
Mit diesem Release unterstützt die SAP - Integration auch die Inhaltspflege auf Inhaltsseiten, deren URL von SAP-Standardformaten abweicht.

Zur Verwendung dieser Funktionalität ist es erforderlich, das Mapping der Seitenurl auf das korrespondierende FirstSpirit-Template im Reiter "Inhalte" in der SAP-Modulkonfiguration in den Projekteigenschaften zu hinterlegen wie in Kap. 3.3. der Dokumentation beschrieben.

Aktualisierungshinweis

SAPCC-354 - Einführung der NPM-Tags cloud-sap-acc und cloud-sap-acc-dev als Version für fs-tpp-api
Um die neuen NPM-Tags nutzen zu können, muss das fscontentconnect Addon in der SAP Commerce Cloud aktualisiert werden. Insbesondere müssen folgende Änderungen übernommen werden:

In dieser Datei ist vor dem Aufruf von filterChain.doFilter(request, response); der Aufruf session.setAttribute(FscontentconnectConstants.DEV_ENVIRONMENT, isDevEnvironment()); hinzuzufügen.

Zusätzlich ist die Klasse um die Methode

private boolean isDevEnvironment() {
   final String property = Optional.ofNullable((String) configurationService.getConfiguration()
   .getProperty(FscontentconnectConstants.DEV_ENVIRONMENT)).orElse("");

   return StringUtils.isNotBlank(property) && Boolean.valueOf(property);
}

zu erweitern.

In dieser Klasse ist die neue Konstante public static final String DEV_ENVIRONMENT = "fscontentconnect.dev"; hinzuzufügen.

Die Zeile

<script type="text/javascript" src='https://unpkg.com/fs-tpp-
api@1.2.23/snap${sessionScope["com.espirit.ecom.fscontentconnect.scripts.suffix"]}.js'></script>

ist durch folgende Zeilen zu ersetzen:

<c:set var="com.espirit.ecom.fscontentconnect.scripts.tag" scope="session"
value='${pageContext.session.getAttribute("fscontentconnect.dev") ? "cloud-sap-acc-dev" : "cloud-sap-acc"}'
/>

<script type="text/javascript" src='https://unpkg.com/fs-tpp-
api@${sessionScope["com.espirit.ecom.fscontentconnect.scripts.tag"]}/snap${sessionScope["com.espirit.ecom.fscontentconnect.scripts.suffix"]}.js'></script>

Darüber hinaus ist, wie in Kapitel 2.1.2 der Dokumentation beschrieben, die Konfiguration des Hybris-Systems um die Property fscontentconnect.dev zu erweitern. Erhält diese Property den Wert true, so nutzt die Weiche das Tag cloud-sap-acc-dev. Erhält die Property den Wert false oder wird gar nicht erst angegeben, nutzt die Weiche stattdessen das Tag cloud-sap-acc. Somit sollte diese Property auf DEV- und QA-Systemen auf true gesetzt werden. Auf PROD-Systemen sollte sie nicht verwendet oder auf false gesetzt werden.

SAPCC-350 - Unterstützung von Sonderzeichen und Großbuchstaben in Hybris-Seitenids
Um die Unterstützung von Sonderzeichen und Großbuchstaben in Hybris-Seitenids zu ermöglichen, ist ein Update des Addons notwendig. Betroffen sind die beiden JavaScript-Dateien:

Diese müssen auf dem Hybris-Server aktualisiert werden.

Darüber hinaus ist eine Erweiterung aller Seitenvorlagen des Projekts um folgende versteckte Eingabekomponente notwendig, in der bei der Neuanlage einer FirstSpirit-Seite die originale Hybris-Seitenid bzw. der Hybris-Produkt- oder Kategoriecode persistiert wird:

<CMS_INPUT_TEXT name="pt_cc_identifier" hFill="yes" hidden="yes" useLanguages="no">
   <LANGINFOS>
      <LANGINFO lang="*" label="ContentConnect Identifier"/>
   </LANGINFOS>
</CMS_INPUT_TEXT>

Um die Rückwärtskompatibilität zu gewährleisten, funktioniert die Integration ohne das Hinzufügen dieser Eingabekomponentewie wie bisher weiter, unterstützt dann allerdings nur Seitenids und Produkt- bzw. Kategoriecodes ohne Sonderzeichen und Großbuchstaben.

Behobene Fehler

Neue Features

Highlights

SAPCC-207 - Umgang mit Sonderzeichen in Seiten-, Produkt- und Kategorie-IDs verbessert
Enthalten Seiten-, Produkt- oder Kategorie-IDs Sonderzeichen, wie z.B. Bindestriche, so konnte der im CaaS abgelegte Inhalt für diese Seiten nicht abgerufen werden. Ebenso verlief die Kommunikation mit FirstSpirit in diesen Fällen nicht korrekt, so dass Seiten in FirstSpirit mehrfach angelegt wurden. Dieses Problem wurde mit diesem Release behoben.

Aktualisierungshinweis

SAPCC-342 - Endlosschleife beim Navigieren zu einer Seite im ContentCreator behoben
Um diese Korrektur anzuwenden, muss das fscontentconnect Addon in der SAP Commerce Cloud aktualisiert werden. Speziell müssen die folgenden Dateien aktualisiert werden: * fscontentconnect/acceleratoraddon/web/webroot/WEB-INF/tags/responsive/caas/includeOcmScripts.tag * fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js/fscontentconnect-tpp-impl.js * fscontentconnect/acceleratoraddon/web/webroot/_ui/shared/js/fscontentconnect-tpp-impl.ie11.js

Falls die Änderungen in includeOcmScripts.tag manuell durchgeführt werden müssen, ist die URL der fs-tpp-api Bibliothek von https://unpkg.com/fs-tpp-api@1.2.17/ zu https://unpkg.com/fs-tpp-api@1.2.23/ zu ändern.

SAPCC-207 - Umgang mit Sonderzeichen in Seiten-, Produkt- und Kategorie-IDs verbessert
Zum Einspielen dieser Version ist eine Aktualisierung des Addons in der SAP Commerce Cloud notwendig.

Durch die Aktualisierung wird die Datei RequestTag.java um eine Sonderzeichenersetzung erweitert:

RequestTag.java. 

if (caasService == null) {
    LOGGER.error("The CaaS Service has not been initialized.");
    return;
}

itemId = itemId.replaceAll("[^a-zA-Z0-9_.]", "_"); // Sonderzeichenersetzung

if (session.getAttribute(FIRST_SPIRIT_PREVIEW_PARAM) != null && session.getAttribute(FIRST_SPIRIT_PREVIEW_PARAM) == Boolean.TRUE) {
    pageContext.setAttribute(var, caasService.getStagedCaaSData(collection, itemId));
} else  {
    pageContext.setAttribute(var, caasService.getOnlineCaaSData(collection, itemId));
}

Behobene Fehler

Highlights

SAPCC-149 - Verbesserte Fehlerprotokollierung für API-Aufrufe
Zur besseren und einfacheren Fehleranalyse enthalten Fehlermeldungen, die durch fehlerhafte API-Aufrufe erzeugt wurden, nun den Responsebody des entsprechenden Aufrufs. Dies betrifft alle Aufrufe der cmswebservices, previewwebservices und OAuth-API.

Darüber hinaus wird nun bei API-Aufrufen zur Erzeugung und Aktualisierung von Seiten in SAP Commerce auch der übertragene Requestbody auf Debug-Level protokolliert.

Neue Features

Neue Features

Behobene Fehler

Behobene Fehler

Neue Features

Behobene Fehler

Neue Features

Behobene Fehler

Neue Features

Behobene Fehler

Neue Features

Behobene Fehler

Neue Features

Behobene Fehler

Aktualisierungshinweis

Fall das FirstSpirit Referenzprojekt aus dieser Version verwendet wird, muss zwingend auch das FirstSpirit Modul und das SAP Commerce Addon aus dieser Version verwendet werden.

Behobene Fehler

Neue Features

Aktualisierungshinweis

Ab dieser Version wird der Omnichannel Manager in Version 1.2.15 oder höher benötigt.

Behobene Fehler

Neue Features

Behobene Fehler

Behobene Fehler

Neue Features

Behobene Fehler

Highlights

In dieser Version ist erstmalig ein FirstSpirit Referenzprojekt in der Auslieferung enthalten. Dieses zeigt die Anwendung der Integration in einem Projekt für den B2B Accelerator. Enthaltene Funktionen sind: Inhaltspflege auf vorhandenen Content Seiten, Nutzung dynamischer Produktdaten, Freigabe- und Veröffentlichungsprozesse, Verschiedene Link- und Absatzvorlagen, Standardnutzer- und Gruppen sowie Rechte, Neue UI

Neben dem FirstSpirit Projekt enthält die Auslieferung nun außerdem einen angepassten Storefront, der die notwendigen Änderungen zur Nutzung der Integration enthält.

Aktualisierungshinweis

Diese Version erfordert einige Migrationsschritte, die in einem separaten Dokument beschrieben werden.

Neue Features

Behobene Fehler

Behobene Fehler

Behobene Fehler

Neue Features

Behobene Fehler

Behobene Fehler

Neue Features

Aktualisierungshinweis

Das Update verwendet eine dynamische Auflösung des Storefront-Kontextpfads, die in der TPP-Referenz JavaScript benötigt wird. Die Referenzimplementierung erwartet nun eine storefrontContextRoot-property, die vom PREVIEW_DATA-Objekt bereitgestellt wird. Weitere Informationen zum Definieren der genannten property im Objekt PREVIEW_DATA finden Sie im Kapitel Storefront-Erweiterungen der Dokumentation.

Neue Features

Neue Features

Behobene Fehler

Neue Features

Behobene Fehler

Behobene Fehler

Neue Features

Neue Features

Behobene Fehler

Behobene Fehler

Behobene Fehler

Neue Features

Behobene Fehler

Neue Features

Neue Features

Neue Features

Behobene Fehler

Neue Features

Neue Features

Der Technical Support der e-Spirit AG bietet Kunden und Partnern 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.