Upload und Mapping von Attributen auf mehrere Entitäten
Mit dem Dateiimport bringst du zusammenhängende Daten aus einer csv-Datei nach epilot, ohne sie einzeln anzulegen. Eine einzige Datei beschreibt dabei mehrere verknüpfte Datensätze gleichzeitig, und ein Mapping verteilt die Spalten auf die richtigen Entitäten. Das funktioniert für ganz unterschiedliche Anwendungsfälle, wie z.B. Preise + Produkte + Coupons, Bestellungen + Kontakte, oder Anlagen + Kontakte.
Das bietet dir der Dateiimport
- Eine Datei, mehrere Entitäten: Zusammengehörende Datensätze, etwa Produkte, Preise und Boni, entstehen gemeinsam und bleiben miteinander verknüpft.
- Prüfung vor dem Speichern: epilot liest die Datei, meldet Probleme und erstellt erst, wenn du bestätigst.
- Wiederverwendbare Zuordnung: Der Use Case beschreibt den Aufbau deiner Datei einmal und lässt sich bei jedem weiteren Import derselben Struktur wiederverwenden.
- Klare Fehlermeldungen: Du erfährst, ob du die Datei korrigieren oder erneut hochladen musst.
Bevor du startest
Prüfe vor dem ersten Import:
- Der Aufbau deiner Datei ist stabil. Der Import gleicht die Spalten deiner Datei gegen die Zuordnung des gewählten Use Cases ab. Wenn dein Quellsystem Spalten umbenennt, passt die Zuordnung nicht mehr.
- Die Schlüsselspalte ist vorhanden. Sie identifiziert den Datensatz und verbindet ihn mit dem richtigen Ziel, bei der Preispflege den Preis mit dem Produkt. Ohne sie kann der Import nicht laufen.
Import starten
Öffne die Liste der relevanten Entität, und klicke oben auf Import. Für die Preispflege ist das die Liste der Preise: Neben dem gewohnten CSV-Import findest du dort die zusätzlichen Option “Mehrere Entitäten importieren”. Der bisherige CSV-Import bleibt unverändert.
Use Case wählen
Im nächsten Schritt wählst du den Use Case, so heißt die gespeicherte Zuordnung in der Oberfläche. Er beschreibt, wie deine Datei aufgebaut ist und welche Spalte auf welches Feld welcher Entität abgebildet wird. Der Use Case ist damit die eigentliche Zuordnung, und er ist der Grund, warum aus einer Datei mehrere verknüpfte Datensätze entstehen können.
Zwei Dinge legt der Use Case fest:
- Die Zuordnung der Spalten zu den Zielfeldern, über mehrere Entitätstypen hinweg.
- Die Schlüssel, über die zusammengehörende Datensätze verbunden werden, etwa ein Preis mit dem passenden Produkt. Als Schlüssel dient in der Regel eine Kennung aus dem Quellsystem.
Weil der Use Case gespeichert ist, wählst du ihn bei wiederkehrenden Importen derselben Dateistruktur einfach erneut aus, statt die Zuordnung jedes Mal neu aufzubauen.
Datei hochladen
Lade anschließend deine Datei hoch. epilot liest sie ein und gleicht zuerst die Spalten gegen die Zuordnung des Use Cases ab, bevor überhaupt eine Zeile verarbeitet wird. Probleme im Aufbau fallen dadurch sofort auf und nicht erst nach tausenden Zeilen.
Prüfen und bestätigen
Nach dem Einlesen zeigt dir epilot eine Vorschau der Dateiinhalte und wie viele Zeilen erkannt wurden. Der Import hält an dieser Stelle an.
Es wird nichts gespeichert, bevor du bestätigst. Prüfe die Vorschau und die Zeilenzahl, und starte den Import erst dann. Stimmt die Zeilenzahl nicht mit deiner Erwartung überein, ist das der beste Zeitpunkt, die Datei noch einmal anzusehen.
Fehler und Warnungen
Der Import unterscheidet zwischen Problemen, die den Vorgang stoppen, und solchen, die du bewusst übergehen kannst.
| Meldung | Was passiert | Was zu tun ist |
|---|---|---|
| Schlüsselspalte fehlt | Der Import wird blockiert. Die Meldung nennt die betroffene Spalte. | Spalte in der Datei ergänzen oder korrekt benennen, dann erneut hochladen. |
| Weitere Spalten fehlen | Es erscheint eine Warnung; der Import muss ausdrücklich bestätigt werden. | Prüfen, ob die fehlenden Felder verzichtbar sind, und bewusst entscheiden. |
| Datei nicht lesbar | Die Meldung nennt die Ursache: falsche Zeichenkodierung, eine defekte Zeile oder eine leere Datei. | Datei im Quellsystem neu exportieren und erneut hochladen. |
Jede Fehlermeldung nennt einen konkreten Grund. Daraus ergibt sich, ob du die Datei korrigierst, sie erneut hochlädst oder deine Admins hinzuziehst.
Anwendungsfälle
Derselbe Mechanismus deckt mehrere Szenarien ab. Der Unterschied liegt allein im Use Case, also in der Zuordnung, die du beim Import auswählst. Die beiden häufigsten stellen wir hier vor, weitere folgen demselben Muster.
| Anwendungsfall | Eine Datei beschreibt | Daraus entstehen |
|---|---|---|
| Preispflege | Produkte, Preise und Boni, oft über tausende Zeilen und viele Postleitzahlen | Produkte, Preise und Coupons, korrekt miteinander verknüpft |
| Bestellungen aus Vergleichsplatformen importieren | Bestellungen, die dein ERP nicht direkt entgegennehmen kann | Aufträge und Kontakte, miteinander verknüpft |
| Anlagenmanagement | Anlagen und z.B. dazugehörige Kontakte und/oder Verträge mit ihren Stammdaten | Anlagen und Kontakte |
Ausblick: Export in dein Wunschformat
Im nächsten Schritt kommt die Gegenrichtung dazu: Du wirst deine Daten aus epilot auch wieder exportieren können, und zwar in dem Format, das das Zielsystem erwartet, und aus mehreren Entitäten in epilot.
Damit lassen sich Preise, die du in epilot pflegst, an andere Systeme weitergeben, etwa an Vergleichsplattformen oder an dein ERP.
🌟 Geschlossene Beta Phase 🌟
Dieses Feature befindet sich derzeit in der geschlossenen Beta-Phase. Um es nutzen und testen zu können, kontaktiere bitte deine epilot AnsprechpartnerIn. Das bedeutet, dass das Feature noch nicht vollumfänglich entwickelt und stabil ist. Diese erste Version des Features kann noch vereinzelte Schwächen aufweisen. Wir arbeiten kontinuierlich daran, das Feature zu optimieren und neue Funktionen hinzuzufügen.
Für eine bessere Lesbarkeit beziehen sich Personenbezeichnungen auf alle Geschlechter.