ContentConnect

Der Report über Kategorien zeigt ab dieser Version auch versteckte Kategorien. Diese Funktion kann über eine neue Filter-Funktion des Reports aktiviert oder deaktiviert werden.

Diese Erweiterung hat zur Folge, dass der Parameter Password in der Konfiguration der Projektkomponente jetzt ein Pflichtfeld ist und nicht leer bleiben darf.

Außerdem muss die verwendete Client-Id berechtigt sein, GET-Anfragen über die DataAPI für folgende Ressourcen durchzuführen:

Weitere Informationen finden sich in den Kapiteln 3.1.4 und 5.3 der Dokumentation.

In der Formatvorlage Preview Generation wurde die folgende Aktualisierung vorgenommen:

Alt. 

$CMS_SET(set_replaceTracker, "(<!-- Demandware Analytics)((.|[\\t\\n\\r])*)(</script>)")$

Neu. 

$CMS_SET(set_replaceTracker, "(<!-- Demandware Analytics)(?s:.)*(</script>)")$

Durch diese Änderung wird einer möglichen Stackoverflow-Exception vorgebeugt. Es wird empfohlen diese Aktualisierung in existierenden Projekten manuell durchzuführen.

Die Cartridge wurde mit dieser Version an einigen stellen angepasst. Eine Aktualisierung der Cartridge oder der Import-Jobs ist in existierenden Projekten nicht zwingend erforderlich.

Folgende Anpassungen wurden vorgenommen:

Weitere Informationen finden sich in den Kapiteln 2.4 und 3.2 der Dokumentation.

Vor Kurzem wurde Demandware zu Salesforce Commerce Cloud umbenannt. Dementsprechend hat auch das Modul DemandwareConnect einen neuen Namen erhalten: ContentConnect for Salesforce Commerce Cloud

Das ContentConnect-Modul untersützt die Nutzung der Content Integration API. Die Integration mit FirstSpirit ist in Kapitel 8 der Dokumentation beschrieben.

In bestehenden Projekten sollte neben den in der Dokumentation beschrieben Schritten außerdem die mitgelieferte Formatvorlage preview_generation angepasst werden. Folgender Code-Schnipsel sollte an den Beginn des umschließenden JSP-Scriptlets verschoben werden, damit die anschließenden Ersetzungen auch auf eingebundene Widgets agieren:

$-- Inject CMS preview content: Replace placeholder with actual CMS content --$
$CMS_FOR(for_item, [0..stringToReplace.size-1])$
    html = html.replaceFirst(
        "$CMS_VALUE(stringToReplace[for_item])$",
        "$CMS_VALUE(stringToInsert[for_item].toString().quoteJS())$");
$CMS_END_FOR$

Des Weiteren wurde zum Einbinden von Widgets ein neues Skript in die Auslieferung aufgenommen. Dieses kann manuell angelegt werden. Als Referenzname ist dabei include_html zu verwenden sowie folgender Inhalt:

//!Beanshell

import java.net.URL;
import java.net.URLConnection;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.MalformedURLException;

String includeURL = gc.getVariableValue("includeURL").toString();
String name = gc.getVariableValue("name").toString();
String password = gc.getVariableValue("password").toString();
String isProtected = gc.getVariableValue("isProtected").toString();
String html = "";

includeURL = includeURL.replaceAll(" ","%20");
URL url = new URL(includeURL);
URLConnection urlConnection = url.openConnection();

if (isProtected.equals("true")){
    import org.apache.commons.codec.binary.Base64;

    String authString = name + ":" + password;
    byte[] authEncBytes = Base64.encodeBase64(authString.getBytes());
    String authStringEnc = new String(authEncBytes);

    urlConnection.setRequestProperty("Authorization", "Basic " + authStringEnc);
}

InputStream is = urlConnection.getInputStream();
InputStreamReader isr = new InputStreamReader(is);

int numCharsRead;
char[] charArray = new char[1024];
StringBuffer sb = new StringBuffer();
while ((numCharsRead = isr.read(charArray)) > 0) {
    sb.append(charArray, 0, numCharsRead);
}
html = sb.toString();
html = html.replaceAll("\\$", "$");

return(html);

Für Detailseiten für Kategorien kann nun mehr als eine Seitenvorlage in FirstSpirit konfiguriert werden. Deshalb muss in bestehenden Projekten die Cartridge aktualisiert werden.

Die Version 1.5.0 des DemandwareConnect-Moduls enthält diverse Überarbeitungen und Neuerungen. Sollte bereits eine frühere Version des Moduls im Einsatz sein, ist aus diesem Grund die Durchführung einiger Migrationsschritte notwendig. Diese sind nachfolgend erläutert und sind in der angegebenen Reihenfolge auszuführen:

Nach der Neuinstallation des Moduls müssen einige Template-Anpassungen vorgenommen werden.

Sollten die Skripte CreateProductManager (Referenzname "createproductmanager") und CreateXmlCollector (Referenzname "createxmlcollector") noch nicht innerhalb des Projekts existieren, müssen sie mit den genannten Referenznamen und den folgenden Inhalten angelegt werden:

CreateProductManager. 

#!executable-class
ManagerFactory

CreateXmlCollector. 

#!executable-class
XmlCollectorFactory

Innerhalb der Vorlage für die Projekteinstellungen müssen die Aufrufe zur Initialisierung der XML-Kollektoren angepasst werden. Des Weiteren wird zur Abfrage von Produktinformationen in Templates jetzt das Interface ProductManager verwendet, weshalb die Instanziierung der Klasse Connector ersetzt werden muss.

Xml-Kollektor für die Content Library:

alt. 

$CMS_SET(ps_xmlCollector,class("com.espirit.moddev.demandware.xml.DemandwareXmlCollector").newInstance())$

neu. 

$CMS_RENDER(script:"createxmlcollector",variableName:"ps_xmlCollector")$

Xml-Kollektor für die Content Slot Konfiguration:

alt. 

$CMS_SET(ps_xmlCollectorContentSlot,class("com.espirit.moddev.demandware.xml.DemandwareXmlCollector").newInstance(false))$

neu. 

$CMS_RENDER(script:"createxmlcollector", variableName:"ps_xmlCollectorContentSlot", createLibraryNode:false)$

Objekt zur Abfrage von Produktinformationen:

alt. 

$CMS_SET(ps_DWRconnector,class("com.espirit.moddev.demandware.products.Connector").create(#global))$

neu. 

$CMS_RENDER(script:"createproductmanager", variableName:"ps_productManager")$

Einige Komponenten des Moduls wurden umbenannt, weshalb in allen Vorlagen jede Nennung des Ausdrucks FSDWC_ durch DemandwareConnect_ zu ersetzen ist. Dies betrifft zum Beispiel den Product-Drop-Handler.

Das Interface ProductManager ist inkompatibel mit der öffentlichen Schnittstelle der zuvor verwendeten Connector-Klasse. Die Abfrage der Produktinformationen muss deshalb angepasst werden:

queryProduct(alt). 

ps_DWRconnector.queryProduct(for_product.id)

loadProduct (neu). 

ps_productManager.loadProduct(for_product.id)

Neben der Ersetzung der Klasse Connector durch das Interface ProductManager, wurden auch die Interfaces Product und Category angepasst. Entsprechende Template-Änderung können deshalb erforderlich sein.