Allgemein

Der ImportProvider ist eine Hilfsklasse, die alle notwendigen Methoden zur Ausführung eines Datenimports beinhaltet.

Funktionsumfang

 

MethodeBeschreibung
run

Diese Methode ermöglicht die Ausführung eines Datenimports in Nuclos. Im Methodenaufruf muss die Quelle als NuclosFile angegeben werden, welche die Daten im CSV-Format beinhaltet. Als zweiter Parameter wird festgelegt, ob der Import als eine einzige Transaktion ausgeführt werden soll oder nicht. In diesem Fall, es wird 'true' übergeben, findet beim Auftreten eines einzigen Fehlers ein vollständiger Rollback auf den gesamten Importprozess statt. Als dritter Parameter müssen die Strukturdefinitionen angegeben werden, die zum Parsen der Daten verwendet werden sollen. Dabei können mehrere, aber mindestens eine Definition angegeben werden. Die Strukturdefinitionen selbst sind generierte Klassen (analog zu den BusinessObjekten) und entsprechenden den Einträgen aus "Konfiguration -> Import & Export -> Strukturdefinition".

Der Rückgabewert der Methode ist ein ImportResult-Objekt, das alle Informationen zum Ausgang des Import beinhaltet. So können Log-Informationen und Textausgaben während des Imports angefragt werden.

Im Falle eines Fehlers wird eine BusinessException ausgegeben.

public static ImportResult run(NuclosFile importFile, boolean isTransactional, Class<? extends ImportStructureDefinition>... structureDefClasses)
            throws BusinessException

 

Ein Beispiel finden Sie hier.