Smart Import – Hilfe

Stand: 11.08.2026

1. Was macht JTCON Smart Import?

JTCON Smart Import importiert Daten aus CSV, Excel, XML und JSON in Business Central Tabellen. Die Zuordnung erfolgt ueber flexible Mappings mit Validierung, Protokollierung und optionalen KI-Vorschlaegen.

2. Schnellstart in 6 Schritten

1. Importquelle waehlen (CSV, Excel, XML oder JSON).
2. Zieltabelle waehlen.
3. Mapping erstellen oder bestehendes Mapping waehlen.
4. Feldzuordnungen pruefen (inkl. Datentypen und Pflichtfelder).
5. Dry Run ausfuehren, um Ergebnisse ohne Datenaenderung zu pruefen.
6. Import starten und Import Log kontrollieren.

3. Mapping-Konzept

3.1 Feldmapping

Quellspalten werden auf Zielfelder gemappt. Bei Bedarf koennen statische Werte gesetzt oder virtuelle Spalten genutzt werden.

3.2 Datentypen und Validierung

Achte bei Zahlen, Datum und Optionen auf korrekte Formate. Bei aktivierter Feldvalidierung werden BC-Validierungen genutzt.

3.3 Import-Historie und Wiederverwendung

Import-Snapshots koennen als Grundlage fuer neue Mappings wiederverwendet werden. Das reduziert manuellen Aufwand bei wiederkehrenden Datenquellen.

4. Dry Run (empfohlen vor jedem Produktivimport)

Im Dry Run werden keine Daten geschrieben. Du siehst dennoch, welche Datensaetze erfolgreich waeren, welche uebersprungen werden und wo Fehler auftreten.

5. Import Log und Fehleranalyse

Das Import Log zeigt Status, Aktion, Fehlermeldung und ggf. Resolution Hint je Zeile. Nutze die Filterfunktionen und den Excel-Export fuer Nachverfolgung und Abstimmung im Team.

6. KI-Mapping Assistant (optional)

Der Assistant schlaegt Zuordnungen auf Basis von Spaltennamen, Feldmetadaten und Beispielwerten vor.

• Konfiguriere den AI-Endpunkt inkl. API-Key sauber und sicher.
• Pruefe Vorschlaege immer fachlich vor der Uebernahme.
• Nutze Dry Run zur finalen Verifikation.

7. Haeufige Probleme

7.1 Primary key validation failed

Mindestens ein Primaerschluesselfeld ist leer oder falsch gemappt.

7.2 Cannot open target table

Pruefe Tabellen-ID, Berechtigungen und Lizenzumfang.

7.3 Feld kann nicht gesetzt werden

Pruefe Datentyp, Werteformat, Lookup-Abhaengigkeiten und Option-Werte.

8. Best Practices

• Neue Mappings zuerst in Sandbox testen.
• Grossimporte in Batches ausfuehren.
• Import Log regelmaessig bereinigen und archivieren.
• Vor dem Produktivlauf immer Dry Run verwenden.

9. Support

Fuer Supportanfragen bitte bereitstellen:

• BC-Version und App-Version
• Importtyp (CSV, Excel, XML, JSON)
• Fehlermeldung aus dem Import Log
• Beispieldatensatz (anonymisiert)

Kontakt: https://www.jt-con.de/