org.imixs.archive.importer.ftp

Class CSVImportService

java.lang.Object

org.imixs.archive.importer.ftp.CSVImportService

public class CSVImportService
extends Object

The CSVImportService reacts on DocumentImportEvent and importes a CSV file form a FTP data source.

The implementation is based on org.apache.commons.net.ftp

The CSV import can be customized by various options

Author:

rsoika

Field Summary

Fields

Modifier and Type	Field and Description
static String	DATA_ERROR
static String	IMPORT_ERROR

Constructor Summary

Constructors

Constructor and Description
CSVImportService()

Method Summary

Modifier and Type	Method and Description
org.imixs.workflow.ItemCollection	createWorkitem(org.imixs.workflow.ItemCollection source, String fileName, byte[] rawData) Creates and processes a new workitem with a given filedata
org.imixs.workflow.ItemCollection	findEntityByName(String key, String type) This method finds a entity by the attribute 'Name'
String	importData(InputStream imputStream, String encoding, String type, String keyField, DocumentImportEvent event) This method imports all entities from a csv file.
void	onEvent(DocumentImportEvent event) This method reacts on a CDI ImportEvent and imports the data of a CSV file form a ftp server.
void	saveEntry(org.imixs.workflow.ItemCollection aWorkitem, String type) This method process a single workIten in a new transaction.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DATA_ERROR

public static final String DATA_ERROR

See Also:

Constant Field Values

IMPORT_ERROR

public static final String IMPORT_ERROR

See Also:

Constant Field Values

Constructor Detail

CSVImportService

public CSVImportService()

Method Detail

onEvent

public void onEvent(@Observes
                    DocumentImportEvent event)

This method reacts on a CDI ImportEvent and imports the data of a CSV file form a ftp server.

createWorkitem

public org.imixs.workflow.ItemCollection createWorkitem(org.imixs.workflow.ItemCollection source,
                                                        String fileName,
                                                        byte[] rawData)
                                                 throws org.imixs.workflow.exceptions.AccessDeniedException,
                                                        org.imixs.workflow.exceptions.ProcessingErrorException,
                                                        org.imixs.workflow.exceptions.PluginException,
                                                        org.imixs.workflow.exceptions.ModelException

Creates and processes a new workitem with a given filedata

Returns:

Throws:

org.imixs.workflow.exceptions.ModelException

org.imixs.workflow.exceptions.PluginException

org.imixs.workflow.exceptions.ProcessingErrorException

org.imixs.workflow.exceptions.AccessDeniedException

importData

public String importData(InputStream imputStream,
                         String encoding,
                         String type,
                         String keyField,
                         DocumentImportEvent event)
                  throws org.imixs.workflow.exceptions.PluginException

This method imports all entities from a csv file. The file must have one header line.

The method runs in a new transaction so processing exceptions can be caught.

All existing entries not listed in the current file will be removed.

Each imported document will have a unique key in the item 'name' to be used to verify if the entry already exists.

The method returns a log . If an error occurs a plugin exception is thrown

Returns:

ErrorMessage or empty String

Throws:

org.imixs.workflow.exceptions.PluginException

saveEntry

public void saveEntry(org.imixs.workflow.ItemCollection aWorkitem,
                      String type)
               throws org.imixs.workflow.exceptions.AccessDeniedException,
                      org.imixs.workflow.exceptions.ProcessingErrorException,
                      org.imixs.workflow.exceptions.PluginException,
                      org.imixs.workflow.exceptions.ModelException

This method process a single workIten in a new transaction. The method adds the type 'kreditor' to the entity.

Parameters:

aWorkitem -

Throws:

org.imixs.workflow.exceptions.PluginException

org.imixs.workflow.exceptions.ProcessingErrorException

org.imixs.workflow.exceptions.AccessDeniedException

org.imixs.workflow.exceptions.ModelException

findEntityByName

public org.imixs.workflow.ItemCollection findEntityByName(String key,
                                                          String type)

This method finds a entity by the attribute 'Name'

Parameters:

key - - name of the object (name)

type - - type of the object

Returns:

entity or null if no entity with the given name exits