Benutzerdefinierte Import/Export-Delegates für cart und cartItem schreiben
InService bietet über com.ptc.sc.services.plugins.excel.ExcelCartFormatConverterDelegate die Möglichkeit, cart und cartItem in das Microsoft Excel-Format zu exportieren bzw. daraus zu importieren. Wenn Sie jedoch ein anderes Format benötigen (z.B. CSV) können Sie eine benutzerdefinierte Java-Delegate-Klasse erstellen, die die Schnittstelle com.ptc.sc.services.plugins.CartFormatConverterDelegate implementiert.
Diese Schnittstelle enthält die folgenden zu implementierenden Methoden. com.ptc.sc.services.utils.ImportExportUtility wurde für die einfachen Import- und Exportfunktionen erstellt; Kunden sollten nach Möglichkeit dieses Dienstprogramm verwenden, wenn sie benutzerdefinierte Delegates erstellen. Weitere Details hierzu finden Sie in der JavaDoc für die vorstehenden Klassen.
• InputStream convertFromSCItem(SCItem cart)
Implementieren Sie diese Methode, um den Einkaufswagen und seinen Inhalt zu exportieren. Das angegebene SCItem stellt das Einkaufswagen-Objekt dar und enthält die Sammlung "items", die eine Liste von Einkaufswagenartikeln darstellt.
• SCItem convertToSCItem(InputStream inputStream)
Implementieren Sie diese Methode, um den Einkaufswagen und seinen Inhalt zu importieren. Der angegebene InputStream ist die hochgeladene Datei.
• String getExtension()
Diese Methode sollte das Erweiterungssuffix zurückgeben, das dieser Delegate verarbeiten kann. Beim Schreiben eines CSV-Delegate gibt diese Methode beispielsweise ".csv" zurück.
• String getMimeType()
Gibt den MIME-Medientyp zurück, der der von diesem Delegate verarbeiteten Erweiterung entspricht. Für CSV wird beispielsweise "text/csv" zurückgegeben.
• String getLocalizedTitle()
Gibt den lokalisierten Titel der Erweiterung zurück, die dieser Delegate verarbeitet. Dies ist der Titel, der in der Benutzeroberfläche angezeigt wird, wenn ein Benutzer auf der Seite mit Einkaufswagen-Details auf die Aktion zum Herunterladen klickt:
Im Client-Modus ist keine Anpassung erforderlich. Der lokalisierte Titel der Erweiterung, die der benutzerdefinierte Delegate unterstützt, wird nach der Registrierung in der Dropdown-Liste Dateityp angezeigt.
Benutzerdefinierte Delegate-Klassen registrieren
Fügen Sie der Datei <WT_BASISVERZEICHNIS>/site.xconf den folgenden Eintrag hinzu, um den benutzerdefinierten Delegate für den Export anzugeben:
<Service context="default" name="com.ptc.sc.services.plugins.
CartFormatConverterDelegate">
<Option serviceClass="<customExportDelegateClassName>" requestor="null"
selector="<file extension>"/>
</Service>
Der Selektorwert muss die Dateierweiterung sein, die von diesem Delegate unterstützt wird. Wenn er beispielsweise CSV unterstützt, muss der Wert für den Selektor .csv lauten.
