epilot Help Center
Meine Tickets

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.

MeldungWas passiertWas zu tun ist
Schlüsselspalte fehltDer Import wird blockiert. Die Meldung nennt die betroffene Spalte.Spalte in der Datei ergänzen oder korrekt benennen, dann erneut hochladen.
Weitere Spalten fehlenEs erscheint eine Warnung; der Import muss ausdrücklich bestätigt werden.Prüfen, ob die fehlenden Felder verzichtbar sind, und bewusst entscheiden.
Datei nicht lesbarDie 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.

AnwendungsfallEine Datei beschreibtDaraus entstehen
PreispflegeProdukte, Preise und Boni, oft über tausende Zeilen und viele PostleitzahlenProdukte, Preise und Coupons, korrekt miteinander verknüpft
Bestellungen aus Vergleichsplatformen importierenBestellungen, die dein ERP nicht direkt entgegennehmen kannAufträge und Kontakte, miteinander verknüpft
AnlagenmanagementAnlagen und z.B. dazugehörige Kontakte und/oder Verträge mit ihren StammdatenAnlagen 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.

Weitere Artikel in diesem Abschnitt