Scrittura di un delegato di esportazione e importazione personalizzato per Cart e CartItem
InService consente di importare ed esportare cart e cartItem in formato Microsoft Excel tramite l'oggetto com.ptc.sc.services.plugins.excel.ExcelCartFormatConverterDelegate. Se occorre invece utilizzare un qualsiasi altro formato (ad esempio, CSV), è possibile creare una classe Java di delegati personalizzati implementando l'interfaccia com.ptc.sc.services.plugins.CartFormatConverterDelegate.
Questa interfaccia ha i seguenti metodi da implementare. com.ptc.sc.services.utils.ImportExportUtility è stato creato per gestire le funzioni di base di importazione ed esportazione. Si consiglia ai clienti di utilizzare questa utilità durante la creazione di delegati personalizzati. Per ulteriori informazioni in merito, vedere JavaDoc per le classi sopra indicate.
• InputStream convertFromSCItem(SCItem cart)
Implementare questo metodo per esportare l'oggetto Cart e il relativo contenuto. L'oggetto SCItem specificato rappresenta l'oggetto Cart e ha una raccolta di "elementi" che rappresenta l'elenco degli elementi del carrello.
• SCItem convertToSCItem(InputStream inputStream)
Implementare questo metodo per importare il carrello e il relativo contenuto. L'oggetto InputStream specificato è il file caricato.
• String getExtension()
Questo metodo deve restituire il suffisso dell'estensione che questo delegato può gestire. Ad esempio, se si scrive un delegato CSV, questo metodo restituisce ".csv".
• String getMimeType()
Restituire il Tipo di supporto MIME corrispondente all'estensione gestita da questo delegato. Ad esempio, per csv è: "text/csv".
• String getLocalizedTitle()
Restituire il titolo localizzato dell'estensione gestita da questo delegato. Questo è il titolo che viene mostrato nell'interfaccia utente quando l'utente fa clic sull'azione di scaricamento dalla pagina dei dettagli del carrello.
Non è richiesta alcuna personalizzazione nel codice client. Il titolo localizzato dell'estensione supportata dal delegato personalizzato viene visualizzato nel menu a discesa Tipo file dopo la registrazione.
Registrazione della classe del delegato personalizzato
Aggiungere la seguente voce nel file <WT_HOME>/site.xconf specificando il delegato di esportazione personalizzato:
<Service context="default" name="com.ptc.sc.services.plugins.
CartFormatConverterDelegate">
<Option serviceClass="<customExportDelegateClassName>" requestor="null"
selector="<file extension>"/>
</Service>
Il valore del selettore deve essere l'estensione file supportata dal delegato. Ad esempio, se supporta il formato CSV, il valore del selettore deve essere ".csv".
