cart および cartItem のカスタムインポート/エクスポート委任の作成
InService では、com.ptc.sc.services.plugins.excel.ExcelCartFormatConverterDelegate を使用して cart と cartItem を Microsoft Excel フォーマットでインポートおよびエクスポートできます。その他のフォーマット (たとえば、csv) が必要な場合は、com.ptc.sc.services.plugins.CartFormatConverterDelegate インタフェースを実装するカスタム委任 Java クラスを作成できます。
このインタフェースでは、次に示すメソッドを実装します。インポートとエクスポートの基本的な機能を処理するために、com.ptc.sc.services.utils.ImportExportUtility が作成されました。カスタム委任を作成する際は、このユーティリティを使用することをお勧めします。これらの詳細については、上記のクラスの Javadoc を参照してください。
• InputStream convertFromSCItem(SCItem cart)
カートとそのコンテンツをエクスポートするには、このメソッドを実装します。引数の SCItem はカートオブジェクトを表し、カートアイテムのリストを表す "アイテム" コレクションを持ちます。
• SCItem convertToSCItem(InputStream inputStream)
カートとそのコンテンツをインポートするには、このメソッドを実装します。引数の InputStream はアップロードされたファイルです。
• String getExtension()
このメソッドは、この委任で処理可能な拡張子のサフィックスを返す必要があります。たとえば、CSV の委任を作成している場合は、このメソッドが ".csv" を返すようにします。
• String getMimeType()
この委任で処理する拡張子に対応する MIME メディアタイプを返します。たとえば、csv の場合は "text/csv" を返します。
• String getLocalizedTitle()
この委任で処理する拡張子のローカライズされたタイトルを返します。これは、ユーザーが「カートの詳細」ページでダウンロード操作をクリックしたときに、UI に表示されるタイトルです。
クライアントのコードにはカスタマイズは必要ありません。カスタム委任がサポートする拡張子のローカライズされたタイトルは、登録後に「ファイルタイプ」ドロップダウンに表示されます。
カスタム委任クラスの登録
<WT_ホーム>/site.xconf ファイルに次のエントリを追加して、カスタムエクスポート委任を指定します。
<Service context="default" name="com.ptc.sc.services.plugins.
CartFormatConverterDelegate">
<Option serviceClass="<customExportDelegateClassName>" requestor="null"
selector="<file extension>"/>
</Service>
selector の値には、この委任でサポートするファイル拡張子を指定します。たとえば、CSV をサポートする場合は selector の値に ".csv" を指定します。
