Mit der hier beschriebenen Funktion kannst du neue Freifelder, die in einer CSV-Datei vorliegen, in deinen Xentral Systemeinstellungen > Stammdaten > Freifelder anlegen und gleichzeitig den Artikeln zuweisen.
Warnung
Stelle sicher, dass die Artikel, zu denen du Freifelder zuweisen möchtest, bereits in Xentral angelegt sind. Falls du zunächst Artikel importieren möchtest, folge diesem Link, um zur Anleitung zu gelangen.
Warnung
Beachte, dass Freifelder, die über die Importfunktion angelegt werden, stets den Typ "einzeilig" bekommen. Andere Typen können derzeit nicht verwendet werden.
Du findest den CSV-Importer im Menü Einstellungen > Administration > Datenaustausch > CSV-Importer.
Der Import von Freifelder über den CSV-Importer läuft nach folgendem Prozess ab:
Stelle sicher, dass deine CSV-Datei mindestens folgende Pflichtfelder enthält:
Anmerkung
Die Spaltenbenennungen können frei gewählt werden. Sie müssen nicht zwingend den hier aufgeführten Namen entsprechen, da sie im Rahmen das sog. Mappings den entsprechenden Xentral-Datenfeldern zugeordnet werden.
-
Artikelnummer
-
Freifeldname
-
Freifeldwert
Anmerkung
Beachte, dass die hier aufgeführten Felder eine Minimal-Konfiguration darstellen. Es ist möglich, dass zusätzliche Felder erforderlich werden, sobald du weitere Spalten einfügst, die eine Abhängigkeit zur Folge haben.
Beispiel: Wenn du Verkaufsaufträge mit Versandkosten importieren möchtest, benötigst du nicht nur "Versandkosten (netto)", sondern auch das Feld "Versandkosten Artikelnummer".
Halte dich an folgende Formatierungsregeln, um ein reibungsloses Mapping zu gewährleisten:
-
Preise/Kosten: Nutze einen Punkt als Trennzeichen. Beispiel: Der Betrag "Zwei Euro und 59 Cent" wird in der CSV-Datei als "2.59" eingetragen.
-
Datum: Nutze die Struktur JJJJ-MM-TT. Formatiere z. B. das Gültig ab Datum als 2025-05-01, wenn die Gültigkeit ab dem ersten Mai 2025 starten soll.
Anmerkung
Als Trennzeichnen, die du zwischen den einzelnen Datenfeldern in der CSV-Datei nutzt, kannst du z. B. Semikolon oder Komma verwenden. Sie werden beim Hochladen der Importdatei automatisch erkannt.
Die Spaltenbenennungen können frei gewählt werden. Sie müssen nicht zwingend den oben aufgeführten Namen entsprechen, da sie im Rahmen das sog. Mappings den entsprechenden Xentral-Datenfeldern zugeordnet werden.
Manchmal ist es notwendig oder sinnvoll, beim Import eine ID zu nutzen, wobei diese eine echte Referenz zur Datenbank darstellt und keine Nummer oder Bezeichnung ist. In diesem Abschnitt erklären wir dir, wie du eine ID ermitteln und beim Import verwenden kannst.
Anmerkung
Beachte, dass hier eine eindeutige Datenbank-ID gemeint ist, die nicht mit einer Nummer oder Bezeichnung verwechselt werden darf.
Um die ID eines Datensatzes zu ermitteln, benötigst du nur zwei Schritte:
-
Öffne den Datensatz, dessen ID du herausfinden möchtest.
-
Lies die ID in der URL ab.
-
Öffne das Modul Projekte, um die jeweilige Projekt-ID zu ermitteln. Das geht am Schnellsten über die Smart Search:
-
In der Projektübersicht klickst du auf das Projekt, dessen Projekt-ID du herausfinden möchtest, um es zu öffnen. Lies anschließend die Projekt-ID in der URL ab:
-
Öffne das Modul Adressen.
-
Öffne eine Adresse zum Bearbeiten und lies die Kunden- bzw. Lieferanten-ID aus der URL ab:
-
Öffne das Modul Artikel.
-
Öffne einen Artikel zum Bearbeiten und lies die Artikel-ID aus der URL ab:
Klicke auf + CSV-Import erstellen, um einen neuen Import anzulegen:
Tipp
Sobald du Importe angelegt hast, kannst du sie an dieser Stelle wiederfinden, bearbeiten und erneut ausführen.
Lege die allgemeinen Daten deines Imports an, um ihn später wiederfinden zu können und lade die CSV-Datei hoch:
-
Trage einen Namen und
-
eine Beschreibung ein, die dir bei der Identifikation des Imports helfen.
-
Wähle den Datentyp, den du importieren möchtest.
-
Füge deine vorbereitete CSV-Datei ein.
Anmerkung
Per Klick auf Zurücksetzen kannst du eine andere Datei hochladen. Beachte, dass die Inhalte in den vorhergehenden Feldern verloren gehen, bevor du das erste Mal gespeichert hast.
-
Unter den Erweiterten Einstellungen kannst du bei Bedarf Anpassungen an den Trennzeichen und Sonderzeichen vornehmen, falls die Spalten der Importdatei auf der rechten Seite nicht korrekt angezeigt werden.
-
Wähle die Spalten aus, mit denen das System einen Datensatz eindeutig identifizieren kann (Datenbank-ID). :textbaustein-id: csv-import-vorsicht-datenloeschung :locale: de
Warnung
Beachte unbedingt: Leere Zellen in deiner CSV-Datei überschreiben bestehende Daten in Xentral und löschen diese somit im System. Stelle sicher, dass die Importdatei entweder nur die Spalten enthält, die du tatsächlich aktualisieren willst, oder dass alle vorhandenen Zellen mit den korrekten Werten gefüllt sind.
Sobald du auf Mit dem Mapping starten geklickt hast, werden die Daten in eine Vorschau geladen.
In der Vorschauliste stehen dir folgende allgemeine Schaltflächen zur Verfügung:
-
(1) Suchfeld: Ermöglicht die Suche nach einer Artikelnummer
-
(2) Filter: Hier kannst du die Vorschauliste nach einem oder mehreren Filterkriterien einschränken.
Wichtig
Achte bei der Eingabe von Filterwerten auf eine korrekte Schreibweise einschließlich Groß-/Kleinschreibung.
-
(3) Anleitung öffnen: Hier bekommst du einen kurzen Überblick über die Importschritte.
-
(4) Schnellfilter: Filtert die Daten nach Spalten, die nicht zugeordnet sind oder nach Zeilen, die invalide Daten enthalten.
-
(5) Neu laden: Hiermit kannst du die Vorschau neu laden.
-
(6) Abschließen: Führt eine Validierung durch und ermöglicht den anschließenden Datenimport.
In der linken Spalte der Vorschau ist der Eindeutige Bezeichner aufgeführt, in unserem Beispiel . Daneben werden alle Spalten geladen, die im Xentral Datenstamm für den zu importierenden Datentyp zur Verfügung stehen. Rot hinterlegte Felder stellen Pflichtfelder dar und müssen im nächsten Schritt zugeordnet werden. Alle weißen Spalten sind optional. Für diese nimmst du eine Zuordnung vor, nur soweit du es möchtest.
Um eine Spaltenzuordnung zu konfigurieren, klicke auf die Schaltfläche neben dem Spaltentitel:
Im Feld Ursprünglicher Feldname werden dir die Spaltentitel aus der CSV-Datei angezeigt.
Wähle den Feldnamen aus, der der ausgewählten Xentral-Spalte entspricht und klicke auf Anwenden. Die bereits erfolgte Zuordnung wird dir in der Vorschau angezeigt:
Wiederhole das Vorgehen für alle Pflichtspalten und bei Bedarf weitere optionale Spalten.
Anmerkung
Die gelbe Kennzeichnung oben rechts zeigt dir an, dass noch Pflichtfelder zuzuordnen sind. Sobald alle verpflichtenden Spalten zugewiesen sind, verschwindet der Hinweis.
Falls du einer Spalte Daten zuweisen möchtest, für die in der ursprünglichen CSV-Datei keine passende Spalte vorhanden ist, kannst du beim Mapping die Auswahl Benutzerdefinierter Text nutzen.
Klicke auf die Schaltfläche neben dem Spaltentitel, um die Zuordnung zu öffnen. Wähle im Feld Ursprünglicher Feldname die Option Benutzerdefinierter Text aus und trage den zutreffenden Wert in das Feld daneben ein.
Sobald alle Daten in der Vorschau so vorliegen, wie du es benötigst und keine invaliden Daten mehr angezeigt werden, kannst du mit dem Import starten. Klicke dazu zunächst auf Abschließen:
Das System führt eine Datenvalidierung durch. Wenn keine invaliden Daten gefunden wurden, erhältst du eine grüne Erfolgsmeldung und kannst den Import starten:
Wichtig
Sollten einzelne Datenfelder noch nicht ausreichend zugeordnet worden sein, bekommst du eine rote Meldung. Brich in diesem Fall ab und korrigiere die genannten Datensätze.
Nachdem du auf Import starten geklickt hast, startet der Import im Hintergrund und du gelangst automatisch auf die Statusseite. Dort kannst du die Ansicht über die Filter oben einschränken und den Status über die Schaltfläche rechts aktualisieren:
Nach erfolgreichem Abschluss des Imports ist der Status für alle Datensätze grün:
Anmerkung
Nach dem Start des Imports kannst Du diese Seite jederzeit schließen. Der Import läuft im Hintergrund weiter, solange noch Datensätze übrig sind. Du kannst jederzeit über die CSV-Importer Übersicht zum Reporting zurückkehren und den Status verfolgen.