Datenimport mit FileImporter & BulkImporter

Worum es geht

ESL-Easy liest Daten aus Excel-, CSV- und XML-Quellen ein. Dafür gibt es zwei Module: den FileImporter und den BulkImporter. Der Ablauf ist bei beiden gleich:

Sie legen eine Datei in einen überwachten Ordner. ESL-Easy verarbeitet sie automatisch, erkennt, was sich gegenüber dem letzten Import geändert hat, und aktualisiert alle Labels, die mit diesen Daten verknüpft sind.

---

Schritt 1, FileImporter oder BulkImporter?

Diese Entscheidung fällt vor der Konfiguration, denn sie bestimmt, welche INI-Sektionen Sie brauchen.

Faustregel: Große Stammdatenmengen zyklisch einspielen → BulkImporter. Import plus Steuerbefehle → FileImporter.

---

Schritt 2, Die INI-Datei konfigurieren

Die Betriebsparameter stehen in ESLEasy_FileImporter.ini bzw. ESLEasy_BulkImporter.ini.

Die Basis-Sektionen

[LOOP]
Interval=20                 ; Sekunden zwischen den Prüfläufen

[PATH]
FilePath=C:\ESLEasy\ESLEasy_FileImporter\Files
ProcessedPath=C:\ESLEasy\ESLEasy_FileImporter\Files\Ablage
ErrorPath=C:\ESLEasy\ESLEasy_FileImporter\Files\Fehler

[IDF]
Encoding=UTF8
IdfNeeded=TRUE

[LOG]
LogLevel=1

• [LOOP] Interval=, in welchem Sekunden-Intervall das Programm auf neue Dateien prüft.
• [PATH], die drei Arbeitsordner. FilePath ist der überwachte Import-Ordner, ProcessedPath das Ziel für erfolgreich verarbeitete Dateien, ErrorPath für fehlerhafte. Diese drei Ordner sind das Herz des Ablaufs. Ab Werk heißen die Unterordner Files\Filing und Files\Error; dieser Guide benennt sie in Ablage und Fehler um.
• [IDF] Encoding=, Kodierung der IDF-Datei. IdfNeeded=TRUE erzwingt, dass eine passende IDF oder die Master.idf vorhanden ist (ab Werk steht hier FALSE).
• [LOG] LogLevel=, Umfang der Protokollierung. Der Importverlauf wird in einer Tages-Log-Datei im Ordner .\Log abgelegt.

Der modulabhängige Block

Nur im FileImporter, Verbindung zum Server:

[ESLEASY_SERVER]
IP=127.0.0.1
Port=49190
User=IXOP
Pass=POXI
EncodingRead=UTF8
EncodingWrite=UTF8
Encryption=false

Nur im BulkImporter, Verbindung zur Datenbank:

[SQL]
Type=Firebird
DateTimeFormat=dd.MM.yyyy HH:mm:ss

[FIREBIRD]
ConnectionString=Server=127.0.0.1;Port=49125;Charset=UTF8;User ID=SYSDBA;Password=<PASSWORD>;Database=C:\ERP\ERP.FDB
passencrypted=TRUE

Alternativ steht unter [MSSQL] ein ConnectionString für Microsoft SQL Server zur Verfügung.

---

Schritt 3, Der Ordner-Ablauf

Das ist der Kern des Systems, und er ist bewusst simpel gehalten.

Zeitgesteuerter Import

Endet der Dateiname mit @ plus einem Timestamp im Format yyyyMMddHHmmss, bleibt die Datei im Import-Ordner liegen, bis der Zeitpunkt erreicht ist.

MasterData@20231102170000.xlsx

→ Import erst am 02.11.2023 ab 17:00 Uhr.

Die verwendeten Masken lassen sich in der INI unter [IMPORTTIMESTAMP] anpassen (Defaults: TimestampMask=yyyyMMddHHmmss, TimestampSeparator=@).

---

Schritt 4, Dateiaufbau und Pflichtfelder

Damit ESL-Easy die Daten verwerten kann, braucht es pro Datensatz mindestens ein Schlüsselfeld: die __DATAID. Zusätzlich sollte eine Beschreibung als __DESCRIPTION mitgegeben werden.

Es gibt zwei Wege:

• Direkt in der Datei: Benennen Sie zwei Spalten einfach __DATAID und __DESCRIPTION, sie werden automatisch intern verarbeitet.
• Über die IDF-Datei: Der Regelfall, weil sich der ERP-Export meist nicht ändern lässt. Sie hinterlegen die Zuordnung in der IDF (z. B. „Feld Artikel dient als __DATAID”).

---

Schritt 5, Die IDF-Datei

Die IDF ist der eigentliche Hebel. Sie brauchen sie immer dann, wenn die Datendatei nicht direkt verarbeitbar ist (z. B. die __DATAID-Spalte nicht erkennbar ist) oder wenn Daten beim Import verändert werden müssen.

Das Ausgangsproblem

Unsere Beispieldatei enthält keine sauberen Werte, sondern Text mit eingebetteten Zahlen:

"Art-Nr. 10101","Apfelschorle 24 x 0.33 l MW","Inhalt/Fl.: 0,33","EUR/l     1,89","zzgl. Pfand EUR:     3,42","EUR/Gebinde:     14,99"

Damit kann ESL-Easy nichts anfangen. Es fehlt ein Header, die Textanteile müssen raus, und die Artikelnummer muss als __DATAID erkannt werden. Genau das erledigt die IDF.

Die IDF Sektion für Sektion

[CSV], Trennzeichen, Anführungszeichen, Header vorgeben

[CSV]
Separator=,
QuotationMark=TRUE
Header="ArtNr","Beschreibung","Inhalt","Grundpreis","Pfand","Preis"

Bei QuotationMark=TRUE müssen alle Felder (Header und Daten) mit dem QuotationMarkChar starten und enden. Die Zeichen werden beim Import entfernt.

[DATA], das Import-Verhalten steuern

[DATA]
DeleteBeforeImport=FALSE
TrimAll=TRUE
UpdateLabels=TRUE

[ADDTAG], die Pflichtfelder ergänzen

[ADDTAG]
__PROGRAM=PUTDATA
__DATAID=<ArtNr>
__DESCRIPTION=<Beschreibung>
__STARTTIME=%%TODAY%%

• __PROGRAM=PUTDATA sagt dem Server, dass die Nutzdaten in die Produktdatenbank sollen, das ist der normale Datenimport. Weitere Befehle: PUTDATALOCATION, PUTREFERENCE, UPDATEDATAID, ADDQUEUETASK. Achtung: __PROGRAM gilt nur für den FileImporter.
• __DATAID=<ArtNr>, die spitzen Klammern verweisen auf eine Spalte der Importdaten. Mehrere Spalten und freier Text sind kombinierbar.
• __STARTTIME=%%TODAY%%, Verarbeitungszeitpunkt. Ohne Angabe: sofort.

[REPLACEVALUE], die Textanteile entfernen

[REPLACEVALUE]
ArtNr=Art-Nr.|
__DATAID=Art-Nr.|
Inhalt=Inhalt/Fl.:|
Grundpreis=EUR/l|
Pfand=zzgl. Pfand EUR:|
Preis=EUR/Gebinde:|

Die Syntax lautet Suchtext|Ersatz. Wir lassen den Ersatz leer, damit wird Inhalt/Fl.: durch nichts ersetzt, und übrig bleibt der reine Wert 0,33.

Die Zeile __DATAID=Art-Nr.| ist kein Tippfehler. [ADDTAG] __DATAID=<ArtNr> übernimmt den Rohwert der Spalte, also „Art-Nr. 10101“. Die Zeile ArtNr=Art-Nr.| bereinigt nur das Feld ARTNR. Erst die zweite Zeile macht auch aus der __DATAID die reine 10101. Ohne sie landet der Datensatz unter der DataID „Art-Nr. 10101“ in der Produktdatenbank.

Weitere IDF-Sektionen im Überblick

Diese Sektionen brauchen Sie nicht für den ersten Import, aber früher oder später:

---

Schritt 6, Der erste Import

Beide Dateien, Artikel.csv und Artikel.idf, in den FilePath-Ordner legen. Dann warten.

Der FileImporter läuft nach der Installation als normales Programm, nicht als Windows-Dienst; als Dienst richten Sie ihn mit InstallFileImporterAsService.bat ein. Ein eigenes Log-Fenster gibt es nicht, der Verlauf steht in der Tages-Log-Datei im Ordner LOG.

screenshot009.png

ESL-Easy hat die Änderung erkannt und alle Labels aktualisiert, die mit dieser DataID verknüpft sind.

---

Schritt 7, Import automatisieren

In der Praxis kopiert niemand Dateien von Hand. Beide Module können Importdateien zu definierten Zeitpunkten selbst abholen.

HTTP-Download

[HTTP]
Active=TRUE
StartTimes=01:00,02:00,03:00,16:15
;StartMins=00,30
URL=https://www.domain.com/Data
FileName=Import.csv
DownloadType=DATA
Encoding=UTF8
AutoDetectEncoding=FALSE
Security=TRUE

Weitere Transportwege

• [FTP] / [SFTP], Download vor dem Import. SFTP-Authentifizierung per User/Passwort, per Private-Key-File (.pem) oder per X509Certificate.
• [ZIP], Werden die Importdaten als ZIP geliefert, entpackt ESL-Easy sie automatisch. ProcessFiles=*.csv filtert, welche Dateien bereitgestellt werden; DeleteAfterUnzip=TRUE löscht das Archiv danach.

---

Ist der Datei-Import der richtige Weg?

ESL-Easy bietet mehrere Wege der Datenanbindung. Zur Einordnung:

Die Wege sind kombinierbar: ESL-Easy führt lokale und externe Daten immer zu einem Datensatz zusammen.

---

Häufige Stolpersteine

Die Datei verschwindet nicht aus dem Import-Ordner.

Die Verarbeitung wurde abgebrochen, meist wegen eines Verbindungsproblems (falscher ConnectionString beim BulkImporter, Server nicht erreichbar beim FileImporter). Die Datei wird beim nächsten Durchlauf erneut verarbeitet. Log prüfen.

Der Import läuft, aber die Labels ändern sich nicht.

Prüfen Sie [DATA] UpdateLabels=TRUE in der IDF.

Feldnamen werden nicht erkannt.

Feldnamen dürfen nicht mit zwei Unterstrichen beginnen und keine der Zeichen < > " * \ enthalten.

Excel-Import schlägt fehl.

Programmversion prüfen: Erst ab 1.2.0.0 kommt der Importer ohne lokal installiertes Excel aus.

---

Zum Weiterlesen

• Vollständige IDF-Referenz, alle Sektionen und Parameter: Original-PDF ESLEasy_FileImporter und ESLEasy_BulkImporter 2.3_DE, S. 10–22.
• XML-Import, inklusive CDATA und TEXT: ebenda, S. 22–24.
• Nächster Guide: Ihr erstes Template in 15 Minuten