| Auszug |
|---|
|
Nuclos ImportProvider: run, ImportResult, structure definition, ISD, CSV, isTransactional, rollback. |
Language: Deutsch · English
ImportProvider
Run CSV imports from rules – run() with structure definition and ImportResult.
| Status |
|---|
| colour | Green |
|---|
| title | Updated: Jul 2026 |
|---|
|
| Status |
|---|
| colour | Grey |
|---|
| title | applies to Nuclos 4.2026.x |
|---|
|
What is the ImportProvider for?
The ImportProvider runs a data import (CSV) from within a rule.
run(importFile, isTransactional, structureDefClasses…)
Imports the data from a NuclosFile (CSV). With isTransactional = true an error causes a full rollback. Structure definitions are generated classes (suffix ISD) from Configuration → Import & Export → Structure definition. Returns an ImportResult with log/text output.
| Codeblock |
|---|
|
public static ImportResult run(NuclosFile importFile, boolean isTransactional,
Class<? extends ImportStructureDefinition>... structureDefClasses) throws BusinessException; |
| Codeblock |
|---|
|
import org.nuclos.api.provider.ImportProvider;
import de.customer.SEPACodeStrukturDefinitionISD;
public void insert(InsertContext context) throws BusinessException {
try {
// Get data from file system
NuclosFile sourceFile = FileProvider.newFile("/home/ftp/documents/SEPA-Code.csv");
// Execute import
ImportResult run = ImportProvider.run(sourceFile, false, SEPACodeStrukturDefinitionISD.class);
if(run.hasErrors()) {
throw new BusinessException(run.getMessages());
}
else {
NuclosMail nuclosMail = new NuclosMail("automaticImport@myCompany.de", "Datenimport fuer " + sourceFile.getName());
nuclosMail.addAttachment(sourceFile);
nuclosMail.addAttachment(run.getLogFile());
nuclosMail.setMessage("Erfolgreicher Datenimport fuer " + sourceFile.getName() + "\n\n" + run.getMessages());
MailProvider.send(nuclosMail);
}
} catch (Exception e) {
throw new BusinessException(e);
}
} |
| Hinweis |
|---|
| title | Finding the structure definition |
|---|
|
The structure definition class name ends in ISD (Import Data Structure). Generated classes are located under data/codegenerator/IDS in the Nuclos base directory. |
Related pages
QueryProvider
Daten laden.
Open →
BusinessObjectProvider
BOs schreiben.
Open →
DatasourceProvider
run data sources.
Open →
